Flutter应用版本更新插件new_version_update的使用

new_version_update 是一个Flutter插件，用于检查您的应用程序在Apple App Store和Google Play Store上的新版本，并显示更新对话框给用户。

特性

• 检查Apple App Store和Google Play Store上的新应用版本。
• 显示平台特定的警报，带有更新或忽略按钮。
• 提供API获取版本状态（本地、商店、可以更新）以显示自定义UI。
• 支持iOS和Android平台。
• 可自定义对话框标题、文本和按钮文本。
• 支持启动模式定制。
• 支持变更日志展示。

开始使用

首先，在您的 pubspec.yaml 文件中添加依赖：

dependencies:
  new_version_update: ^0.0.2 

然后运行 flutter pub get 来安装这个包。

示例代码

下面是一个完整的示例演示如何使用 new_version_update 插件来检查并提示用户进行应用更新。

main.dart

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

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'New Version Update Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final newVersionUpdate = NewVersionUpdate(
    androidId: 'com.akbon.myd', // 替换为您的Android包名（如果使用默认值可选）
    iOSId: 'com.akbon.myd', // 替换为您的iOS bundle标识符（如果使用默认值可选）
    isShowChangelog: true, // 设置为false如果您不想显示变更日志
  );

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _checkVersion();
    });
  }

  void _checkVersion() async {
    final status = await newVersionUpdate.getVersionStatus();
    if (status != null) {
      debugPrint('Local Version: ${status.localVersion}');
      debugPrint('Store Version: ${status.storeVersion}');
      debugPrint('Can Update: ${status.canUpdate}');
      debugPrint('App Store Link: ${status.appStoreLink}');
      debugPrint('Release Notes: ${status.releaseNotes}');

      // 仅当可以更新时显示更新对话框
      if (status.canUpdate) {
        if (context.mounted) {
          newVersionUpdate.showUpdateDialog(
            context: context,
            versionStatus: status,
            dialogText: "You can update this App\nfrom ${status.localVersion} to ${status.storeVersion}\n\nWhat's New:\n${status.releaseNotes}",
            allowDismissal: true,
            updateButtonText: 'Update Now',
          );
        }
      }
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('New Version Update Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'Checking for updates...',
              style: TextStyle(fontSize: 18),
            ),
            const SizedBox(height: 20),
            ElevatedButton(
              onPressed: _checkVersion,
              child: const Text('Check for Update'),
            ),
          ],
        ),
      ),
    );
  }
}

以上代码创建了一个简单的Flutter应用，它会在启动时自动检查是否有可用的新版本。如果有新版本，会弹出一个对话框提示用户进行更新。您可以通过修改 androidId 和 iOSId 来适配您的应用。

这段Markdown文档详细介绍了如何使用 `new_version_update` 插件来实现应用版本更新功能，并提供了完整的示例代码。