Flutter移动应用监控插件mobsur_flutter_sdk的使用

更多详细信息请访问 https://mobsur.com。

使用方法

1. 在 pubspec.yaml 文件中添加依赖项

dependencies:
  mobsur_flutter_sdk: ^1.0.4

然后运行以下命令以获取依赖项：

flutter pub get

2. 在项目中导入库

import 'package:mobsur_flutter_sdk/mobsur_flutter_sdk.dart';

3. 调用初始化方法

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  // 您可以在应用程序的其他位置调用此方法，
  // 但不应在触发调查的事件之前调用。
  MobSurSDK().setup('YOUR-APP-ID', 'user-id');

  runApp(const MyApp());
}

4. 调用事件记录方法并传递 BuildContext

MobSurSDK().logEvent('event-name-here', context);

5. 如果在初始化时不知道客户端 ID，可以稍后更新它。客户端 ID 不能为空字符串。

MobSurSDK().updateClientId('client-id-here');

注意事项

对于 Android 平台，我们有最低 SDK 版本的要求。如果需要在低于 32 的版本上使用该应用，请联系我们。

// android/app/build.gradle:
...
android {
  compileSdkVersion 32 // 或更高版本
  ...

  defaultConfig {
    ...
    minSdkVersion 32 // 或更高版本
    ...
  }
}
...

推荐做法

建议在管理事件的包装类中调用事件方法。如果您已经在应用中使用了事件，则最好为所有事件调用该方法，然后在仪表板中选择正确的事件。

完整示例 Demo

以下是一个完整的示例代码，展示了如何集成和使用 mobsur_flutter_sdk：

import 'package:flutter/material.dart';
import 'package:mobsur_flutter_sdk/mobsur_flutter_sdk.dart';

void main() {
  // 初始化 Flutter 应用
  WidgetsFlutterBinding.ensureInitialized();

  // 设置 MobSur SDK
  MobSurSDK().setup('YOUR-APP-ID', 'user-id');

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('MobSur SDK 示例'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              // 记录事件
              MobSurSDK().logEvent('example-event', context);
              print('事件已记录！');
            },
            child: Text('记录事件'),
          ),
        ),
      ),
    );
  }
}

更多关于Flutter移动应用监控插件mobsur_flutter_sdk的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter移动应用监控插件mobsur_flutter_sdk的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


mobsur_flutter_sdk 是一个用于移动应用监控的 Flutter 插件，通常用于收集应用的使用数据、性能指标、用户行为等信息。以下是如何在 Flutter 项目中使用 mobsur_flutter_sdk 的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 mobsur_flutter_sdk 的依赖。

dependencies:
  flutter:
    sdk: flutter
  mobsur_flutter_sdk: ^<latest_version>  # 替换为最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化 SDK

在你的 Flutter 应用的 main.dart 文件中，初始化 mobsur_flutter_sdk。

import 'package:flutter/material.dart';
import 'package:mobsur_flutter_sdk/mobsur_flutter_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 MobSur SDK
  await MobSurFlutterSDK.initialize(
    appKey: 'YOUR_APP_KEY',  // 替换为你的 App Key
    appSecret: 'YOUR_APP_SECRET',  // 替换为你的 App Secret
    environment: MobSurEnvironment.production,  // 设置环境，可以是 production 或 development
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

3. 设置用户信息（可选）

如果你想跟踪特定用户的行为，可以设置用户信息。

MobSurFlutterSDK.setUserInfo(
  userId: 'USER_ID',  // 用户 ID
  userName: 'USER_NAME',  // 用户名
  userEmail: 'USER_EMAIL',  // 用户邮箱
);

4. 跟踪自定义事件

你可以使用 trackEvent 方法来跟踪自定义事件。

MobSurFlutterSDK.trackEvent(
  eventName: 'button_clicked',  // 事件名称
  eventData: {'button_id': 'submit_button'},  // 事件数据
);

5. 跟踪页面浏览

你可以使用 trackPageView 方法来跟踪页面浏览。

MobSurFlutterSDK.trackPageView(
  pageName: 'home_page',  // 页面名称
  pageData: {'page_id': 'home'},  // 页面数据
);

6. 处理崩溃报告（可选）

mobsur_flutter_sdk 可能还提供了崩溃报告功能。你可以通过以下方式启用它：

MobSurFlutterSDK.enableCrashReporting();

7. 调试和测试

在开发过程中，你可以通过设置 environment 为 MobSurEnvironment.development 来启用调试模式，以便在控制台中查看日志。

await MobSurFlutterSDK.initialize(
  appKey: 'YOUR_APP_KEY',
  appSecret: 'YOUR_APP_SECRET',
  environment: MobSurEnvironment.development,
);

8. 发布应用

在发布应用之前，确保将 environment 设置为 MobSurEnvironment.production，以便在生产环境中收集数据。

await MobSurFlutterSDK.initialize(
  appKey: 'YOUR_APP_KEY',
  appSecret: 'YOUR_APP_SECRET',
  environment: MobSurEnvironment.production,
);
回到顶部