为iOS应用集成用户体验监控SDK-应用实时监控服务-阿里云

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

重要

SDK 的接入参数在 2.0.0 版本发生了变化，并且与之前的版本不兼容。升级到2.0.0及以上版本时，为了确保 SDK 能够被正常初始化，请按照最新接入文档完成 SDK 接入和升级。

步骤一：集成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', '2.0.0'
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 setEndpoint:@"<your endpoint>"];// Endpoint 在创建 RUM 应用时获取
[AlibabaCloudRUM setWorkspace:@"<your workspace>"];// Workspace 在创建 RUM 应用时获取
[AlibabaCloudRUM start:@"<your serviceId>"];// ServiceId 在创建 RUM 应用时获取

Swift

AlibabaCloudRUM.setEndpoint("<your endpoint>")// Endpoint 在创建 RUM 应用时获取
AlibabaCloudRUM.setWorkspace:("<your workspace>")// Workspace 在创建 RUM 应用时获取
AlibabaCloudRUM.start("<your serviceId>")// ServiceId 在创建 RUM 应用时获取

接入验证

运行后控制台输出 "AlibabaCloudRUMSDK init success"，即表示 SDK 初始化成功。如下：

[AlibabaCloudRUM] [INFO   ] [RUM] <start> AlibabaCloud RUM 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隐私合规书写说明。