Flutter应用更新管理插件zupdate的使用

Flutter应用更新管理插件zupdate的使用

zupdate 是一个用于Flutter应用更新管理的简单插件。在Android上，它会下载文件（并报告进度）并触发应用程序安装意图。在iOS上，它会打开Safari并指定IPA URL。

你可以参考以下项目：

https://github.com/hacjy/zupdate/tree/master/example

重要变更

• 提供了一套美观的UI更新。

• 提供了一个用于安装APK的Flutter插件install_plugin；对于iOS，通过URL跳转到应用商店。

• 必需设置：

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

     dependencies:
       get: ^4.6.5
       flutter_screenutil: ^5.5.3+2
       zupdate: ^0.4.0
     

  2. 在main.dart文件中，根节点需要使用以下代码：

     // 根结点要要使用ScreenUtilInit和getx的GetMaterialApp
     return ScreenUtilInit(
         designSize: const Size(1920, 1080),
         minTextAdapt: true,
         splitScreenMode: true,
         builder: (context, Widget? widget) {
           return GetMaterialApp(
             home: Scaffold(
               appBar: AppBar(
                 title: const Text('VersionUpdate Plugin App'),
               ),
               body: GestureDetector(
                 onTap: () {
                   UpdateVersion.appUpdate(context);
                 },
                 child: const Center(
                   child: SizedBox(
                     width: 100,
                     height: 100,
                     child: Text('Check Update'),
                   ),
                 ),
               ),
             ),
           );
         });
     

  3. 在pubspec.yaml文件中添加以下代码：

     assets:
       - assets/
       - assets/img/
     

     然后将update_bg_app_top.png 和 update_ic_close.png 添加到assets/img目录下。这些图片是从示例中的assets/img复制过来的。

• 支持自定义头部图片、按钮主题色、进度条颜色、标题、标题与头部图片的高度差、APK文件名以及是否显示中文文本：

  UpdateConfig(
       apkName: 'test.apk',
       title: 'test update version',
       themeColor: Colors.blueAccent,
       progressBackgroundColor: Colors.blue.withOpacity(0.3),
       extraHeight: 10,
       chLanguage: true)
  

使用方法

要在你的项目中使用此插件，请将其作为依赖项添加到pubspec.yaml文件中：

dependencies:
  zupdate: ^0.4.0

或者从GitHub集成：

dependencies:
  zupdate:
    git:
      url: git://github.com/hacjy/zupdate.git
      ref: master

预览

示例代码

// 导入包
import 'package:zupdate/version_xupdate/update/entity/update_entity.dart';
import 'package:zupdate/version_xupdate/update/flutter_update.dart';

// 版本更新
static Future<void> update(BuildContext context, Map<String, dynamic> appInfo) async {
  try {
    final url = appInfo['update_url'];
    UpdateEntity entity = UpdateEntity(
        isForce: appInfo['update_type'] == 1,
        hasUpdate: true,
        isIgnorable: false,
        versionCode: appInfo['version_code'],
        versionName: appInfo['version_name'],
        updateContent: appInfo['update_content'],
        apkMd5: appInfo['app_md5'] ?? '',
        // apkSize: appInfo['package_size'],
        downloadUrl: appInfo['update_url']);
    UpdateManager.checkUpdate(context, entity,
        // 支持自定义头部图片，按钮主题色，进度条颜色，标题,标题距离头部图片的高度,apk文件名,是否显示中文文本
        // config: UpdateConfig(
            // apkName: 'test.apk',
            // title: 'test update version',
            // themeColor: Colors.blueAccent,
            // progressBackgroundColor: Colors.blue.withOpacity(0.3),
            // extraHeight: 10,
            // chLanguage: true)
    );
  } catch (e) {
    print(e);
  }
}

安装插件示例

// 导入包
import 'package:zupdate/install_plugin.dart';

// 安装APK
static void installAPP(String uri) async {
  if (Platform.isAndroid) {
    String packageName = await CommonUtils.getPackageName();
    InstallPlugin.installApk(uri, packageName);
  } else {
    InstallPlugin.gotoAppStore(uri);
  }
}

完整示例代码

import 'package:flutter/material.dart';
import 'package:flutter_screenutil/flutter_screenutil.dart';
import 'package:get/get.dart';
import 'package:zupdate_example/update_version.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();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 根结点要要使用ScreenUtilInit和getx的GetMaterialApp
    return ScreenUtilInit(
        designSize: const Size(1920, 1080),
        minTextAdapt: true,
        splitScreenMode: true,
        builder: (context, Widget? widget) {
          return GetMaterialApp(
            home: Scaffold(
              appBar: AppBar(
                title: const Text('Zupdate Plugin Example'),
              ),
              body: Center(child: ElevatedButton(
                onPressed: () {
                  UpdateVersion.appUpdate(context);
                },
                child: Text('Check Update'),
              ),)
            ),
          );
        });
  }
}