Flutter应用升级管理插件app_upgrader_flutter的使用

发布于 1周前 作者 ionicwang 来自 Flutter

Flutter应用升级管理插件app_upgrader_flutter的使用

App Upgrader Flutter

  • 功能介绍：当用户设备上存在更新版本时，App Upgrader Flutter会显示一个简单的的通知弹窗或卡片提示用户进行升级。
  • 平台支持：
    • Android: 支持自动升级和Appcast推送。
    • iOS: 支持自动升级和Appcast推送。
    • Linux: 不支持自动升级，但支持Appcast推送。
    • MacOS: 不支持自动升级，但支持Appcast推送。
    • Web: 不支持自动升级，但支持Appcast推送。
    • Windows: 不支持自动升级，但支持Appcast推送。

Widgets

  • Alert Widget：用于显示弹窗通知，包含三个按钮：忽略、稍后、立即更新。
  • Card Widget：用于显示卡片样式通知，宽度和高度为0.0，表示没有更新时不可见。

示例代码

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'App Upgrader Flutter Example',
      home: Scaffold(
        appBar: AppBar(title: Text('App Upgrader Flutter Example')),
        body: AppUpgradeAlert(
          child: Center(child: Text('Checking...')),
        ),
      ),
    );
  }
}

截图示例

  • Alert Example

  • Custom Alert Example

  • Cupertino Alert Example

  • Card Example

自定义化

  • 可以通过扩展 UpgraderMessages 类来自定义显示的字符串。
  • 例如，替换忽略按钮的文本为自定义值：
class MyUpgraderMessages extends UpgraderMessages {
  [@override](/user/override)
  String get buttonTitleIgnore => 'My Ignore';
}

AppUpgradeAlert(Upgrader(messages: MyUpgraderMessages());

语言本地化

  • 插件已经支持34种语言的本地化，并且未来将支持更多语言。
  • 例如，添加西班牙语（es）的语言支持：
class MySpanishMessages extends UpgraderMessages {
  /// Override the message function to provide custom language localization.
  [@override](/user/override)
  String message(UpgraderMessage messageKey) {
    if (languageCode == 'es') {
      switch (messageKey) {
        case UpgraderMessage.body:
          return 'es A new version of {{appName}} is available!';
        case UpgraderMessage.buttonTitleIgnore:
          return 'es Ignore';
        case UpgraderMessage.buttonTitleLater:
          return 'es Later';
        case UpgrderMessage.buttonTitleUpdate:
          return 'es Update Now';
        case UpgrderMessage.prompt:
          return 'es Want to update?';
        case UpgrderMessage.releaseNotes:
          return 'es Release Notes';
        case UpgrderMessage.title:
          return 'es Update App?';
      }
    }
    // Messages that are not provided above can still use the default values.
    return super.message(messageKey);
  }
}

AppUpgradeAlert(Upgrader(messages: MySpanishMessages()));

更多关于Flutter应用升级管理插件app_upgrader_flutter的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter应用升级管理插件app_upgrader_flutter的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter应用中使用app_upgrader_flutter插件进行应用升级管理的示例代码。

首先，确保你已经在pubspec.yaml文件中添加了app_upgrader_flutter依赖：

dependencies:
  flutter:
    sdk: flutter
  app_upgrader_flutter: ^latest_version  # 请替换为最新版本号

然后，运行flutter pub get来安装依赖。

接下来，在你的Flutter应用中，你可以按照以下步骤实现应用升级管理功能：

  1. 导入必要的包：
import 'package:flutter/material.dart';
import 'package:app_upgrader_flutter/app_upgrader_flutter.dart';
  1. 配置升级管理器：

你需要提供一个用于检查新版本信息的URL（通常是你的服务器上的一个JSON文件或API端点）。以下是一个基本的配置示例：

final AppUpgrader appUpgrader = AppUpgrader(
  androidAppId: "your.android.package.name",
  iosAppId: "your.ios.bundle.id",
  packageInfo: PackageInfo.fromPlatform(), // 获取当前应用的包信息
  url: "https://yourserver.com/app-version.json", // 你的版本信息URL
  supportedPlatforms: [
    TargetPlatform.android,
    TargetPlatform.iOS,
  ],
  showReleaseNotesDialog: true, // 是否显示更新说明对话框
  mandatoryUpdate: false, // 是否强制更新
  alertStyle: UpgradeAlertStyle(
    titleTextStyle: TextStyle(fontSize: 20, color: Colors.black),
    messageTextStyle: TextStyle(fontSize: 16, color: Colors.black54),
    buttonTextStyle: TextStyle(fontSize: 16, color: Colors.white),
    closeButtonStyle: TextStyle(fontSize: 16, color: Colors.grey),
    backgroundColor: Colors.white,
    accentColor: Colors.blue,
    closeButtonColor: Colors.grey,
  ),
);

注意：PackageInfo.fromPlatform()需要在initState中异步获取，因此你需要将这部分逻辑放在异步函数中。

  1. 在应用启动时检查更新：

在你的主页面或合适的生命周期方法中，调用appUpgrader.checkVersion()来检查是否有新版本。

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('App Upgrader Example'),
        ),
        body: MyHomePage(),
      ),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  void initState() {
    super.initState();
    _checkForUpdates();
  }

  Future<void> _checkForUpdates() async {
    PackageInfo packageInfo = await PackageInfo.fromPlatform();
    final AppUpgrader appUpgrader = AppUpgrader(
      androidAppId: "your.android.package.name",
      iosAppId: "your.ios.bundle.id",
      packageInfo: packageInfo,
      url: "https://yourserver.com/app-version.json",
      supportedPlatforms: [
        TargetPlatform.android,
        TargetPlatform.iOS,
      ],
      // 其他配置...
    );

    appUpgrader.checkVersion().then((versionStatus) {
      if (versionStatus == VersionStatus.updateAvailable) {
        appUpgrader.showUpgradeDialog(context);
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Text('Checking for updates...'),
    );
  }
}
  1. 服务器端版本信息JSON示例：

你的服务器上的版本信息JSON文件应该类似于以下内容：

{
  "android": {
    "versionCode": 2,
    "versionName": "1.1.0",
    "url": "https://yourserver.com/app-release.apk",
    "releaseNotes": "This is a mandatory update with new features and bug fixes."
  },
  "ios": {
    "version": "1.1.0",
    "url": "https://apps.apple.com/us/app/your-app-id/id123456789",
    "releaseNotes": "This is a mandatory update with new features and bug fixes."
  }
}

以上代码展示了如何在Flutter应用中使用app_upgrader_flutter插件来管理应用升级。请确保替换示例代码中的占位符（如your.android.package.name、your.ios.bundle.id和https://yourserver.com/app-version.json）为你的实际信息。

回到顶部