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

native_updater 是一个 Flutter 插件，用于在检测到最新版本时通过原生对话框提示用户更新应用。无论是应用商店版本还是用户自定义版本，都可以使用此插件进行更新提示。

安装

通过 GitHub 安装（仅限测试）

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

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^0.1.3

  # Add this inside pubspec.yaml
  native_updater:
    git: https://github.com/loadsmileau/native_updater

设置

Android

无需额外设置，直接使用即可。

iOS

为了在 Cupertino Alert Dialog 中显示应用名称，需要在 <project root>/ios/Runner/Info.plist 文件中添加以下键值对：

<key>CFBundleDisplayName</key>
<string>YOUR APP NAME</string>

使用

只需在需要显示更新提示的地方添加以下代码，插件会处理其余部分：

NativeUpdater.displayUpdateAlert(
  context,
  forceUpdate: true,
);

或者使用可选参数来自定义提示：

NativeUpdater.displayUpdateAlert(
  context,
  forceUpdate: true,
  appStoreUrl: '<Your App Store URL>',
  playStoreUrl: '<Your Play Store URL>',
  iOSDescription: '<Your iOS Description>',
  iOSUpdateButtonLabel: '<Your iOS Update Button Label>',
  iOSCloseButtonLabel: '<Your iOS Close Button Label>',
  iOSIgnoreButtonLabel: '<Your iOS Ignore Button Label>',
  iOSAlertTitle: '<Your Dialog Title>',
);

参数说明

必填参数

• context：构建此小部件的位置。
• forceUpdate：是否强制更新。设置为 true 表示强制更新，设置为 false 表示允许用户稍后更新。

可选参数

• appStoreUrl：iOS 应用商店 URL，用于启动应用商店页面。参考 如何查找应用商店 URL。
• playStoreUrl：Google Play 商店 URL，用于启动 Play 商店页面。参考 如何查找应用商店 URL。
• iOSDescription：自定义 UpdateCupertinoAlert 的提示描述。默认值为 "<App Name> requires that you update to the latest version. You cannot use this app until it is updated." 或 "<App Name> recommends that you update to the latest version. You can keep using this app while downloading the update."。
• iOSUpdateButtonLabel：自定义 UpdateCupertinoAlert 的更新按钮标签。默认值为 "Update"。
• iOSCloseButtonLabel：自定义 UpdateCupertinoAlert 的关闭按钮标签。默认值为 "Close App"。
• iOSIgnoreButtonLabel：自定义 UpdateCupertinoAlert 的忽略按钮标签。默认值为 "Later"。
• iOSAlertTitle：自定义 UpdateCupertinoAlert 的对话框标题。默认值为 "Update Available"。

完整示例

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

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'native_updater example',
      home: Home(),
    );
  }
}

class Home extends StatefulWidget {
  @override
  _HomeState createState() => _HomeState();
}

class _HomeState extends State<Home> {
  @override
  void initState() {
    super.initState();
    checkVersion();
  }

  Future<void> checkVersion() async {
    /// 假设从 HTTP 请求响应中获取的状态码为 412
    /// 状态码 412 要求强制更新
    int statusCode = 412;

    /// 本地版本号
    int localVersion = 9;

    /// 服务器上的最新版本号
    int serverLatestVersion = 10;

    Future.delayed(Duration.zero, () {
      if (statusCode == 412) {
        NativeUpdater.displayUpdateAlert(
          context,
          forceUpdate: true,
          appStoreUrl: '<Your App Store URL>',
          playStoreUrl: '<Your Play Store URL>',
          iOSDescription: '<Your iOS description>',
          iOSUpdateButtonLabel: 'Upgrade',
          iOSCloseButtonLabel: 'Exit',
          errorText: "Error",
          errorCloseButtonLabel: "Close",
          errorSubtitle: "This version of the app isn't legit"
        );
      } else if (serverLatestVersion > localVersion) {
        NativeUpdater.displayUpdateAlert(
          context,
          forceUpdate: false,
          appStoreUrl: '<Your App Store URL>',
          playStoreUrl: '<Your Play Store URL>',
          iOSDescription: '<Your description>',
          iOSUpdateButtonLabel: 'Upgrade',
          iOSIgnoreButtonLabel: 'Next Time',
        );
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Your App'),
      ),
      body: Center(
        child: Text('Testing...'),
      ),
    );
  }
}

材料设计提示截图

灵活更新流程示例

即时更新流程示例

Cupertion 提示截图

强制更新	可稍后更新

希望这些信息对你有所帮助！如果有任何问题或需要进一步的帮助，请随时提问。