upgrade_util 0.1.0

An application upgrade plug-in.

Flutter Upgrade Util

Language: 中文 | English

At present, the plugin is only used by Android, iOS

Use of third-party

• Using dio to download the apk for Android;
• Use url_launcher_ios to achieve link jumping for iOS.

Preparing for use

Version constraints

  sdk: ">=2.14.0 <3.0.0"
  flutter: ">=2.5.0"

Rely

1. Add upgrade_util to pubspec.yaml dependencies.

dependencies:
  upgrade_util: ^latest_version

2. Get the package by executing the flutter command.

flutter pub get

3. Introduce

import 'package:upgrade_util/upgrade_util.dart';

Localized configuration

Add in MaterialApp.

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
    ...
    localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
    ...
    UpgradeLocalizationsDelegate.delegate,
    ],
    ...
    );
  }
}

Usage

Popups are implemented by using CupertinoAlertDialog.

Parameter names and descriptions of UpgradeDialog:

Name	Type	Description	Default
key	Key?	Identifier of the component	ObjectKey(context)
appKey	String	The package name for Android;App Store number for iOS	Required
androidMarket	AndroidMarket?	The App Market Configuration for Android	AndroidMarket()
otherMarkets	List<String>?	The package name of the app market that is not preset in AndroidMarket	null
downloadUrl	String?	The download link for apk
saveApkName	String?	The save name of the apk file	temp
savePrefixName	String?	The folder where the apk file is saved	libCacheApkDownload
title	String?	Title	UpgradeLocalizations.of(context).title
content	String?	What's new in the version	UpgradeLocalizations.of(context).content
contentTextAlign	TextAlign	The alignment of content	TextAlign.start
scrollController	ScrollController?	CupertinoAlertDialog.scrollController	null
actionScrollController	ScrollController?	CupertinoAlertDialog.actionScrollController	null
force	bool	Is it a mandatory update	false
updateKey	Key?	The component identifier for the OK (upgrade) button	null
updateText	String?	Text of OK (Upgrade) button	UpgradeLocalizations.of(context).updateText
updateTextStyle	TextStyle?	Text style for OK (Upgrade) button	null
isUpgradeDefaultAction	bool	Determine if the OK (Upgrade) button is the default option	false
isUpgradeDestructiveAction	bool	Determine if the OK (Upgrade) button is a destroy action	false
cancelKey	Key?	The component identifier for the cancel button	null
cancelText	String?	Text of Cancel button	UpgradeLocalizations.of(context).cancelText
cancelTextStyle	TextStyle?	Text style for Cancel button	null
isCancelDefaultAction	bool	Determine if the Cancel button is the default option	false
isCancelDestructiveAction	bool	Determine if the Cancel button is a destroy action	true
updateCallback	VoidCallback?	Click event listener for OK (upgrade) button	null
cancelCallback	VoidCallback?	Click event listener for Cancel button	null
downloadProgressCallback	DownloadProgressCallback?	Progress monitoring of download events	null
downloadStatusCallback	DownloadStatusCallback?	Status listener of download events	null

iOS

• appKey is the application number of the App Store, please make sure the app is published and available;
• androidMarket，otherMarkets，downloadUrl，saveApkName，savePrefixName，downloadProgressCallback，downloadStatusCallback，are invalid on iOS platform.

Android

• appKey is the package name of the application;
• androidMarket application market detailed configuration can be viewed AndroidMarket;
• androidMarket and downloadUrl need to be configured; if both are configured, androidMarket is the priority;
• saveApkName does not need to carry a suffix, the default setting is .apk;
• savePrefixName does not need to concatenate /, the default configuration is /${savePrefixName}/.

方法

iOS

To jump to the App Store, use the jumpToAppStore method

• The required item is appId, which is the application number of the App Store;

• There are three modes

  1. EIOSJumpMode.detailPage，jump to the application details page (ie the product introduction page);
  2. EIOSJumpMode.reviewsPage, jump to the app review page;
  3. EIOSJumpMode.writeReview, jump to the app review page and comment.

Android

1. getDownloadPath, get the download address of the apk;
2. installApk, install the apk, and jump to the installation guide page;
3. getAvailableMarket, get the currently available application market;
4. jumpToMarket, jump to the application details page of the application market.