全部產品
Search
文件中心

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

更新時間:Dec 25, 2025

ARMS使用者體驗監控的App監控提供了非常全面的移動端應用監控能力,主要包括iOS應用監控和Android應用監控。本文介紹如何將iOS應用接入ARMS使用者體驗監控

重要

SDK 的接入參數在 2.0.0 版本發生了變化,並且與之前的版本不相容。升級到2.0.0及以上版本時,為了確保 SDK 能夠被正常初始化,請按照最新接入文檔完成 SDK 接入和升級。

步驟一:整合SDK

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.0.2'
    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"...,在彈出的面板中選擇上一步下載的2個組件包,然後單擊Add

      說明
      • 不同版本的XCode會略有差異。

      • 建議選中"Copy files to destination"。

      image

    2. 在專案設定target > Build Phases > Link Binary With Libraries中添加如下依賴庫。

      • libc++.tbd(必須引入)

      • libresolv.tbd(必須引入)

      image

    3. target > Build Settings中搜尋Other Linker Flags,添加編譯標誌-ObjC

      重要

      請注意檢查-ObjC的拼字。

      image

步驟三:匯入標頭檔

在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