PreDemCocoa 2.1.1

PreDemCocoa 2.1.1

×

测试已测试✓
Lang语言 Obj-CObjective C
许可证 MIT
发布最后发布2018年9月

由Qiniu维护。

PreDemCocoa 2.1.1

  • 由
  • qiniu

pre-dem-cocoa

Build Status codecov Latest Stable Version Platform

简介

pre-dem-cocoa 是由七牛云发起和维护的针对 iOS (Mac OS, Tv OS, Watch OS WIP) 等平台的集用户体验监控及报障为一体的开源 SDK，用户可以将自定义数据上传到 APM 上进行分析。

安装

使用 CocoaPods 进行安装

pod "PreDemCocoa"

快速开始

  • 创建 APP：首先到 apm.qiniu.com 登录并创建自己的 APP，在配置信息中找到对应的 APP KEY，以及消息上报的域名，填入到 SDK 中，

  • 初始化

    NSError *error;
    [PREDManager startWithAppKey:@"YOUR_APP_KEY" 
      serviceDomain:@"YOUR_REPORT_DOMAIN"];

初始化之后，SDK 便会自动定期从服务器更新配置信息，终端可根据配置来调整队列发送间隔时间

  • 自定义事件
    NSDictionary *dict = @{
                           @"PARAMETER_KEY1": @"PARAMETER_VALUE1",
                           @"PARAMETER_KEY2": @"PARAMETER_VALUE2"
                           };
    PREDEvent *event = [PREDEvent eventWithName:@"YOUR_EVENT_NAME" contentDic:dict];
    [PREDManager trackEvent:event];

自定义事件上报功能可以将您自定义的事件直接上报至服务器。

  • 事务上报

开始一个事务

PREDTransaction *transaction = [PREDManager transactionStart:@"test"];

将一个事务标识为完成并上传数据到服务器（注意：一个事务只能标识一次完成，之后应该释放该对象，多次标识完成会造成统计出现偏差）

[transaction complete];

将一个事务标识为被取消并上传数据到服务器（注意：一个事务只能标识一次被取消，之后应该释放该对象，多次标识完成会造成统计出现偏差）

[transaction cancelWithReason:@"test reason for cancelled transaction"];

将一个事务标识为失败并上传数据到服务器（注意：一个事务只能标识一次被取消，之后应该释放该对象，多次标识完成会造成统计出现偏差）

[transaction failWithReason:@"test reason for failed transaction"];
  • 调整发送间隔：默认 30s 的发送间隔，如果想调整，可以通过如下方式调整 PREDManager.updateInterval = 时间;

示例代码

  • 具体细节的一些配置可参考 PreDemCocoaDemo/PreDemCocoaTests 下面的一些单元测试，以及源代码

常见问题

  • iOS 9+ 强制使用https，需要在project build info 添加NSAppTransportSecurity类型Dictionary。在NSAppTransportSecurity下添加NSAllowsArbitraryLoads类型Boolean,值设为YES。 具体操作可参见 http://blog.csdn.net/guoer9973/article/details/48622823
  • 如果遇到其他编译错误，请参阅 CocoaPods 的 故障排除

代码贡献

详细参考 代码提交指南.

贡献记录

联系我们

  • 需要帮助，请提交工单（在门户右侧点击“咨询和建议”提交工单，或直接发送邮件至 [email protected]）
  • 如有任何问题，可在问答社区提问，问答社区
  • 如发现 bug，欢迎提交 issue
  • 如有功能需求，欢迎提交 issue
  • 如要提交代码，欢迎提交 pull request
  • 欢迎关注我们的 微信和微博，及时获取动态信息

代码许可

MIT 许可证（MIT）。详细内容见 许可文件。