Flutter通知提醒插件flutter_siren的使用

Flutter通知提醒插件flutter_siren的使用

flutter_siren 是一个用于在Flutter应用中检查新版本并提示用户升级的插件。它支持iOS、Android和macOS平台，基于流行的 Siren 库开发。

一、安装

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

   dependencies:
     flutter_siren: ^latest-version
   

   请将 ^latest-version 替换为最新的版本号。

2. 安装依赖
   在命令行中运行以下命令来安装依赖：

   $ flutter pub get
   

二、基本用法

下面是一个简单的示例，展示了如何在按钮点击时检查应用更新并弹出提示框。

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

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

class VersionText extends StatelessWidget {
  final Future data;

  const VersionText(this.data, {Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          return Text(snapshot.data.toString());
        } else if (snapshot.hasError) {
          return Text(snapshot.error?.toString() ?? "Error");
        } else {
          return const Text('Loading...');
        }
      },
      future: data,
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    final siren = Siren();

    return MaterialApp(
      title: 'Flutter Siren Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter Siren Demo'),
        ),
        body: Builder(
          builder: (context) => Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: <Widget>[
                const Text(
                  '请更改iOS Bundle Identifier或Android Package命名空间为已发布到应用商店的应用，并按下按钮以显示更新对话框：',
                ),
                TextButton(
                  child: const Text('检查更新'),
                  onPressed: () => siren.promptUpdate(context),
                ),
                const Text('本地版本：'),
                VersionText(siren.localVersion),
                const Text('商店版本：'),
                VersionText(siren.storeVersion),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

三、自定义提示框

你可以通过传递参数来自定义提示框的内容。以下是可自定义的选项：

示例代码：

siren.promptUpdate(context, 
  title: "我的提示标题", 
  message: "兄弟，更新我的应用吧！", 
  buttonUpgradeText: "下载",  
  buttonCancelText: "不，谢谢",
  forceUpgrade: true
);

四、自定义更新提示逻辑

如果你想要完全自定义更新提示的逻辑，可以使用 updateIsAvailable 方法来检查是否有新版本可用。该方法返回一个布尔值，表示是否有新版本。

示例代码：

final siren = Siren();

FutureBuilder<bool>(
  future: siren.updateIsAvailable(),
  builder: (context, AsyncSnapshot<bool> snapshot){ 
    if (snapshot.hasData && snapshot.data == true) {
      return AlertDialog(
        title: Text("有新版本可用"),
        content: Text("是否要更新？"),
        actions: <Widget>[
          TextButton(
            child: Text("更新"),
            onPressed: () {
              // 处理更新逻辑
            },
          ),
          TextButton(
            child: Text("取消"),
            onPressed: () {
              Navigator.of(context).pop();
            },
          ),
        ],
      );
    } else if (snapshot.hasError) {
      return Text("检查更新失败");
    } else {
      return Text("正在检查更新...");
    }
  }
);

五、获取本地和商店版本

你可以使用 localVersion 和 storeVersion 获取应用的本地版本和商店中的最新版本。

示例代码：

final siren = Siren();

final local = siren.localVersion;  // 获取本地版本
final store = siren.storeVersion;  // 获取商店版本