Flutter应用中心管理插件app_center_plugin的使用

Flutter应用中心管理插件app_center_plugin的使用

1. 插件简介

app_center_plugin 是一个用于集成 Microsoft App Center 服务的 Flutter 插件。通过该插件，开发者可以在 Flutter 应用中轻松集成 App Center 的功能，如崩溃报告、自定义事件跟踪等。App Center 提供了强大的分析和监控工具，帮助开发者更好地管理和优化应用。

2. Android 前置条件

• 您的目标设备需要运行 Android 5.0（API 级别 21）或更高版本。
• 更多详情请参考 Android 入门指南。

3. iOS 前置条件

• 您的目标设备需要运行 iOS 9.0 或更高版本。
• 在项目中的 ios 文件夹内运行 pod install 来安装 AppCenter 依赖项。
• 注意：如果您在运行 pod install 时遇到类似 [!] Unable to find a specification for 'AppCenter' 的错误，请先运行 pod repo update 以获取最新的 Cocoapods 仓库，然后再运行 pod install。
• 更多详情请参考 iOS 入门指南。

4. 使用方法

4.1 简单使用示例

import 'package:app_center_plugin/app_center_plugin.dart';

// 根据平台选择不同的 App Center Secret
final secret = Platform.isAndroid ? 'ANDROID_SECRET' : 'IOS_SECRET';

void main() async {
  // 初始化 AppCenter
  await AppCenter.start(secret);

  // 跟踪自定义事件
  AppCenter.trackEvent('my event', <String, String> {
    'prop1': 'prop1',
    'prop2': 'prop2',
  });

  // 跟踪错误
  AppCenter.trackError('error message');
}

4.2 捕获 Flutter 和 Dart 错误

为了确保所有未捕获的错误都能被发送到 App Center，您可以在应用启动时设置全局错误处理程序。以下是一个完整的示例，展示了如何捕获 Flutter 和 Dart 错误并将其发送到 App Center：

import 'dart:io';
import 'dart:ui';

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

const androidSecret = '043be909-44a3-4675-b8b3-3078cb55d379';
const iOSSecret = '894914f3-91d8-48c0-a929-d02e8b5b2178';

void main() async {
  // 根据平台选择不同的 App Center Secret
  final secret = Platform.isAndroid ? androidSecret : iOSSecret;

  // 确保 Flutter 绑定已初始化
  WidgetsFlutterBinding.ensureInitialized();

  // 启动 AppCenter
  await AppCenter.start(secret);

  // 捕获 Flutter 错误并发送到 AppCenter
  FlutterError.onError = (FlutterErrorDetails errorDetails) {
    FlutterError.presentError(errorDetails);
    // 发送 Flutter 错误到 AppCenter
    AppCenter.trackError(
      errorDetails.exceptionAsString(),
      properties: {"library": errorDetails.library ?? ""},
      stackTrace: errorDetails.stack,
    );
  };

  // 捕获未被捕获的平台错误并发送到 AppCenter
  PlatformDispatcher.instance.onError = (error, stack) {
    AppCenter.trackError(
      error.toString(),
      stackTrace: stack,
    );
    return true;
  };

  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 跟踪应用启动事件
    AppCenter.trackEvent('MyApp');
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
      debugPrint("Sending event to AppCenter");
      // 跟踪点击按钮的事件
      AppCenter.trackEvent('Increment Counter', {'counter': _counter.toString()});
    });
  }

  void _trackError() {
    debugPrint("Sending error to AppCenter");
    // 抛出自定义异常以测试错误跟踪
    throw const CustomException("Custom error message");
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          FloatingActionButton(
            onPressed: _trackError,
            tooltip: 'Error',
            child: const Icon(Icons.bug_report),
          ),
          FloatingActionButton(
            onPressed: _incrementCounter,
            tooltip: 'Increment',
            child: const Icon(Icons.add),
          ),
        ],
      ),
    );
  }
}

// 自定义异常类
class CustomException implements Exception {
  const CustomException(String message);
}