Flutter版本管理插件flutter_prince_of_versions的使用

flutter_prince_of_versions 是一个用于检查应用更新的Flutter插件。它支持从远程资源获取更新信息，并且可以针对iOS和Android平台分别进行配置。

目录

• 使用
  • 获取所有远程数据
  • 自动检查App Store更新
  • 自动检查Google Play更新
• JSON文件格式化
  • iOS示例
  • Android示例
• R8/ProGuard

使用

获取所有远程数据

你可以通过调用 checkForUpdates 方法来检查是否有新的应用版本可用。该方法允许你自定义更新流程，例如在有新次要版本时强制更新应用。

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

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

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

class _MyAppState extends State<MyApp> {
  Future<void> checkForUpdates() async {
    final url = "https://your-update-config-url.com"; // 替换为你的URL
    try {
      final data = await FlutterPrinceOfVersions.checkForUpdates(
        url: url,
        shouldPinCertificates: false,
        requirementChecks: {
          'region': (String region) {
            return region == 'hr'; // 示例条件：仅当地区为'hr'时返回true
          },
          'bluetooth': (String bluetoothVersion) {
            return bluetoothVersion == '5.0'; // 示例条件：仅当蓝牙版本为'5.0'时返回true
          }
        },
      );
      print('Update status: ${data.status}');
      print('Installed version: ${data.updateInfo.installedVersion}');
      print('Last version: ${data.updateInfo.lastVersionAvailable}');
    } catch (e) {
      print(e);
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text("Flutter Prince of Versions Demo")),
        body: Center(
          child: ElevatedButton(
            onPressed: checkForUpdates,
            child: Text("Check for Updates"),
          ),
        ),
      ),
    );
  }
}

自动检查App Store更新

如果你不想手动管理JSON配置文件，可以使用 checkForUpdatesFromAppStore 方法。该方法会自动获取应用的Bundle ID并从App Store中获取版本信息。

Future<void> checkForUpdatesFromAppStore() async {
  final updateData = await FlutterPrinceOfVersions.checkForUpdatesFromAppStore();
  print('Update status: ${updateData.status}');
  print('Current version: ${updateData.version}');
}

自动检查Google Play更新

对于Google Play上的应用，可以使用 checkForUpdatesFromGooglePlay 方法来检查更新。该方法会触发回调函数，以便在更新状态发生变化时通知用户。

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

class MyCallback extends Callback {
  MyCallback(BuildContext context) {
    _context = context;
  }
  BuildContext _context;

  @override
  void error(String localizedMessage) {
    showDialog<bool>(
      context: _context,
      builder: (BuildContext context) {
        return CupertinoAlertDialog(
          title: Text('An error occurred'),
          content: Text('$localizedMessage'),
          actions: <Widget>[
            CupertinoDialogAction(
              child: Text('Ok'),
              isDestructiveAction: false,
              onPressed: () => Navigator.pop(context, true),
            ),
          ],
        );
      },
    );
  }
}

Future<void> checkForUpdatesFromGooglePlay() async {
  final callback = MyCallback(context);
  await FlutterPrinceOfVersions.checkForUpdatesFromGooglePlay(
      "Google Play URL", callback);
}

JSON文件格式化

为了正确地配置更新检查，你需要提供一个符合特定格式的JSON文件。以下是iOS和Android的示例：

iOS示例

{
   "ios": {
      "minimum_version": "1.2.3",
      "minimum_version_min_sdk": "8.0.0",
      "latest_version": {
         "version": "2.4.5",
         "notification_type": "ALWAYS",
         "min_sdk": "12.1.2"
      }
   },
   "ios2": [
      {
         "required_version": "1.2.3",
         "last_version_available": "1.9.0",
         "notify_last_version_frequency": "ALWAYS",
         "requirements": {
            "required_os_version": "8.0.0",
            "region": "hr",
            "bluetooth": "5.0"
         },
         "meta": {
            "key1": "value1",
            "key2": 2
         }
      }
   ]
}

Android示例

{
  "android": [{
    "required_version": 10,
    "last_version_available": 12,
    "notify_last_version_frequency": "ONCE",
    "requirements": {
      "required_os_version": 18
    },
    "meta": {
      "key1": "value3"
    }
  }]
}

R8/ProGuard

如果你正在使用R8或ProGuard，请确保添加以下选项以避免混淆相关类：

-keep class com.infinum.princeofversions.** { *; }