Flutter应用版本升级插件flutter_mobile_upgrader的使用

安装

1. 在 pubspec.yaml 中添加插件依赖：

dependencies:
  flutter_mobile_upgrader: ^1.0.7

1. 在命令行中运行以下命令以获取依赖：

flutter pub get

使用

Android

1. 在 android/app/src/main/AndroidManifest.xml 中添加 provider：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  package="com.xxxx.xxxxx"
>
  <application>
    ...
    <provider
      android:name="androidx.core.content.FileProvider"
      android:authorities="${applicationId}.fileprovider"
      android:grantUriPermissions="true"
      android:exported="false"
    >
      <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths"
      />
    </provider>
  </application>
</manifest>

1. 新增 android/app/src/main/res/xml/file_paths.xml 文件：

<paths>
  <external-path
    name="external-path"
    path="."
  />

  <external-cache-path
    name="external-cache-path"
    path="."
  />

  <external-files-path
    name="external-files-path"
    path="."
  />

  <files-path
    name="files_path"
    path="."
  />

  <cache-path
    name="cache-path"
    path="."
  />

  <root-path
    name="name"
    path="."
  />
</paths>

1. 点击升级前往应用商店：

// 一般通过远程接口调用获取
final Future<AppUpgradeInfo> appUpgradeInfo = Future.value(
  AppUpgradeInfo(
    title: '更新提示',
    contents: ['有新版本哟,请更新～', '修复了设备定位bug', '优化认证操作体验'],
    force: true, // 是否强制升级
  ),
);

// 获取已上架的应用市场, 根据应用包名，例如: 'com.flutter.app'
final appMarketInfos = AppMarketManager.getAppMarketList(
  await FlutterUpgradeChanneler.getInstallMarket(['com.flutter.app']),
);

// 升级应用 API
AppUpgradeManager.upgrade(
  context, // BuildContext
  appUpgradeInfo,
  appMarketInfo: appMarketInfos[0],
  onCancel: () {},
  onOk: () {},
);

1. 从指定的 URL 下载 APK：

// 一般通过远程接口调用获取
final Future<AppUpgradeInfo> appUpgradeInfo = Future.value(
  AppUpgradeInfo(
    title: '更新提示',
    contents: ['有新版本哟,请更新～', '修复了设备定位bug', '优化认证操作体验'],
    force: true, // 是否强制升级
  ),
);

// 升级应用 API
AppUpgradeManager.upgrade(
  context, // BuildContext
  appUpgradeInfo,
  apkDownloadUrl: 'http://xxx.xxx.com/upgrade.apk',
  onCancel: () {},
  onOk: () {},
);

iOS

1. 点击升级前往应用商店：

// 一般通过远程接口调用获取
final Future<AppUpgradeInfo> appUpgradeInfo = Future.value(
  AppUpgradeInfo(
    title: '更新提示',
    contents: ['有新版本哟,请更新～', '修复了设备定位bug', '优化认证操作体验'],
    force: true, // 是否强制升级
  ),
);

// 升级应用 API
AppUpgradeManager.upgrade(
  context, // BuildContext
  appUpgradeInfo,
  iosAppId: 'xxxxxxxx', // iOS App ID
  onCancel: () {},
  onOk: () {},
);

示例代码

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:flutter_mobile_upgrader/flutter_mobile_upgrader.dart';

void main() {
  runApp(MaterialApp(home: MyApp()));
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter Upgrader Plugin'),
        ),
        body: Padding(
          padding: const EdgeInsets.only(top: 28.0),
          child: Row(
            children: [
              Expanded(
                child: ElevatedButton(
                  style: ElevatedButtonTheme.of(context).style,
                  child: const Padding(
                    padding: EdgeInsets.all(12.0),
                    child: Text(
                      '升 级',
                      style: TextStyle(fontSize: 18),
                    ),
                  ),
                  onPressed: () {
                    final Future<AppUpgradeInfo> appUpgradeInfo = Future.value(
                      AppUpgradeInfo(
                          title: '更新提示',
                          contents: ['有新版本哟,请更新～'],
                          force: false,
                          apkDownloadUrl: ''),
                    );

                    if (Platform.isAndroid) {
                      AppUpgradeManager.upgrade(
                        context,
                        appUpgradeInfo,
                      );
                    }

                    if (Platform.isIOS) {
                      AppUpgradeManager.upgrade(
                        context,
                        appUpgradeInfo,
                        iosAppId: 'idxxxxxx',
                      );
                    }
                  },
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}