云监控2.0的用户体验监控提供了非常全面的移动端应用监控能力,支持对应用性能、崩溃、卡顿等关键指标的进行实时监控与分析。本文介绍如何将iOS应用接入云监控2.0。
步骤一:创建应用
登录云监控2.0控制台,选择目标工作空间,在左侧导航栏选择 。
在前端应用区域单击iOS卡片,输入应用名称并根据需求配置其他参数,然后单击创建应用。
说明应用名称唯一,不能与已创建的应用名称重复。
创建成功后,页面下方将会生成相应的接入代码,代码中包含了AppID、Endpoint等关键信息。
后续您可以在
页面查看创建的应用,进入应用详情,在 页面可以查看应用接入代码。
步骤二:集成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', '1.0.5' end
在项目根目录下(或Podfile文件所在目录)执行以下命令更新Pod环境。
pod install --repo-update
手动集成
下载SDK并解压。
解压.zip文件后得到如下内容:
AlibabaCloudRUM.xcframework
AlibabaCloudRUMSDK.xcframework
配置工程。
通过Xcode打开
,在弹出的面板中选择上一步下载的2个组件包,然后单击Add。说明不同版本的XCode会略有差异。
建议选中"Copy files to destination"。
在项目设置target > Build Phases > Link Binary With Libraries中添加如下依赖库。
libc++.tbd(必须引入)
libresolv.tbd(必须引入)
在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名称。
[AlibabaCloudRUM startWithAppID:@"<your appId>"]; // AppID,步骤一创建RUM应用时获取。
Swift
AlibabaCloudRUM.setEndpoint("<your endpoint>") // Endpoint,步骤一创建RUM应用时获取。
AlibabaCloudRUM.setWorkspace:("<your workspace>") // 替换为当前workspace名称。
AlibabaCloudRUM.start("<your appId>") // AppID,步骤一创建RUM应用时获取。
接入验证
应用运行后,返回AlibabaCloudRUMSDK init success
即表示SDK初始化成功。
返回示例:
[AlibabaCloudRUM] [INFO ] [init] AlibabaCloudRUMSDK init success
合规说明
应用的数据合规非常重要,您须确保按照当前法律法规或监管要求使用用户体验监控SDK服务,为避免因数据合规问题导致的应用下架,请您务必做好以下三步:
请务必确保您已经将用户体验监控SDK升级到满足监管新规的最新版本。
请务必在《隐私权政策》中向用户告知使用了用户体验监控SDK,参考条款如下:
使用SDK名称:用户体验监控SDK
服务类型:SDK服务
使用目的:采集应用体验数据,用于应用性能问题统计与分析
收集个人信息类型:用户信息、应用信息、设备信息、流量信息、设备状态信息、网络状态信息
请务必做延迟初始化配置,确保用户授权《隐私权政策》后再初始化用户体验监控SDK。
请您务必按照如上提示合规使用用户体验监控SDK服务,因您未合规使用SDK服务所导致的风险由您自行承担,并承担因此对用户体验监控带来的损失。
更多说明,请参见用户体验监控SDK隐私合规书写说明。