全部產品
Search
文件中心

Application Real-Time Monitoring Service:接入Flutter應用

更新時間:Dec 20, 2025

阿里雲使用者體驗監控 RUM 官方 Flutter 外掛程式,當前支援 Android、iOS、HarmonyOS 平台。

版本要求

  • Flutter:3.0.0+

  • iOS:12.0+

  • Android:7.0+

步驟一:整合Flutter外掛程式

  1. 在pubspec.yaml設定檔中添加依賴。

    dependencies:
      flutter:
        sdk: flutter
    
      alibabacloud_rum_flutter_plugin: ^2.1.0
  2. 在Flutter專案根目錄執行以下命令載入外掛程式。

    flutter packages get
  3. 如果是iOS應用,請在工程ios目錄下執行以下命令更新Pod環境。

    pod install
  4. 初始化Flutter SDK。

    1. main.dart檔案中匯入以下包。

      import 'package:alibabacloud_rum_flutter_plugin/alibabacloud_rum_flutter_plugin.dart';
    2. 初始化SDK。

      void main() {
        // 注釋原有的 runApp() ⽅法
        // runApp(MyApp());
        // (必須)初始化SDK
        AlibabaCloudRUM().start(MyApp());
        // (可選)自訂使用者名稱稱
        AlibabaCloudRUM().setUserName("xxxxxx");
      }
  5. (可選)採集 actions事件。

    RUM Flutter 外掛程式支援採集 Flutter 的點擊等action事件。您需要使用配置並使用AlibabaCloudActionCapture採集使用者點擊事件,以下為使用執行個體:

    class MyApp extends StatelessWidget {
      @override
      Widget build(BuildContext context) {
        return AlibabaCloudActionCapture(
              child: Scaffold(
              appBar: AppBar(
                title: const Text('AlibabaCloudRUM'),
              ),
              body: // 你的其他代碼
            ));
      }
    }
  6. 外掛程式接入驗證。

    啟動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

步驟二:Native SDK 整合

Flutter 專案在整合 Alibaba Cloud RUM SDK 時,除了需要整合 Flutter 外掛程式之外,還需要分別整合 Android、iOS、HarmonyOS SDK。您可以參考下面的文檔整合:

相關文檔