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
創建應用。
登錄ARMS控制臺。
在左側導航欄選擇
,并在頂部菜單欄選擇目標地域。在應用列表頁面單擊添加應用。
在創建應用面板單擊Android。
在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
創建應用。
登錄ARMS控制臺。
在左側導航欄選擇
,并在頂部菜單欄選擇目標地域。在應用列表頁面單擊添加應用。
在創建應用面板單擊iOS。
在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.