Flutter AppCenter Bundle 更新至空安全插件flutter_appcenter_bundle_updated_to_null_safety的使用

Flutter AppCenter Bundle 更新至空安全插件flutter_appcenter_bundle_updated_to_null_safety的使用

简介

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

开始使用

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

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

构建

AppCenter分发在发布到Google Play时存在一个问题。为了解决这个问题，您可以使用以下命令：

flutter build --flavor googlePlay

来构建Google Play版本，并使用：

flutter build --flavor appCenter

来构建AppCenter版本。

默认情况下，flutter build apk 命令会在 build/app/outputs/flutter-apk 目录下生成两个版本。您需要在 android/app/build.gradle 文件中添加以下部分：

android {
  ...

  flavorDimensions "distribute"
  productFlavors {
      appCenter {
          dimension "distribute"
      }

      googlePlay {
          dimension "distribute"
      }
  }

  // 这可能是必需的，详见 https://github.com/flutter/flutter/issues/58247
  lintOptions {
      disable 'InvalidPackage'
      checkReleaseBuilds false
  }
}

如果您已经有风味设置并希望合并，请检查示例项目。请注意，风味维度是正交的。您可能只需要重用分发风味以获得最佳构建性能。有关详细信息，请参阅这篇文章。

在解决本地构建问题时，请先尝试运行示例项目。

使用

基本用法

import 'package:flutter_appcenter_bundle_updated_to_null_safety/flutter_appcenter_bundle_updated_to_null_safety.dart';

await AppCenter.startAsync(
    appSecretAndroid: '******',
    appSecretIOS: '******',
    enableAnalytics: true, // 默认为true
    enableCrashes: true, // 默认为true
    enableDistribute: true, // 默认为false
    usePrivateDistributeTrack: false, // 默认为false
    disableAutomaticCheckForUpdate: false, // 默认为false
  );

AppCenter.trackEventAsync('my event', <String, String> {
  'prop1': 'prop1',
  'prop2': 'prop2',
});

动态启用或禁用功能

await AppCenter.configureAnalyticsAsync(enabled: true);

await AppCenter.configureCrashesAsync(enabled: true);

await AppCenter.configureDistributeAsync(enabled: true);

await AppCenter.configureDistributeDebugAsync(enabled: true); // 仅限Android

await AppCenter.checkForUpdateAsync(); // 手动检查更新

故障排除

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

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

Android构建问题

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

检查点包括：

• Gradle版本（在 gradle-wrapper.properties 中）
• Kotlin版本（在 build.gradle 中）
• compileSdkVersion（在 build.gradle 中）
• com.android.tools.build:gradle 版本（在 build.gradle 中）
• lintOptions（在示例中）查看 issue

Execution failed for task ':app:lintVitalAppCenterRelease'

• build.gradle 脚本（在示例中）
• settings.gradle（在示例中）

jcenter退役

由于jcenter将于2021年5月1日退役，请替换为以下配置：

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

示例代码

以下是完整的示例代码，展示如何使用插件。

import 'package:flutter/material.dart';

import 'package:package_info_plus/package_info_plus.dart';
import 'package:flutter_appcenter_bundle_updated_to_null_safety/flutter_appcenter_bundle_updated_to_null_safety.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AppCenter.startAsync(
    appSecretAndroid: '49361c2e-b788-4bc2-a33d-838b04b3e06b',
    appSecretIOS: '2da3d93f-6b3f-48f9-920f-2d63ae3cd25a',
    enableDistribute: false,
  );
  await AppCenter.configureDistributeDebugAsync(enabled: false);

  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('插件示例应用'),
        ),
        body: Container(
          padding: EdgeInsets.all(20),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              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();
                },
              ),
              const SizedBox(height: 8.0),
              FutureBuilder(
                future: AppCenter.isDistributeEnabledAsync(),
                builder: (_, AsyncSnapshot<bool?> snapshot) {
                  if (snapshot.hasData) {
                    final isDistributeEnabled = snapshot.data!;

                    return Text('IsDistributeEnabled: $isDistributeEnabled');
                  }

                  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('应用名称:\n${packageInfo.appName}'),
              const SizedBox(height: 8.0),
              Text('包名:\n${packageInfo.packageName}'),
              const SizedBox(height: 8.0),
              Text('版本号:\n${packageInfo.version}'),
              const SizedBox(height: 8.0),
              Text('构建号:\n${packageInfo.buildNumber}'),
            ],
          );
        }

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