Flutter应用性能监控插件appmetrica_plugin的使用

AppMetrica SDK 是由 Yandex 提供的一个用于Flutter的应用分析和营销工具，支持跨多个主流移动平台工作。本文将介绍如何在Flutter项目中集成和使用 appmetrica_plugin 插件。

支持的功能

该库可以帮助您收集以下数据：

• 设备信息：包括操作系统、手机制造商和型号、屏幕分辨率、界面语言等参数。
• 推荐信息：了解用户是如何到达应用程序的。
• 用户群体：所有关键的产品KPI（如MAU、WAU、DAU等）都可以实时更新。
• 用户档案：研究单个用户的特征和行为历史，以获得更详细的行为模式视图。
• 应用内销售收益及相关收益指标：ARPU、平均订单价值、重复购买等。
• 应用运行期间发生的错误：所有崩溃和错误在AppMetrica易于阅读的报告中分组，并附带OS/应用版本及其他技术细节。
• 任何自定义事件。
• Android或iOS上可用的其他功能。

更多详情请访问 AppMetrica官方网站。

开始使用

添加依赖

在您的Flutter项目中添加以下依赖项：

dependencies:
  ...
  appmetrica_plugin: ^3.1.0

初始化配置

激活库并使用您的API Key进行初始化：

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

AppMetricaConfig get _config =>
    const AppMetricaConfig('Your api key', logs: true);

Future<void> main() async {
  AppMetrica.runZoneGuarded(() {
    WidgetsFlutterBinding.ensureInitialized();
    AppMetrica.activate(_config);
    runApp(const MyApp());
  });
}

报告事件

通过 AppMetrica.reportEvent 方法来报告事件：

AppMetrica.reportEvent('My first AppMetrica event!');

示例Demo

以下是完整的示例代码，展示了如何使用 appmetrica_plugin 来报告事件、错误和其他操作：

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('AppMetrica plugin example app'),
        ),
        body: Builder(
          builder: (BuildContext context) => Padding(
            padding: const EdgeInsets.symmetric(vertical: 10, horizontal: 5),
            child: ListView(
              children: <Widget>[
                ElevatedButton(
                  onPressed: () {
                    AppMetrica.reportEvent('Event name');
                  },
                  child: const Text('Report Event'),
                ),
                ElevatedButton(
                  onPressed: () {
                    AppMetrica.reportError(
                      message: 'Error message',
                      errorDescription:
                          AppMetricaErrorDescription.fromCurrentStackTrace(
                              message: 'Error message', type: 'Error type'),
                    ).ignore();
                  },
                  child: const Text('Report Error'),
                ),
                // 其他按钮代码省略...
              ],
            ),
          ),
        ),
      ),
    );
  }

  void _showSnackBar(BuildContext context, String content) {
    final scaffold = ScaffoldMessenger.of(context);
    scaffold.hideCurrentSnackBar();
    scaffold.showSnackBar(
      SnackBar(
        content: Text(content),
        duration: const Duration(seconds: 5),
      ),
    );
  }
}

提交改进建议

如果您发现bug，需要新功能，或其他改进建议，请使用 反馈表。

注意事项

此插件使用Pigeon生成Flutter与主机平台之间的通信接口。

通过上述步骤和示例代码，您可以轻松地在Flutter应用中集成AppMetrica SDK，从而更好地监控应用性能和用户行为。