应用实时监控服务ARMS：接入iOS应用

Cocoapods自动集成（推荐）

1. 在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.4.0'
   end

2. 在项目根目录下（或Podfile文件所在目录）执行以下命令更新Pod环境。

   pod install --repo-update

手动集成

1. 下载SDK并解压。

   解压.zip文件后得到如下内容：

   • AlibabaCloudRUM.xcframework

   • AlibabaCloudRUMSDK.xcframework

2. 配置工程。

   1. 通过 Xcode File > Add Files to "Your Project Name"...，在弹出的面板中选中下载的组件包，然后单击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 的拼写，确保拼写正确。

Objective-C

@import AlibabaCloudRUM;

Swift

import AlibabaCloudRUM

Objective-C

// 【建议】开启 session replay 模块
[AlibabaCloudRUM enableModule:AlibabaCloudModuleSessionReplay];

// 【必须】Endpoint 在创建 RUM 应用时获取
[AlibabaCloudRUM setEndpoint:@"<your endpoint>"];
// 【必须】Workspace 在创建 RUM 应用时获取
[AlibabaCloudRUM setWorkspace:@"<your workspace>"];
// 【必须】ServiceId 在创建 RUM 应用时获取
[AlibabaCloudRUM start:@"<your serviceId>"];

// 【建议】配置 Session Replay，配置内容为：
// 1. 采样率 5%
// 2. 保留静态文本、提示文本和普通输入
// 3. 保留内置资源图片
// 4. 记录触控位置
AlibabaCloudSessionReplayConfiguration *sessionReplayConfiguration =
[AlibabaCloudSessionReplayConfiguration configurationWithSampleRate:5
                                                textAndInputPrivacy:AlibabaCloudTextAndInputPrivacyMaskSensitiveInputs
                                                       imagePrivacy:AlibabaCloudImagePrivacyMaskNonBundledOnly
                                                       touchPrivacy:AlibabaCloudTouchPrivacyShow];
// 【建议】启动 Session Replay 数据采集
[AlibabaCloudSessionReplay startWithConfiguration:sessionReplayConfiguration];

Swift

// 【建议】开启 session replay 模块
AlibabaCloudRUM.enableModule(.sessionReplay)

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

// 【建议】配置 Session Replay，配置内容为：
// 1. 采样率 5%
// 2. 保留静态文本、提示文本和普通输入
// 3. 保留内置资源图片
// 4. 记录触控位置
let configuration = AlibabaCloudSessionReplayConfiguration(sampleRate: 5,
                                                           textAndInputPrivacy: .maskSensitiveInputs,
                                                           imagePrivacy: .maskNonBundledOnly,
                                                           touchPrivacy: .show)
// 【建议】启动 Session Replay 数据采集
AlibabaCloudSessionReplay.start(configuration)