将iOS应用接入ARMS用户体验监控-阿里云帮助中心

ARMS用户体验监控的App监控提供了非常全面的移动端应用监控能力，主要包括iOS应用监控和Android应用监控。本文介绍如何将iOS应用接入ARMS用户体验监控。

步骤一：创建应用并获取SDK

登录ARMS控制台。
在左侧导航栏选择用户体验监控 > 应用列表，并在顶部菜单栏选择目标地域。
在应用列表页面单击添加应用。
在创建应用面板单击iOS。
在iOS面板输入应用名称和描述，然后单击创建。
说明
应用名称唯一，不能与已创建的应用名称重复。
创建成功后，当前应用将会自动生成对应的ConfigAddress（上报地址）和AppID。
下载SDK并解压。
解压后内容如下：

步骤二：集成至项目中

根据实际环境将对应文件夹下的OpenRUM.framework移动至项目目录下。
- ios-arm64_armv7_armv7s：真机环境
- ios-arm64_i386_x86_64-simulator：模拟器环境
选择对应配置，然后单击Finish。
在左侧目录查看已成功添加的OpenRUM依赖项。
在Build Phass > Link Binary With Libraries中添加OpenRUM.framework，并添加以下依赖库。
- libresolv.tbd（必须引入）
- libc++.tbd（必须引入）
- webKit.framework（如果项目支持iOS 8之前的版本，则需要添加）
在Build Setting中搜索Other Linker Flags，添加编译标志-ObjC。

步骤三：初始化

重要

请严格按照示例代码顺序执行，否则会导致SDK配置失败。

Objective-C

在main.m或AppDelegate.m中引入头文件。
```
#import <OpenRUM/OpenRUM.h>
```

在main函数或- application:didFinishLaunchingWithOptions:方法中设置Config地址与AppID。

说明

请将以下代码中的上报地址和appId替换为控制台获取的当前应用对应的ConfigAddress和AppID。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    [OpenRUM setConfigAddress:@"上报地址"]; //每个用户拥有不同的上报地址，具体链接可在应用设置页查看
    [OpenRUM startWithAppID:@"appId"]; 
  	[OpenRUM setUserID:@"user-id"]; //可选配置，初始化用户名称，用于配置自定义标识。
    return YES;
}

运行后控制台输出SDK Config Succeeded, 即表示嵌码成功。
输出示例：
```
2023-07-31 16:07:18.450 [OpenRUM] [CONFIG]  SDK Config Succeeded.
```
说明
SDK推荐在main函数中启动，可以完整捕获- application didFinishLaunchingWithOptions方法以及内部相关方法在整个启动性能中的耗时情况。否则只能从Agent启动开始捕获，且只有启动的耗时，没有具体方法的耗时详情。

Swift

在对应的桥接文件里Bridging-Header.h里引入头文件。
```
#import <OpenRUM/OpenRUM.h>
```

在AppDelegate.swift文件中配置以下代码。

说明

请将以下代码中的上报地址和appId替换为控制台获取的当前应用对应的ConfigAddress和AppID。

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        OpenRUM.setConfigAddress("上报地址") //每个用户拥有不同的上报地址，具体链接可在应用设置页查看
        OpenRUM.start(withAppID: "appId")
      	OpenRUM.setUserID("user-id") // 可选配置，初始化用户名称，用于配置自定义标识。
        return true
    }
}

运行后控制台输出SDK Config Succeeded，即表示嵌码成功。
输出示例：
```
2023-07-31 16:07:18.450 [OpenRUM] [CONFIG] SDK Config Succeeded.
```