Flutter应用内更新插件huawei_in_app_update的使用

Flutter应用内更新插件huawei_in_app_update的使用

插件简介

huawei_in_app_update 是一个Flutter插件，它使用华为官方的App Update API从AppGallery检查应用更新。请注意，此插件仅适用于Android平台。

前提条件

在运行项目之前，您必须将应用程序的AppGallery Connect配置文件添加到项目中。

使用方法

调用 HuaweiInAppUpdate.checkForUpdate() 将返回 UpgradeInfo 对象。您可以使用 upgradeInfo.updateAvailable 来检查是否有可用的更新。如果有更新可用，您可以使用 HuaweiInAppUpdate.showUpdateDialog() 显示更新对话框。如果将 force 参数设置为 true，则对话框将不可关闭，并且返回按钮也不会关闭对话框。

void checkForUpdate() async {
  if (Platform.isAndroid) {
    try {
      final upgradeInfo = await HuaweiInAppUpdate.checkForUpdate();
      if (upgradeInfo.updateAvailable) {
        // 显示更新对话框，force为false表示用户可以取消更新
        HuaweiInAppUpdate.showUpdateDialog(
          context: context,
          force: false,
        );
      } else {
        // 如果没有更新，显示提示信息
        await showDialog(
          context: context,
          builder: (_) {
            return AlertDialog(
              content: Text('No new update available'),
              actions: [
                TextButton(
                  onPressed: () {
                    Navigator.of(context).pop();
                  },
                  child: Text('Okay'),
                ),
              ],
            );
          },
        );
      }
    } on PlatformException catch (e) {
      // 捕获平台异常并显示错误信息
      showErrorDialog(e.code, e.message);
    }
  } else {
    // iOS设备不支持此功能
    showErrorDialog('IOS_NOT_SUPPORTED', 'iOS device is not supported');
  }
}

如果您希望在应用中使用不同的更新提示样式，可以使用 UpgradeInfo 中提供的信息创建自定义的小部件设计。

完整示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用 huawei_in_app_update 插件来检查和提示应用更新。

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:huawei_in_app_update/huawei_in_app_update.dart';

void main() {
  runApp(MyApp());
}

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

class _MyAppState extends State<MyApp> {
  final _navigatorKey = GlobalKey<NavigatorState>();

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  void checkForUpdate() async {
    final context = _navigatorKey.currentState?.context ?? this.context;
    if (Platform.isAndroid) {
      try {
        final upgradeInfo = await HuaweiInAppUpdate.checkForUpdate();
        if (upgradeInfo.updateAvailable) {
          // 显示更新对话框，force为false表示用户可以取消更新
          HuaweiInAppUpdate.showUpdateDialog(
            context: context,
            force: false,
          );
        } else {
          // 如果没有更新，显示提示信息
          await showDialog(
            context: context,
            builder: (_) {
              return AlertDialog(
                content: Text('No new update available'),
                actions: [
                  TextButton(
                    onPressed: () {
                      Navigator.of(context).pop();
                    },
                    child: Text('Okay'),
                  ),
                ],
              );
            },
          );
        }
      } on PlatformException catch (e) {
        // 捕获平台异常并显示错误信息
        showErrorDialog(e.code, e.message);
      }
    } else {
      // iOS设备不支持此功能
      showErrorDialog('IOS_NOT_SUPPORTED', 'iOS device is not supported');
    }
  }

  void showErrorDialog(String title, String? message) {
    final context = _navigatorKey.currentState?.context ?? this.context;
    showDialog(
      context: context,
      builder: (context) {
        return AlertDialog(
          title: Text(title),
          content: Text(message ?? 'Error'),
          actions: [
            TextButton(
              onPressed: () => Navigator.of(context).pop(),
              child: Text('OK'),
            ),
          ],
        );
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: _navigatorKey,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Huawei App Update Plugin'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () => checkForUpdate(),
            child: Text('Check Update'),
          ),
        ),
      ),
    );
  }
}