Flutter版本升级插件flutter_upgrade_version的使用

Flutter Upgrade Version Package

Flutter Upgrade Version 是一个用于 Android 和 iOS 的 Flutter 插件，允许获取应用包信息和版本信息。

功能特性

• 获取包信息（应用名称、包名、版本号、构建号）
• 获取应用商店中的版本信息（Apple Store）
• 支持Android应用内更新

安装

首先，在 pubspec.yaml 文件中添加 flutter_upgrade_version 作为依赖项。

dependencies:
  flutter_upgrade_version: ^1.1.7

应用内更新

应用内更新功能适用于运行 Android 5.0（API 级别 21）或更高版本的设备。此外，应用内更新仅支持 Android 移动设备、Android 平板电脑和 ChromeOS 设备。如何测试应用内更新

更新流程

灵活更新流程

即时更新流程

使用方法

包信息

你可以使用 PackageManager 来获取包信息。

import 'package:flutter_upgrade_version/flutter_upgrade_version.dart';

Future<void> getPackageData() async {
  PackageInfo _packageInfo = await PackageManager.getPackageInfo();
}

PackageInfo 类包含以下字段：

• appName : 应用名称
• packageName : 包名
• version : 版本号
• buildNumber : 构建号
• languageCode : 语言代码
• regionCode : 国家/地区代码

Android应用内更新

/// Android
if (Platform.isAndroid) {
  InAppUpdateManager manager = InAppUpdateManager();
  AppUpdateInfo? appUpdateInfo = await manager.checkForUpdate();
  if (appUpdateInfo == null) return; // 异常处理
  if (appUpdateInfo.updateAvailability == UpdateAvailability.developerTriggeredUpdateInProgress) {
    /// 如果应用内更新正在进行，则继续更新
    String? message = await manager.startAnUpdate(type: AppUpdateType.immediate);
    /// 成功时message为null 
  } else if (appUpdateInfo.updateAvailability == UpdateAvailability.updateAvailable) {
    /// 有可用更新
    if (appUpdateInfo.immediateAllowed) {
      debugPrint('开始即时更新');
      String? message = await manager.startAnUpdate(type: AppUpdateType.immediate);
      /// 成功时message为null 
    } else if (appUpdateInfo.flexibleAllowed) {
      debugPrint('开始灵活更新');
      String? message = await manager.startAnUpdate(type: AppUpdateType.flexible);
      /// 成功时message为null
    } else {
      debugPrint('有可用更新。不支持即时和灵活更新流程');
    }
  }
}

iOS应用商店版本信息

我们通过 package_name 和 regionCode 获取 Apple Store 中的应用信息。

/// iOS
if (Platform.isIOS) {
  VersionInfo? _versionInfo = await UpgradeVersion.getiOSStoreVersion(
    packageInfo: _packageInfo, 
    regionCode: 'VN',
  );
  /// 示例：VN - 越南
}

VersionInfo 类包含以下信息：

• canUpdate: 是否可以更新
• isReviewing: 是否正在审核
• localVersion: 当前版本
• storeVersion: 应用商店中的版本
• releaseDate: 发布日期
• appStoreLink: 应用商店链接
• releaseNotes: 发行说明

应用内更新消息

注意：startAnUpdate() 返回一个字符串（通知消息）。当更新成功时，消息为 nullable。

示例代码

下面是一个完整的示例代码，演示了如何使用 flutter_upgrade_version 插件：

import 'dart:io';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:flutter_upgrade_version/flutter_upgrade_version.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  PackageInfo _packageInfo = PackageInfo();

  @override
  void initState() {
    super.initState();
    getPackageData();
  }

  Future<void> getPackageData() async {
    if (!mounted) return;
    _packageInfo = await PackageManager.getPackageInfo();
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: SizedBox(
          width: double.infinity,
          child: SingleChildScrollView(
            physics: const ClampingScrollPhysics(),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.center,
              children: [
                const SizedBox(height: 20),
                Text(
                  'Version: ${_packageInfo.toJson()}',
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 20),
                ElevatedButton(
                  onPressed: () async {
                    if (Platform.isAndroid) {
                      InAppUpdateManager manager = InAppUpdateManager();
                      AppUpdateInfo? appUpdateInfo = await manager.checkForUpdate();
                      if (appUpdateInfo == null) return;
                      if (appUpdateInfo.updateAvailability == UpdateAvailability.developerTriggeredUpdateInProgress) {
                        String? message = await manager.startAnUpdate(type: AppUpdateType.immediate);
                        debugPrint(message ?? '');
                      } else if (appUpdateInfo.updateAvailability == UpdateAvailability.updateAvailable) {
                        if (appUpdateInfo.immediateAllowed) {
                          String? message = await manager.startAnUpdate(type: AppUpdateType.immediate);
                          debugPrint(message ?? '');
                        } else if (appUpdateInfo.flexibleAllowed) {
                          String? message = await manager.startAnUpdate(type: AppUpdateType.flexible);
                          debugPrint(message ?? '');
                        } else {
                          debugPrint('Update available. Immediate & Flexible Update Flow not allow');
                        }
                      }
                    } else if (Platform.isIOS) {
                      VersionInfo? _versionInfo = await UpgradeVersion.getiOSStoreVersion(
                          packageInfo: _packageInfo, regionCode: "US");
                      debugPrint(_versionInfo.toJson().toString());
                    }
                  },
                  child: const Text('Check Update'),
                ),
                const SizedBox(height: 20),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

以上代码展示了如何在Flutter项目中集成并使用 flutter_upgrade_version 插件来检查应用版本更新，并根据平台的不同执行相应的操作。