接入iOS應用 - Application Real-Time Monitoring Service

使用者體驗監控提供了非常全面的移動端應用監控能力，支援對應用效能、崩潰、卡頓等關鍵計量的進行即時監控與分析。本文介紹如何將iOS應用接入。

重要

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.2.8'
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