Application Real-Time Monitoring Service：接入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)