借助 App 监控的 SDK,您可以获取完备的移动应用性能分析。

前提条件

已将应用接入 App 监控。请参见创建监控任务

背景信息

本文档适用于使用 cocoaPods 管理依赖的 Xcode 项目,以及支持 iOS 8.0 或以上版本的 App。

步骤一:添加依赖

Pod 依赖接入

  1. 指定官方仓库和阿里云仓库。
    source "https://github.com/CocoaPods/Specs.git"
    source "https://github.com/aliyun/aliyun-specs.git"
  2. 添加依赖。
    pod 'AlicloudAPM', '~> 1.0.0'

    ~> 为模糊指定版本号方式,~> 1.0.0 表明版本位于 1.0.0 <= version < 1.1.0 之间的最新版本SDK,。

    SDK 版本可参考Podfile Syntax Reference

  3. 执行 pod update
    说明 如果在 Xcode 9 上出现报错:RuntimeError - [Xcodeproj] Unknown object version.,请将 Project Format 改成 Xcode 8.0-compatible。

步骤二:接入服务

AppDelegate.m 文件的 application:didFinishLaunchingWithOptions: 方法中初始化 SDK。引入头文件

#import <AlicloudAPM/AlicloudAPMProvider.h>
#import <AlicloudHAUtil/AlicloudHAProvider.h>

示例代码:

    NSString *appVersion = @"x.x"; //app 版本,会上报
    NSString *channel = @"xx";     //渠道标记,自定义,会上报
    NSString *nick = @"xx";        //昵称,自定义,会上报

    [[AlicloudAPMProvider alloc] autoInitWithAppVersion:appVersion channel:channel nick:nick];
    [AlicloudHAProvider start];

步骤三:编译

如果编译报错,请在项目的 build setting 里设置 Allow Non-modular Includes In Framework Modules 为 YES。

如果出现包含 duplicate symbol 的错误,请确认其他本地依赖和 CocoaPods 管理的依赖是否有重复。如有重复,请删除本地依赖。强烈建议所有依赖都通过 CocoaPods 管理。

结果验证

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