Flutter应用升级插件kooboo_flutter_app_upgrade的使用

kooboo_flutter_app_upgrade

简介

kooboo_flutter_app_upgrade 是一个用于在 Flutter 应用中实现应用升级功能的插件。它支持 Android 平台上的应用内升级和 iOS 平台上跳转到 App Store。

安装

在 pubspec.yaml 文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  kooboo_flutter_app_upgrade: ^0.0.9

然后运行 flutter pub get 命令来获取依赖。

导入

在 Dart 文件中导入插件：

import 'package:flutter_app_upgrade/flutter_app_upgrade.dart';

使用

下载并安装 APK（仅适用于 Android）

使用 downloadApkInstall 方法下载并安装 APK 文件。

/// 下载并安装 APK (仅适用于 Android)
FlutterAppUpgrade.downloadApkInstall('url', '1.0.1');

监听下载进度

使用 onListenStreamData 方法监听下载进度。

/// 监听下载进度
FlutterAppUpgrade.onListenStreamData(
  (event) {
    if (event is Map && event.containsKey('progress')) {
      debugPrint('_MyAppState.initState progress ${event['progress'] * 100}');
    } else {
      debugPrint('_MyAppState.initState receive data $event');
    }
  },
  onError: (error) {
    debugPrint('_MyAppState.initState receive error ${error.message}');
  },
);

增量更新 APK（仅适用于 Android）

使用 patchInstallAppForAndroid 方法进行增量更新。

/// 增量更新 APK (仅适用于 Android)
String apkDownloadPath = await FlutterAppUpgrade.apkDownloadPath;
FlutterAppUpgrade.patchInstallAppForAndroid('$apkDownloadPath/app-V1.0_2.0.patch');

跳转应用市场（仅适用于 Android）

使用 goToMarket 方法跳转到应用市场。

/// 跳转应用市场 (仅适用于 Android)
FlutterAppUpgrade.goToMarket();

跳转 Google 应用市场（仅适用于 Android）

使用 goToGoogleMarket 方法跳转到 Google 应用市场。

/// 跳转 Google 应用市场 (仅适用于 Android)
FlutterAppUpgrade.goToGoogleMarket();

跳转 App Store（仅适用于 iOS）

使用 goToAppStore 方法跳转到 App Store。

/// 跳转 App Store (仅适用于 iOS)
FlutterAppUpgrade.goToAppStore('432274380');

示例代码

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

import 'package:flutter/material.dart';
import 'package:flutter_app_upgrade/flutter_app_upgrade.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    WidgetsBinding.instance?.addPostFrameCallback((timeStamp) {
      FlutterAppUpgrade.onListenStreamData(
        (event) {
          if (event is Map && event.containsKey('progress')) {
            debugPrint('_MyAppState.initState progress ${event['progress'] * 100}');
          } else {
            debugPrint('_MyAppState.initState receive data $event');
          }
        },
        onError: (error) {
          debugPrint('_MyAppState.initState receive error ${error.message}');
        },
      );
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Column(
          children: [
            TextButton(
              onPressed: () async {
                FlutterAppUpgrade.downloadApkInstall(
                  'url',
                  '1.0.1',
                );
              },
              child: const Text('下载并安装 APK (仅适用于 Android)'),
            ),
            const SizedBox(height: 10),
            TextButton(
              onPressed: () async {
                String apkDownloadPath = await FlutterAppUpgrade.apkDownloadPath;
                FlutterAppUpgrade.patchInstallAppForAndroid('$apkDownloadPath/app-V1.0_2.0.patch');
              },
              child: const Text('增量更新 APK (仅适用于 Android)'),
            ),
            const SizedBox(height: 10),
            TextButton(
              onPressed: () async {
                FlutterAppUpgrade.goToMarket();
              },
              child: const Text('跳转应用市场 (仅适用于 Android)'),
            ),
            const SizedBox(height: 10),
            TextButton(
              onPressed: () async {
                FlutterAppUpgrade.goToAppStore('432274380');
              },
              child: const Text('跳转 App Store (仅适用于 iOS)'),
            ),
            const SizedBox(height: 10),
          ],
        ),
      ),
    );
  }
}