全部产品
Search
文档中心

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

更新时间:Nov 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.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"...,在弹出的面板中选择上一步下载的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