iOS SDK 安装方法

1. 注册 OneAPM

注册 OneAPM,登录账号后点击左侧导航栏的移动应用。然后你可以在右侧页面中看到具体的安装步骤,选择平台类型:iOS。你也可以根据本文的安装步骤进行安装。

2. 下载并解压 OneAPM iOS SDK

下载地址:http://oneapm.udesk.cn/hc/articles/2183

3. 添加 OneAPM Framework 至 Xcode 项目中

解压 SDK,并将「OneAPM.framework」文件夹从 Finder 中拖拽至 Xcode 项目中(悬停至导航窗口的项目中)。出现提示窗口时,选择「Copy items into destination...」和「Create folder references...」。



4. 在 Linker Settings 中添加以下 3 个 Libraries

 

在项目导航窗口内点击你的 Project,并选中你的 App,然后选择「Build Phases」选项卡。打开「Link Binary with Libraries」列表。点击添加:

  • SystemConfiguration.framework
  • CoreTelephony.framework
  • CoreData.framework
  • libz.dylib
  • libstdc++.dylib 

5. Build Settings 设置

选择对应的 TARGET,在「Build Settings」中,为「Other Linker Flags」增加「-all_load」选项,如下图所示:

6. Build Phases 设置

注意:本设置是为自动上传符号表文件 *.app.dSYM 至 Server,设置之后可以实现 Crash Log 的自动化分析。如果您选择不使用此功能,可以跳过此步骤。

    • 添加 OneAPM iOS Agent 文件夹下的 symbolUploading.sh 至工程根目录
    • 在弹出窗口中,勾选「Copy items if needed」
    • 选择对应 Target 的 Build Phases,并新建
      Run Script
      注意:点击左上角的加号按钮,并选择「New Run Script Phases」来新建 Run Script。
    •  粘贴以下内容至文本框「Type a script or drag a script file from your workspace to insert its path」中
      SCRIPT=`/usr/bin/find "${SRCROOT}" -name symbolUploading.sh | head -n 1`/bin/sh "${SCRIPT}" "APPLICATION TOKEN"
      注意:替换 'APPLICATION TOKEN' 为您的 Token

7. 启动 Agent

  • 在项目文件 [app_name]-Prefix.pch(通常在文件夹「Support Files」中)中,引入 OneAPM 头文件:
    #import <OneAPM/OneAPM.h>
  • 在文件 AppDelegate.m 中添加如下代码,并确保它在
    application:didFinishLaunchingWithOptions
    的第一行中。
    [OneAPM startWithApplicationToken:@"<generate app token by creating a name above>"];

8. 运行应用程序

Clean Project,并重新在模拟器或设备中启动应用程序,开始应用性能管理。

注意:OneAPM iOS SDK 目前支持 iOS 6.0 之后的版本;在 iOS 6.0 之前的版本中安装 OneAPM Agent 不会导致报错,但无法获取性能数据。

9. 重启

请静候 5 分钟,等待应用程序向 OneAPM 发送应用程序性能数据,即可开始使用 OneAPM 应用性能管理

还有其他问题? 提交请求

您还可以采取以下方式解决问题: