Flutter插件siren的特性与使用方法

Siren

Siren 是一个简单的方式来监听并响应 Flutter Android 和 iOS 应用程序的版本更新。

Flutter插件siren的特性

版本号通常具有格式 x.y.z+b，其中 b 是小的错误修复更新。这个字符串形式的版本号由 Version 类处理。它还覆盖了相等性（通过简单比较版本字符串值）以及像 isHigherThan 和 isLowerThan 这样的方法来比较版本实例。

Version {
  final String version;
  late final int x;
  late final int y;
  late final int z;
  late final int bugfix;

  ...
}

真正的魔法发生在 Siren 类中。在你想要使用它的任何地方，只需创建一个实例（你不应该在 build 方法中这样做——DUH!）。然后你可以访问字段 getCurrentVersion(...) 和 getNewVersion(...)，或者通过调用 mapPolicy 函数并在那里处理每个更新案例。如果没有更新，mapPolicy 只会返回 null。每个回调都提供了一个 Future。

const siren = Siren();

siren.mapPolicy(
  onXUpdate: (openStore, oldV, newV) => showAlertDialog(...),
  onYUpdate: (openStore, _, __) => showAlertDialog(...),
  onZUpdate: (openStore, _, __) => showAlertDialog(...),
  onBugfixUpdate: (_, __, ___) {},
);

其他信息

我之前对类似插件的问题是，我希望为每个不同的情况显示自定义的小部件，并具有不同的功能。我正在寻找实现的策略是以下内容：

• 如果 x 部分更改 -> 废弃旧版本并强制用户更新！
• 如果 y 部分更改 -> 通知用户更新但给他们选择稍后更新的机会。
• 如果 z 部分更改 -> 不告诉用户。如果他们更新（或自动更新已激活），那就很好；否则我们只需要等待更大的更新。
• 如果 bugfix 部分更改 -> 同样适用于 z。

示例代码

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

import 'package:flutter/material.dart';
import 'package:siren/siren.dart'; // 引入 siren 插件

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

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

  // 这是你的应用程序的根小部件。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text('你已经按下了按钮次数：'),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }

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

    // 初始化 siren 插件
    const siren = Siren();

    // 定义更新策略
    siren.mapPolicy(
      onXUpdate: (openStore, oldV, newV) async {
        // x 部分更新，强制用户更新
        await showDialog(
          context: context,
          builder: (BuildContext context) {
            return AlertDialog(
              title: Text('重要更新'),
              content: Text('新版本 ${newV.version} 已发布，请立即更新！'),
              actions: [
                TextButton(
                  onPressed: () {
                    Navigator.pop(context);
                  },
                  child: Text('取消'),
                ),
                TextButton(
                  onPressed: () {
                    openStore(); // 打开应用商店
                    Navigator.pop(context);
                  },
                  child: Text('更新'),
                ),
              ],
            );
          },
        );
      },
      onYUpdate: (openStore, _, __) async {
        // y 部分更新，提示用户更新
        await showDialog(
          context: context,
          builder: (BuildContext context) {
            return AlertDialog(
              title: Text('更新可用'),
              content: Text('新版本已发布，是否现在更新？'),
              actions: [
                TextButton(
                  onPressed: () {
                    Navigator.pop(context);
                  },
                  child: Text('稍后'),
                ),
                TextButton(
                  onPressed: () {
                    openStore(); // 打开应用商店
                    Navigator.pop(context);
                  },
                  child: Text('更新'),
                ),
              ],
            );
          },
        );
      },
      onZUpdate: (openStore, _, __) {
        // z 部分更新，不提示用户
      },
      onBugfixUpdate: (_, __, ___) {
        // bugfix 部分更新，不提示用户
      },
    );
  }
}