upgrade_util 2.2.0

An app upgrade plugin. It realizes the function of jumping to App Store or Market and installing after downloading APK.

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;

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

showUpgradeDialog

Popups are implemented by using showUpgradeDialog.

Name	Type	Description	Default
context	BuildContext	Context	Required
key	Key?	Identifier of the component	null
uiUpgradeConfig	UiUpgradeConfig?	Dialog style	UiUpgradeConfig(title: UpgradeLocalizations.of(context).title, content: UpgradeLocalizations.of(context).content, updateText: UpgradeLocalizations.of(context).updateText, cancelText: UpgradeLocalizations.of(context).cancelText)
iOSUpgradeConfig	IosUpgradeConfig?	iOS upgrade config	IosUpgradeConfig()
androidUpgradeConfig	AndroidUpgradeConfig?	Android upgrade config	AndroidUpgradeConfig(androidMarket: AndroidMarket(), downloadCancelText: UpgradeLocalizations.of(context).androidCancel)
barrierLabel	String?	barrierLabel	null
arguments	Object?	The arguments passed to this route	null

UiUpgradeConfig

Popups are implemented by using UiUpgradeConfig.

Name	Type	Description	Default
force	bool	Whether to force the update	false
title	String?	A title of the version.	UpgradeLocalizations.of(context).title
titleTextStyle	TextStyle?	The text style of title	null
titleStrutStyle	StrutStyle?	The strut style of title	null
content	String?	A description of the version	UpgradeLocalizations.of(context).content
contentTextStyle	TextStyle?	The text style of content	null
contentStrutStyle	StrutStyle?	The strut style of content	null
updateText	String?	Text message of the update button	UpgradeLocalizations.of(context).updateText
updateTextStyle	TextStyle?	The text style of updateText	null
cancelText	String?	Text message of cancel button	UpgradeLocalizations.of(context).cancelText
cancelTextStyle	TextStyle?	The text style of cancelText	null

IosUpgradeConfig

Popups are implemented by using IosUpgradeConfig.

Name	Type	Description	Default
appleId	String?	Apple ID	null
scrollController	ScrollController?	A scroll controller that can be used to control the scrolling of the content in the dialog	null
actionScrollController	ScrollController?	A scroll controller that can be used to control the scrolling of the actions in the dialog	null
isUpgradeDefaultAction	bool	Set to true if button is the default choice in the dialog	false
isUpgradeDestructiveAction	bool	Whether this action destroys an object	false
isCancelDefaultAction	bool	Set to true if button is the default choice in the dialog	false
isCancelDestructiveAction	bool	Whether this action destroys an object	true

AndroidUpgradeConfig

Popups are implemented by using AndroidUpgradeConfig.

Name	Type	Description	Default
packageName	String?	The name of package for Android	null
androidMarket	AndroidMarket?	The settings of app market for Android	AndroidMarket()
otherMarkets	List<String>?	The package name of the app market that is not preset in AndroidMarket	null
downloadUrl	String?	A link of download for Apk	null
saveName	String?	The name of the file after the apk download is completed	temp.apk
downloadCancelText	String?	Cancel text when downloading	UpgradeLocalizations.of(context).androidCancel
indicatorBackgroundColor	Color?	It is LinearProgressIndicator.backgroundColor	null
indicatorColor	Color?	It is LinearProgressIndicator.color	null
indicatorValueColor	Color?	It is LinearProgressIndicator.valueColor	null
indicatorTextColor	Color?	The text color of the indicator	null
onDownloadProgressCallback	DownloadProgressCallback?	Realize the listening event of download progress	null
onDownloadStatusCallback	DownloadStatusCallback?	Realize the listening event of download status	null

• androidMarket application market detailed configuration can be viewed AndroidMarket;
• androidMarket and downloadUrl need to be configured; if both are configured, androidMarket is the priority;

Method

To jump to the App Store or the application market, use the jumpToStore method

• The required item is jumpMode, so far, there are three modes;
  1. JumpMode.detailPage, jump to the application details page (ie the product introduction page);
  2. JumpMode.reviewsPage, jump to the app review page;
  3. JumpMode.writeReview, jump to the app review page and comment.
• appleId is required for iOS, which is the application number of the App Store；
• packageName is required for Android, this is the app package name；
• marketPackageName is the package name of the application market that Android jumps to, not required.

Android unique method

1. getDownloadPath, get the save path of the software download；
2. installApk, install the apk, and jump to the installation guide page；
3. getMarkets get a list of software information for the application market contained in the mobile phone.