Flutter应用内更新插件in_app_update的使用

in_app_update 是一个用于在Android平台上启用应用内更新功能的Flutter插件。它利用了官方的Android API，为用户提供了一种直接从应用内部检查并安装更新的方式。

文档

该插件提供了以下方法：

• Future<AppUpdateInfo> checkForUpdate()：检查是否有可用更新。
• Future<void> performImmediateUpdate()：执行即时更新（全屏模式）。
• Future<void> startFlexibleUpdate()：开始灵活更新（后台下载）。
• Future<void> completeFlexibleUpdate()：实际安装可用的灵活更新。

请参考示例应用程序以了解如何使用这些API！

Android

此插件集成了官方的Android API来执行应用内更新，这是2019年发布的功能： Android In-app Updates

iOS

iOS不提供类似的功能。如果需要，可以考虑使用其他包如 upgrader。请注意，在iOS设备上调用上述方法将导致未实现异常。

示例代码

以下是in_app_update的一个完整示例demo：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:in_app_update/in_app_update.dart';

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  AppUpdateInfo? _updateInfo;
  GlobalKey<ScaffoldState> _scaffoldKey = new GlobalKey();
  bool _flexibleUpdateAvailable = false;

  Future<void> checkForUpdate() async {
    try {
      final info = await InAppUpdate.checkForUpdate();
      setState(() {
        _updateInfo = info;
      });
    } catch (e) {
      showSnack(e.toString());
    }
  }

  void showSnack(String text) {
    if (_scaffoldKey.currentContext != null) {
      ScaffoldMessenger.of(_scaffoldKey.currentContext!)
          .showSnackBar(SnackBar(content: Text(text)));
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        key: _scaffoldKey,
        appBar: AppBar(
          title: const Text('In App Update Example App'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(8.0),
          child: Column(
            children: <Widget>[
              Center(
                child: Text('Update info: $_updateInfo'),
              ),
              ElevatedButton(
                onPressed: () => checkForUpdate(),
                child: Text('Check for Update'),
              ),
              ElevatedButton(
                onPressed: _updateInfo?.updateAvailability ==
                        UpdateAvailability.updateAvailable
                    ? () {
                        InAppUpdate.performImmediateUpdate().catchError((e) {
                          showSnack(e.toString());
                          return AppUpdateResult.inAppUpdateFailed;
                        });
                      }
                    : null,
                child: Text('Perform immediate update'),
              ),
              ElevatedButton(
                onPressed: _updateInfo?.updateAvailability ==
                        UpdateAvailability.updateAvailable
                    ? () {
                        InAppUpdate.startFlexibleUpdate().then((_) {
                          setState(() {
                            _flexibleUpdateAvailable = true;
                          });
                        }).catchError((e) {
                          showSnack(e.toString());
                        });
                      }
                    : null,
                child: Text('Start flexible update'),
              ),
              ElevatedButton(
                onPressed: !_flexibleUpdateAvailable
                    ? null
                    : () {
                        InAppUpdate.completeFlexibleUpdate().then((_) {
                          showSnack("Success!");
                        }).catchError((e) {
                          showSnack(e.toString());
                        });
                      },
                child: Text('Complete flexible update'),
              )
            ],
          ),
        ),
      ),
    );
  }
}

注意事项

1. 仅适用于Android：此功能目前只支持Android平台。对于iOS，你可以选择其他方式来提示用户更新。
2. 测试限制：本地测试时可能会遇到ERROR_API_NOT_AVAILABLE错误，这是因为该插件依赖Google Play服务，必须通过Google Play安装才能正常工作。有关详细信息，请参阅官方文档。
3. 兼容性：应用内更新仅适用于API级别>=21的设备。