接入Flutter应用

阿里云用户体验监控 RUM 官方 Flutter 插件,当前支持 Android、iOS、HarmonyOS 平台。

版本要求

  • Flutter:3.0.0+

  • iOS:12.0+

  • Android:7.0+

  • HarmonyOS:API 12+

步骤一:集成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。您可以参考下面的文档集成:

相关文档