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

简介

mo_app_update 是一个由 Moberan 开发的用于 Flutter 应用更新检查的插件。它可以帮助开发者轻松地在 Android 和 iOS 上实现应用更新功能。

使用步骤

Android 自更新

1. 添加 info.json 和 APK 文件到公共域

首先，你需要在服务器上放置一个 info.json 文件，该文件包含了应用版本信息及下载链接。以下是一个示例 info.json 文件：

{
    "android": {
        "2": {
            "downloadUrl": "https://some.apk",
            "versionString": "0.0.2",
            "priority": "2",
            "changelog": {
            "ko-kr": "테스트",
            "en-us": "Test"
            }
        },
        "1": {
            "downloadUrl": "...",
            "versionString": "0.0.1",
            "priority": "0",
            "changelog": {
            "ko-kr": "최초 버전",
            "en-us": "Init version"
            }
        }
    }
}

确保将 downloadUrl 替换为实际的 APK 文件的下载链接。

2. 在项目中添加依赖

在你的 pubspec.yaml 文件中添加 mo_app_update 插件：

flutter pub add mo_app_update

3. 编写 Flutter 代码

在 Flutter 代码中初始化插件，并调用相关方法来检查和处理应用更新。

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

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

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

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

class _MyAppState extends State<MyApp> {
  MoAppUpdate? _moAppUpdatePlugin;

  Future<void> init() async {
    _moAppUpdatePlugin = await MoAppUpdate.initialize(
      mode: MoAppUpdateMode.self,
      selfOption: MoAppUpdateSelfOption(
        infoUrl: 'https://minio.moberan.com/moappupdate/android/info.json',
      ),
    );

    setState(() {});
  }

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

  Future<void> showSimpleDialog({
    required String message,
    List<String> buttons = const ['OK'],
  }) async {
    await showDialog(
      context: context,
      builder: (context) => AlertDialog(
        title: Text(message),
        actions: buttons.map((e) => TextButton(
          onPressed: () {
            Navigator.pop(context, e);
          },
          child: Text(e),
        )).toList(),
      ),
    );
  }

  Future<void> onCheckUpdate() async {
    var info = await _moAppUpdatePlugin?.getUpdateInfo();
    setState(() {});

    if (info == null || info.hasUpdate == false) {
      await showSimpleDialog(
        message: '无更新',
        buttons: ['OK'],
      );
      return;
    }

    var res = await showSimpleDialog(
      message: '有新版本 ${info.newVersionString} 可用',
      buttons: ['忽略', '更新'],
    );

    if (res != '更新') {
      return;
    }

    try {
      showDialog(
        context: context,
        barrierDismissible: false,
        builder: (context) => const Dialog(
          child: Center(
            child: CircularProgressIndicator(),
          ),
        ),
      );

      var res = await _moAppUpdatePlugin?.procedureUpdate(info);
      Navigator.pop(context);
    } catch (e) {
      showSimpleDialog(
        message: e.toString(),
        buttons: ['OK'],
      );
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('插件示例应用'),
      ),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text('当前版本: ${_moAppUpdatePlugin?.updateInfo?.currentVersionString ?? ''}'),
            Text('新版本: ${_moAppUpdatePlugin?.updateInfo?.newVersionString ?? ''}'),
            Text('更新状态: ${_moAppUpdatePlugin?.updateInfo?.hasUpdate == true ? '存在' : '不存在'}'),
            ElevatedButton(
              child: const Text('检查更新'),
              onPressed: onCheckUpdate,
            ),
            ElevatedButton(
              child: const Text('清除更新信息'),
              onPressed: () {
                _moAppUpdatePlugin?.clearUpdateInfo();
                setState(() {});
              },
            ),
          ],
        ),
      ),
    );
  }
}