Flutter版本管理插件NeoVersion的使用

检查Flutter应用程序是否在应用商店中有新版本。该插件使用Peek-An-App API来获取最新版本的信息。

此插件受到timtraversy/new_version插件的启发，但API并不兼容。

基本用法

在你想要检查新版本的地方创建一个NeoVersion类实例：

import 'package:neoversion/neoversion.dart';

final neoVersion = NeoVersion();

包会使用你的Flutter项目中的包名称来识别应用商店中的应用，但你也可以传递自己的标识符：

final neoVersion = NeoVersion(androidAppId: 'com.example.app', iOSAppId: 'com.example.app');

一旦你有了这个实例，你可以调用以下方法来提示用户是否有新版本可用：

await neoVersion.showAlertIfNecessary(context: context);

你也可以手动处理版本状态，并自定义提示的行为：

final status = await neoVersion.getVersionStatus();
status.needsUpdate; // (布尔值)
status.localVersion; // (字符串，当前安装的应用版本)
status.appStoreVersion; // (字符串，应用商店中的最新版本)

await neoVersion.showUpdateDialog(context: context, status: status);

完整示例

下面是一个完整的示例，展示了如何使用NeoVersion插件。

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

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

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

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

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

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

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();

    final neoVersion = NeoVersion(
      androidAppId: 'app.somus.social',
      iOSAppId: 'app.somus.social',
    );

    const simpleBehavior = true;

    if (simpleBehavior) {
      basicStatusCheck(neoVersion);
    } else {
      advancedStatusCheck(neoVersion);
    }
  }

  // 简单的版本状态检查
  basicStatusCheck(NeoVersion neoVersion) {
    neoVersion.showAlertIfNecessary(context: context);
  }

  // 高级版本状态检查
  advancedStatusCheck(NeoVersion neoVersion) async {
    final status = await neoVersion.getVersionStatus();
    
    // 打印一些调试信息
    debugPrint(status.appStoreUrl);
    debugPrint(status.localVersion);
    debugPrint(status.appStoreVersion);
    debugPrint(status.needsUpdate.toString());

    // 自定义更新对话框
    neoVersion.showUpdateDialog(
      context: context,
      status: status,
      title: '自定义标题',
      dialogText: (String local, String appstore, bool dismissable) =>
          '自定义文本 - 当前版本: $local, 应用商店版本: $appstore, 是否可取消: $dismissable',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("示例应用 - NeoVersion"),
      ),
    );
  }
}

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

nodeper 1楼•3 天前

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

当然，以下是如何在Flutter项目中使用neoversion插件进行版本管理的代码案例。neoversion是一个用于Flutter项目的版本管理工具，它允许你轻松地在应用中显示版本信息以及处理版本更新逻辑。

1. 添加依赖

首先，你需要在pubspec.yaml文件中添加neoversion依赖：

dependencies:
  flutter:
    sdk: flutter
  neoversion: ^最新版本号 # 请替换为当前最新版本号

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

2. 配置`neoversion`

在你的Flutter项目的根目录下创建一个名为version.json的文件，内容如下：

{
  "version": "1.0.0",
  "buildNumber": 1,
  "changelog": "Initial release."
}

这个文件包含了当前应用的版本信息、构建号以及更新日志。

3. 初始化`neoversion`

在你的main.dart文件中，初始化neoversion：

import 'package:flutter/material.dart';
import 'package:neoversion/neoversion.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: Scaffold(
        appBar: AppBar(
          title: Text('Flutter Demo Home Page'),
        ),
        body: NeoVersionWidget(
          versionFilePath: 'version.json', // 指定version.json文件的路径
          builder: (context, versionInfo) {
            return Center(
              child: Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: <Widget>[
                  Text(
                    'Version: ${versionInfo.version}',
                    style: TextStyle(fontSize: 24),
                  ),
                  Text(
                    'Build Number: ${versionInfo.buildNumber}',
                    style: TextStyle(fontSize: 18),
                  ),
                  ElevatedButton(
                    onPressed: () {
                      // 打开版本更新对话框
                      NeoVersion.showUpdateDialog(
                        context: context,
                        versionInfo: versionInfo,
                        mandatoryUpdate: false, // 是否强制更新
                        newVersion: VersionInfo(version: '1.0.1', buildNumber: 2, changelog: 'Fixed some bugs.'),
                      );
                    },
                    child: Text('Check for Updates'),
                  ),
                ],
              ),
            );
          },
        ),
      ),
    );
  }
}

在这个例子中，NeoVersionWidget被用来显示当前版本信息，并且提供了一个按钮来检查更新。NeoVersion.showUpdateDialog方法用于显示更新对话框。

4. 更新版本信息

当你发布新版本时，只需更新version.json文件中的version、buildNumber和changelog字段即可。例如：

{
  "version": "1.0.1",
  "buildNumber": 2,
  "changelog": "Fixed some bugs."
}

然后用户点击“Check for Updates”按钮时，将会看到更新对话框，提示他们有新版本可用。

总结

以上是如何在Flutter项目中使用neoversion插件进行版本管理的完整代码案例。通过配置version.json文件和使用NeoVersionWidget及NeoVersion.showUpdateDialog方法，你可以轻松地在应用中显示版本信息并处理版本更新逻辑。

Flutter版本管理插件neoversion的使用