接入iOS应用_应用实时监控服务(ARMS)-阿里云帮助中心

ARMS用户体验监控的App监控提供了非常全面的移动端应用监控能力，主要包括iOS应用监控和Android应用监控。本文介绍如何将iOS应用接入ARMS用户体验监控。

步骤一：创建应用

登录ARMS控制台。
在左侧导航栏选择用户体验监控 > 应用列表，并在顶部菜单栏选择目标地域。
在应用列表页面单击添加应用。
在创建应用面板单击iOS。
在iOS面板输入应用名称，并根据需求配置其他参数，然后单击创建。
说明
应用名称唯一，不能与已创建的应用名称重复。
创建成功后，当前应用将会自动生成对应的ConfigAddress（上报地址）和AppID。

步骤二：集成SDK

Cocoapods自动集成（推荐）

在Xcode工程的Podfile文件中添加最新版本SDK。

source 'https://github.com/CocoaPods/Specs.git'

target 'iOSDemo' do
  # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
  use_frameworks!

  # 导入阿里云 ARMS RUM SDK
  pod 'AlibabaCloudRUM', '1.0.5'
end

在项目根目录下（或Podfile文件所在目录）执行以下命令更新Pod环境。
```
pod install --repo-update
```

手动集成

下载SDK并解压。
解压.zip文件后得到如下内容：
- AlibabaCloudRUM.xcframework
- AlibabaCloudRUMSDK.xcframework
配置工程。
1. 通过Xcode打开File > Add Files to "Your Project Name"...，在弹出的面板中选择上一步下载的2个组件包，然后单击Add。
  说明
  不同版本的XCode会略有差异。
  建议选中"Copy files to destination"。
2. 在项目设置target > Build Phases > Link Binary With Libraries中添加如下依赖库。
  - libc++.tbd（必须引入）
  - libresolv.tbd（必须引入）
3. 在target > Build Settings中搜索Other Linker Flags，添加编译标志-ObjC。
  重要
  请注意检查-ObjC的拼写。

步骤三：导入头文件

在main.m或AppDelegate.m中导入头文件。

Objective-C

@import AlibabaCloudRUM;

Swift

import AlibabaCloudRUM

步骤四：初始化

在main函数或- application:didFinishLaunchingWithOptions:方法中完成SDK的初始化。

Objective-C

[AlibabaCloudRUM setConfigAddress:@"<your config address>"]; // ConfigAddress，步骤一创建RUM应用时获取。
[AlibabaCloudRUM startWithAppID:@"<your appId>"]; // AppID，步骤一创建RUM应用时获取。

Swift

AlibabaCloudRUM.setConfigAddress("<your config address>")// ConfigAddress，步骤一创建RUM应用时获取。
AlibabaCloudRUM.start("<your appId>")// AppID，步骤一创建RUM应用时获取。

接入验证

应用运行后，返回AlibabaCloudRUMSDK init success即表示SDK初始化成功。

返回示例：

[AlibabaCloudRUM] [INFO   ] [init] AlibabaCloudRUMSDK init success

合规说明

应用的数据合规非常重要，您须确保按照当前法律法规或监管要求使用用户体验监控SDK服务，为避免因数据合规问题导致的应用下架，请您务必做好以下三步：

请务必确保您已经将用户体验监控SDK升级到满足监管新规的最新版本。
请务必在《隐私权政策》中向用户告知使用了用户体验监控SDK，参考条款如下：
使用SDK名称：用户体验监控SDK
服务类型：SDK服务
使用目的：采集应用体验数据，用于应用性能问题统计与分析
收集个人信息类型：用户信息、应用信息、设备信息、流量信息、设备状态信息、网络状态信息
隐私权政策链接：https://terms.alicdn.com/legal-agreement/terms/privacy_policy_full/20240308104330389/20240308104330389.html
请务必做延迟初始化配置，确保用户授权《隐私权政策》后再初始化用户体验监控SDK。
请您务必按照如上提示合规使用用户体验监控SDK服务，因您未合规使用SDK服务所导致的风险由您自行承担，并承担因此对用户体验监控带来的损失。

更多说明，请参见用户体验监控SDK隐私合规书写说明。