Flutter应用更新提示插件update_modal的使用

概述

update_modal 是一个基于 Bugly 风格的应用更新提示插件，适用于 Flutter 应用。它支持跨平台，并且可以通过简单的配置实现应用更新提示功能。

特点：

• 支持检查更新、下载更新包、安装更新包。
• 提供模态框样式更新提示，用户可以选择立即安装或稍后处理。
• 跨平台兼容性良好。

示例项目地址： example/

开始使用

1. 安装依赖

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

dependencies:
  update_modal: ^0.0.3

运行以下命令以更新依赖：

flutter pub get

2. 实现检查器、下载器和安装器

创建一个类实现 UpdateModalService 接口，用于定义更新逻辑。

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

// 更新信息类
class UpdateInfo {
  String name;
  String version;
  String size;
  String releasedAt;
  String description;

  UpdateInfo({
    required this.name,
    required this.version,
    required this.size,
    required this.releasedAt,
    required this.description,
  });
}

// 更新服务接口
abstract class UpdateModalService {
  Future<int> cancelDownload(); // 取消下载
  Future<UpdateInfo?> checkUpdate(); // 检查更新
  Future<int> dismiss(); // 清理状态
  Future<int> install(); // 安装更新包
  Future<Stream<int>> startDownload(); // 开始下载
}

// 自定义更新服务
class MyUpdateService implements UpdateModalService {
  @override
  Future<int> cancelDownload() {
    // 模拟取消下载操作
    print("Cancel Download");
    return Future.value(0);
  }

  @override
  Future<UpdateInfo?> checkUpdate() async {
    // 模拟检查更新操作
    await Future.delayed(Duration(seconds: 2)); // 延迟2秒模拟网络请求
    return UpdateInfo(
      name: "ExampleUpdaterApp",
      version: "3.2.0",
      size: "13.6M",
      releasedAt: "2022-10-26 22:20:01",
      description: "升级描述：修复了一些问题并优化了性能。",
    );
  }

  @override
  Future<int> dismiss() {
    // 清理状态
    print("Dismiss Update Modal");
    return Future.value(0);
  }

  @override
  Future<int> install() {
    // 模拟安装更新包
    print("Install Update Package");
    return Future.value(0);
  }

  @override
  Future<Stream<int>> startDownload() {
    // 模拟下载进度流
    return Future.value(Stream.fromFutures([
      Future.delayed(Duration(milliseconds: 150 * 1), () => 20),
      Future.delayed(Duration(milliseconds: 150 * 2), () => 40),
      Future.delayed(Duration(milliseconds: 150 * 3), () => 60),
      Future.delayed(Duration(milliseconds: 150 * 4), () => 80),
      Future.delayed(Duration(milliseconds: 150 * 5), () => 100),
      // 当进度 > 100时，弹出更新模态框
      Future.delayed(Duration(milliseconds: 150 * 6), () => 120),
    ]));
  }
}

3. 在应用启动时执行更新检查

在应用启动时初始化 UpdateModal，并绑定自定义的服务实现。

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

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

class MyApp extends StatefulWidget {
  @override
  createState() => _MyApp();
}

class _MyApp extends State<MyApp> {
  @override
  void initState() {
    super.initState();

    // 初始化更新模态框
    WidgetsBinding.instance.addPostFrameCallback((_) {
      UpdateModal.init(
        context!,
        service: MyUpdateService(), // 使用自定义服务
      );
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("Update Modal Example"),
        ),
        body: Center(
          child: Text("欢迎使用更新提示插件！"),
        ),
      ),
    );
  }
}

调试

如果需要调试跨平台的模态框效果，可以运行以下命令打开 Web 服务器：

cd example
flutter run -d web-server --web-port=8080