接入通过Flutter开发的移动应用_应用实时监控服务(ARMS)-阿里云帮助中心

ARMS用户体验监控提供了Flutter插件用于监控通过Flutter开发的iOS和Android应用。本文介绍如何集成Flutter插件并将应用接入用户体验监控。

版本要求

iOS：8.0+
Android：4.0+
Flutter：3.0.0+

步骤一：集成Flutter插件

在pubspec.yaml配置文件中添加依赖。

dependencies:
  flutter:
    sdk: flutter

  alibabacloud_rum_flutter_plugin: ^0.2.4

在Flutter项目根目录执行以下命令加载插件。
```
flutter packages get
```
如果是iOS应用，请在工程ios目录下执行以下命令更新Pod环境。
```
pod install
```

初始化Flutter SDK。

在main.dart文件中导入以下包。

import 'package:alibabacloud_rum_flutter_plugin/alibabacloud_rum_flutter_plugin.dart';

初始化SDK。

void main() {
  // 注释原有的 runApp() ⽅法
  // runApp(MyApp());
  // （必须）初始化SDK
  AlibabaCloudRUM().start(MyApp());
  // （可选）自定义用户名称
  AlibabaCloudRUM().setUserName("xxxxxx");
}

API参数	说明
start	启用Flutter插件。
setUserName	自定义用户名称。

插件接入验证。
启动Flutter应用，DEBUG CONSOLE中返回[INFO][AlibabaCloudRUM]: alibabacloud_rum_flutter_plugin start success即表示SDK接入成功。
返回示例如下：
```
flutter: [2024-05-27 16:43:39][INFO][AlibabaCloudRUM]: alibabacloud_rum_flutter_plugin start success
```

步骤二：集成原生SDK

Flutter项目在集成Alibaba Cloud RUM SDK时，除了需要集成Flutter插件之外，还需要分别初始化Android和iOS SDK。

Android

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

初始化SDK。

ARMS RUM SDK需要宿主App授予以下权限。

说明

请将以下代码中的ConfigAddress和AppID替换为上一步获取的当前应用对应的ConfigAddress和AppID。

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

接入验证。
启动已经集成了SDK的APK应用，查看Android Studio Logcat日志，搜索openrum关键字（或者过滤OpenRUM标签），出现如下log则表示SDK集成成功且数据开始采集。

iOS

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

初始化SDK。

在main函数或- application:didFinishLaunchingWithOptions:方法中完成SDK的初始化。

说明

请将以下代码中的ConfigAddress和AppID替换为上一步获取的当前应用对应的ConfigAddress和AppID。

Objective-C

[AlibabaCloudRUM setConfigAddress:@"<your config address>"];// ConfigAddress，步骤一创建RUM应用时获取。
[AlibabaCloudRUM startWithAppID:@"<your appId>"];// AppID，步骤一创建RUM应用时获取。

Swift

AlibabaCloudRUM.setConfigAddress("<your config address>")// ConfigAddress，步骤一创建RUM应用时获取。
AlibabaCloudRUM.start("<your appId>")// AppID，步骤一创建RUM应用时获取。

接入验证。
应用运行后，返回SDK Config Succeeded即表示SDK初始化成功。
返回示例：
```
2024-04-23 16:07:18.450 [OpenRUM] [CONFIG]  SDK Config Succeeded.
```

接入Flutter应用

版本要求

步骤一：集成Flutter插件

步骤二：集成原生SDK

Android

iOS

Objective-C

Swift

相关文档