Flutter应用集成插件appcenter_flutter的使用

Flutter应用集成插件appcenter_flutter的使用

本插件目前集成了AppCenter分析和崩溃报告功能。

开始使用

要开始使用，请访问AppCenter并注册您的应用程序。

对于详细的AppCenter API文档，请访问AppCenter文档。

构建

使用以下命令构建：

flutter build apk

在android/app/build.gradle中添加以下部分：

android {
  ...
  // This is likely needed, see https://github.com/flutter/flutter/issues/58247
  lintOptions {
      disable 'InvalidPackage'
      checkReleaseBuilds false
  }
}

建议先尝试示例项目来解决本地构建问题。

使用方法

基本用法

import 'package:appcenter_flutter/appcenter.dart';

await AppCenter.startAsync(
    appSecretAndroid: '******',
    appSecretIOS: '******',
    enableAnalytics: true, // 默认为true
    enableCrashes: true, // 默认为true
  );
  
AppCenter.trackEventAsync('my event', <String, String> {
  'prop1': 'prop1',
  'prop2': 'prop2',
});

运行时启用或禁用功能

await AppCenter.configureAnalyticsAsync(enabled: true);

await AppCenter.configureCrashesAsync(enabled: true);

故障排除

iOS: [!] CocoaPods找不到兼容的版本

手动删除podfile.lock并重新构建，这是升级iOS原生依赖项时常见的问题。

Android构建问题

总是检查示例项目是否可以构建，如果不能构建，请报告问题。如果可以构建，请检查Gradle设置。

检查点包括：

• gradle-wrapper.properties中的Gradle版本
• build.gradle中的Kotlin版本
• build.gradle中的compileSdkVersion
• build.gradle中的com.android.tools.build:gradle版本
• 示例中的lintOptions（见问题）
• 示例中的build.gradle脚本
• 示例中的settings.gradle

jcenter退役

由于jcenter将在2021年5月1日退役，因此请将其替换为：

repositories {
     google()
     // jcenter()
     mavenCentral()
     gradlePluginPortal()
 }

示例代码

以下是完整的示例代码：

import 'package:flutter/material.dart';

import 'package:package_info/package_info.dart';
import 'package:appcenter_flutter/appcenter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AppCenter.startAsync(
    appSecretAndroid: '<APPCENTER-SECRET-ANDROID>',
    appSecretIOS: '<APPCENTER-SECRET-IOS>',
  );

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    AppCenter.trackEventAsync('_MyAppState.initState');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件flutter应用'),
        ),
        body: Container(
          padding: EdgeInsets.all(20),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: <Widget>[
              const PackageInfoContent(),
              const SizedBox(height: 8.0),
              FutureBuilder(
                future: AppCenter.isCrashesEnabledAsync(),
                builder: (_, AsyncSnapshot<bool?> snapshot) {
                  if (snapshot.hasData) {
                    final isCrashesEnabled = snapshot.data!;

                    return Text('IsCrashesEnabled: $isCrashesEnabled');
                  }

                  return const CircularProgressIndicator.adaptive();
                },
              ),
              const SizedBox(height: 8.0),
              FutureBuilder(
                future: AppCenter.isAnalyticsEnabledAsync(),
                builder: (_, AsyncSnapshot<bool?> snapshot) {
                  if (snapshot.hasData) {
                    final isAnalyticsEnabled = snapshot.data!;

                    return Text('IsAnalyticsEnabled: $isAnalyticsEnabled');
                  }

                  return const CircularProgressIndicator.adaptive();
                },
              ),
            ],
          ),
        ),
      ),
    );
  }
}

class PackageInfoContent extends StatelessWidget {
  const PackageInfoContent();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: PackageInfo.fromPlatform(),
      builder: (_, AsyncSnapshot<PackageInfo> snapshot) {
        if (snapshot.hasData) {
          final packageInfo = snapshot.data!;

          return Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text('App name:\n${packageInfo.appName}'),
              const SizedBox(height: 8.0),
              Text('Package name:\n${packageInfo.packageName}'),
              const SizedBox(height: 8.0),
              Text('Version:\n${packageInfo.version}'),
              const SizedBox(height: 8.0),
              Text('Build:\n${packageInfo.buildNumber}'),
            ],
          );
        }

        return const CircularProgressIndicator.adaptive();
      },
    );
  }
}