Flutter应用更新插件app_updater的使用

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

Flutter应用更新插件 app_updater 的使用

app_updater 是一个用于检查应用程序更新并在需要时提示用户更新的Flutter插件。它支持iOS和Android平台,并且可以自定义对话框来展示更新信息。

安装

在你的项目中的 pubspec.yaml 文件中添加以下依赖:

dependencies:
  app_updater: ^1.0.6

然后运行 flutter pub get 来安装该插件。

使用方法

首先,在你的Dart文件中导入 app_updater

import 'package:app_updater/app_updater.dart';

接下来,你可以在代码中使用 checkAppUpdate 函数来检查更新。

默认用法

默认情况下,你可以简单地调用 checkAppUpdate 函数来检查更新并显示默认的更新对话框:

checkAppUpdate(
    context,
    appName: 'Example App',
    iosAppId: '123456789',
    androidAppBundleId: 'com.example.app',
);

注意:在iOS模拟器上,checkAppUpdate 函数不会显示任何对话框,因为模拟器没有安装App Store。

自定义用法

如果你希望自定义对话框的内容,可以通过传递更多的参数来实现:

checkAppUpdate(
    context,
    appName: 'Example App',
    iosAppId: '123456789',
    androidAppBundleId: 'com.example.app',
    isDismissible: true,
    customDialog: true,
    customAndroidDialog: AlertDialog(
        title: const Text('Update Available'),
        content: const Text('Please update the app to continue'),
        actions: [
        TextButton(
            onPressed: () {
            Navigator.pop(context);
            },
            child: const Text('Cancel'),
        ),
        TextButton(
            onPressed: () {
            OpenStore.instance.open(
                androidAppBundleId: 'com.example.app',
            );
            Navigator.pop(context);
            },
            child: const Text('Update'),
        ),
        ],
    ),
    customIOSDialog: CupertinoAlertDialog(
        title: const Text('Update Available'),
        content: const Text('Please update the app to continue'),
        actions: [
        CupertinoDialogAction(
            onPressed: () {
            Navigator.pop(context);
            },
            child: const Text('Cancel'),
        ),
        CupertinoDialogAction(
            onPressed: () {
            OpenStore.instance.open(
                appName: 'Example App',
                appStoreId: '123456789',
            );
            Navigator.pop(context);
            },
            child: const Text('Update'),
        ),
        ],
    ),
);

打开App/Play商店

如果你想直接打开应用商店(Google Play或Apple App Store),可以使用 OpenStore 类:

onTap(){
    OpenStore.instance.open(
        appName: 'Example App',
        appStoreId: '123456789',
        androidAppBundleId: 'com.example.app',
    );
}

示例Demo

下面是一个完整的示例demo,展示了如何集成 app_updater 插件到你的Flutter应用中:

import 'package:app_updater/app_updater.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      debugShowCheckedModeBanner: false,
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

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

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Container(
              width: MediaQuery.of(context).size.width,
              height: MediaQuery.of(context).size.height * 0.5,
              color: Colors.black,
              child: const Center(
                child: Text(
                  'Check for updates',
                  style: TextStyle(
                    color: Colors.white,
                    fontSize: 20,
                  ),
                ),
              ),
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          checkAppUpdate(
            context,
            appName: 'Example App',
            iosAppId: '123456789',
            androidAppBundleId: 'com.example.app',
            isDismissible: false,
            customDialog: true,
            customAndroidDialog: AlertDialog(
              title: const Text('Update Available'),
              content: const Text('Please update the app to continue'),
              actions: [
                TextButton(
                  onPressed: () {
                    Navigator.pop(context);
                  },
                  child: const Text('Cancel'),
                ),
                TextButton(
                  onPressed: () {
                    OpenStore.instance.open(
                      androidAppBundleId: 'com.example.app',
                    );
                    Navigator.pop(context);
                  },
                  child: const Text('Update'),
                ),
              ],
            ),
            customIOSDialog: CupertinoAlertDialog(
              title: const Text('Update Available'),
              content: const Text('Please update the app to continue'),
              actions: [
                CupertinoDialogAction(
                  onPressed: () {
                    Navigator.pop(context);
                  },
                  child: const Text('Cancel'),
                ),
                CupertinoDialogAction(
                  onPressed: () {
                    OpenStore.instance.open(
                      appName: 'Example App',
                      appStoreId: '123456789',
                    );
                    Navigator.pop(context);
                  },
                  child: const Text('Update'),
                ),
              ],
            ),
          );
        },
        tooltip: 'Check for Updates',
        child: const Icon(Icons.update),
      ),
    );
  }
}

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

1 回复

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


当然,以下是一个关于如何在Flutter应用中使用app_updater插件来检查并提示用户进行应用更新的代码案例。这个插件允许应用检查最新版本信息(通常来自某个API或JSON文件),并提示用户进行更新。

首先,确保你已经在pubspec.yaml文件中添加了app_updater依赖:

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

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

接下来,在你的Flutter应用中,你可以按照以下步骤实现应用更新功能:

  1. 初始化AppUpdater

    在应用的入口文件(通常是main.dart)中,初始化AppUpdater

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

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

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

  Future<void> _checkForUpdates() async {
    final AppUpdater appUpdater = AppUpdater(
      androidAppId: 'com.example.yourapp', // 替换为你的Android应用ID
      iosAppId: '123456789', // 替换为你的iOS应用ID(如果是iOS应用)
      apiUrl: 'https://yourserver.com/update.json', // 替换为你的更新信息API或JSON文件URL
      supportSilentInstall: true, // 是否支持静默安装(仅Android)
      mandatoryUpdate: false, // 是否强制更新
    );

    AppUpdateInfo updateInfo = await appUpdater.checkForUpdate();
    if (updateInfo.updateAvailable) {
      // 有更新可用
      appUpdater.showUpdateDialog(
        context: context,
        updateInfo: updateInfo,
        global: true, // 是否全局显示对话框(覆盖所有页面)
      );
    } else {
      // 没有更新
      print('No update available.');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter App Updater Demo'),
      ),
      body: Center(
        child: Text('Checking for updates...'),
      ),
    );
  }
}
  1. 准备更新信息JSON文件

    在你的服务器上,创建一个JSON文件(例如update.json),内容如下:

{
  "android": {
    "versionCode": 2,
    "versionName": "1.1",
    "updateContent": "修复了一些bug,增加了新功能。",
    "apkUrl": "https://yourserver.com/path/to/yourapp.apk",
    "mandatory": false
  },
  "ios": {
    "version": "1.1",
    "updateContent": "修复了一些bug,增加了新功能。",
    "appStoreUrl": "https://apps.apple.com/us/app/yourapp/id123456789",
    "mandatory": false
  }
}

确保apkUrlappStoreUrl分别指向你的Android APK文件和iOS App Store页面。

  1. 运行应用

    现在,当你运行Flutter应用时,它将检查服务器上的更新信息。如果有更新可用,将显示一个对话框提示用户进行更新。

请注意,上述代码中的androidAppIdiosAppId需要替换为你的实际应用ID,apiUrl需要替换为你的更新信息JSON文件的URL。另外,根据你的具体需求,你可能需要调整AppUpdater的初始化参数,比如是否支持静默安装、是否强制更新等。

回到顶部