文档

接入iOS应用

更新时间:

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

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

  1. 登录ARMS控制台
  2. 在左侧导航栏选择用户体验监控 > 应用列表,并在顶部菜单栏选择目标地域。

  3. 应用列表页面单击添加应用

  4. 创建应用面板单击iOS

  5. iOS面板输入应用名称和描述,然后单击创建

    说明

    应用名称唯一,不能与已创建的应用名称重复。

    创建成功后,当前应用将会自动生成对应的ConfigAddress(上报地址)和AppID。

  6. 下载SDK并解压。

    解压后内容如下:

    image.png

步骤二:集成至项目中

  1. 根据实际环境将对应文件夹下的OpenRUM.framework移动至项目目录下。

    • ios-arm64_armv7_armv7s:真机环境

    • ios-arm64_i386_x86_64-simulator:模拟器环境

  2. 选择对应配置,然后单击Finish

    image.png

    在左侧目录查看已成功添加的OpenRUM依赖项。

    image.png

  3. BuildPhass > Link Binary With Libraries中添加OpenRUM.framework,并添加以下依赖库。

    • libresolv.tbd(必须引入)

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

    • webKit.framework(如果项目支持iOS 8之前的版本,则需要添加)

    image.png

  4. Build Setting中搜索Other Linker Flags,添加编译标志-ObjC

    image.png

步骤三:初始化

重要

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

Objective-C

  1. main.mAppDelegate.m中引入头文件。

    #import <OpenRUM/OpenRUM.h>
  2. 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;
    }
  3. 运行后控制台输出SDK Config Succeeded, 即表示嵌码成功。

    输出示例:

    2023-07-31 16:07:18.450 [OpenRUM] [CONFIG]  SDK Config Succeeded.
    说明

    SDK推荐在main函数中启动,可以完整捕获- application didFinishLaunchingWithOptions方法以及内部相关方法在整个启动性能中的耗时情况。否则只能从Agent启动开始捕获,且只有启动的耗时,没有具体方法的耗时详情。

Swift

  1. 在对应的桥接文件里Bridging-Header.h里引入头文件。

    #import <OpenRUM/OpenRUM.h>
  2. 在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
        }
    }
  3. 运行后控制台输出SDK Config Succeeded,即表示嵌码成功。

    输出示例:

    2023-07-31 16:07:18.450 [OpenRUM] [CONFIG] SDK Config Succeeded.

  • 本页导读 (1)
文档反馈