本文档适用于使用 CocoaPods 管理依赖的 Xcode 项目。iOS APP 监控提供了完备的客户端崩溃分析监控,具体包括 Crash 监控和 ANR 监控。

前提条件

应用的 iOS 版本为 8.0 或以上。

操作步骤

  1. 登录 ARMS 控制台,在左侧导航栏中选择 APP 监控
  2. APP 监控页面,单击右上角的添加 APP 监控
  3. 在弹出的添加 APP 监控对话框的填写应用信息页签输入应用名称和 iOS 应用的 BundleId,并选择 iOS 平台,单击创建应用


  4. 查看配置页签复制 AppKeyAppSecret 的值,单击下一步


  5. 添加 iOS SDK。
    1. 添加依赖。
      1. 指定官方仓库和阿里云仓库。

        source "https://github.com/CocoaPods/Specs.git"
        source "https://github.com/aliyun/aliyun-specs.git"
      2. 添加依赖。

        pod 'AlicloudHA', '~> 1.1.0'
        说明 ~>为模糊指定版本号方式,~> 1.1.0 表明引用位于 1.1.0 版本与 1.2.0 版本之间最新版本的 SDK,用户可根据项目需要指定 SDK 版本,详情请参见 Podfile Syntax Reference
      3. 执行 pod update

        如果在 Xcode 9 上出现以下错误,请将 Project Format 改成 Xcode 8.0-compatible。
        RuntimeError - [Xcodeproj] Unknown object version.
    2. AppDelegate.m 文件的 application:didFinishLaunchingWithOptions: 方法中初始化 SDK。
      引入头文件。
      #import<AliHAAdapter4Cloud/AliHAAdapter.h>
      #import<TBCrashReporter/TBCrashReporter.h>
      示例代码:
      NSString *appKey = @"<yourAppKeyId>"; //appId
      NSString *secret = @"<yourAppKeySecret>"; //appSecret
      NSString *channel = @"<yourChannelId>";     //渠道标记,自定义,比如不同的应用商店等
      NSString *appVersion = @"x.x"; //app版本
      NSString *nick = @"<yourNickId>";        //选填。自定义标记,会上报给崩溃分析服务,可用于搜索崩溃数据
      id<AliHAPluginProtocol> crashPlugin = [TBCrashReporter sharedReporter];
      NSArray<id<AliHAPluginProtocol>> *plugins = @[crashPlugin];
      [AliHAAdapter initWithAppKey:appKey secret:secret appVersion:appVersion channel:channel plugins:plugins nick:nick];    
    3. 进行编译。
      • 如果编译报错,请在项目的 build setting 里设置 Allow Non-modular Includes In Framework Modules 为 YES。
      • 如果出现包含 duplicate symbol 的错误,请确认其他本地依赖和 CocoaPods 管理的依赖是否有重复。如有重复,请删除本地依赖。建议所有依赖都通过CocoaPods管理。

执行结果

在完成上述步骤之后,您可以对您的 APP 进行测试,并登录 ARMS 控制台查看数据报表。