upgrade_util
Language: 中文 | English
A Flutter plugin for in-app updates: jump to the app store detail page, review list page, or write-review page. Supports Android and iOS.
On Android the plugin automatically detects the installed vendor app market (Huawei, Honor,
Xiaomi, OPPO, vivo, Meizu, Samsung) and launches it with the brand-specific scheme, falling back
to the generic market:// protocol for unlisted markets; on iOS it builds itms-apps:// App
Store links for the detail page, the review list page, and the write-review page.
Requirements
sdk: ^3.11.0
flutter: ">=3.41.0"
Getting started
Step 1: Add the dependency
Add upgrade_util to your pubspec.yaml:
dependencies:
upgrade_util: ^latest_version
import 'package:upgrade_util/upgrade_util.dart';
Step 2: Get the Apple ID (iOS)
appleID is required on iOS. Find it in App Store Connect →
My Apps → select the app → App Information → Apple ID, or take the digits after id in the
App Store link https://apps.apple.com/app/id<AppleID>.
Usage
Jump to the store detail page
final bool opened = await UpgradeUtil.launch(
type: UpgradeOpenType.detail,
packageName: 'com.tencent.mm', // Android; defaults to the host app's package name
appleID: '414478124', // iOS
);
Jump to the write-review page
final bool opened = await UpgradeUtil.launch(
type: UpgradeOpenType.review,
appleID: '414478124',
);
On Android only OPPO (incl. realme, OnePlus), vivo and Honor support review deep links; on other markets
reviewfalls back to the detail page.
Jump to the review list page (iOS only)
final bool opened = await UpgradeUtil.launch(
type: UpgradeOpenType.reviews,
appleID: '414478124',
);
Throws
UnsupportedErroron Android before any platform call.
The returned bool indicates whether the jump was successfully initiated: both platforms
pre-check that the link can be handled and return false without jumping otherwise; on iOS
the final value comes from the system callback, while on Android it only covers initiating
the jump and does not include the user's subsequent actions in the market.
Parameters
Methods
| Name | Signature | Description |
|---|---|---|
launch |
({required UpgradeOpenType type, String? packageName, String? appleID}) → Future<bool> |
Jumps to the target app store page and reports whether it was initiated. |
launch parameters
| Name | Type | Default | Description |
|---|---|---|---|
type |
UpgradeOpenType |
required | Target page type. |
packageName |
String? |
null |
Target app package name. Android only; defaults to the host app's package name. Ignored on iOS. |
appleID |
String? |
null |
The app's Apple ID. Required on iOS (an ArgumentError is thrown when missing). Ignored on Android. |
UpgradeOpenType
| Value | Description | Platform |
|---|---|---|
detail |
App detail page | Android, iOS |
reviews |
Review list page | iOS only; throws UnsupportedError on Android |
review |
Write-review page | Android, iOS. On Android only OPPO (incl. realme/OnePlus), vivo and Honor support review deep links; other markets fall back to the detail page |
Notes
- Pre-launch check: before launching, both platforms verify that the target link can be
handled — if no app market or the App Store can open it,
launchreturnsfalsewithout attempting a jump (on Android emulators, the system's fallback component counts as "no handler"). The plugin's bundled manifest already declares the required Android package visibility (<queries>), so no host-app configuration is needed. - Android market detection: the installed vendor market is matched in priority order —
Huawei, Honor, Xiaomi, OPPO, vivo, Meizu, Samsung — and the first installed one wins; unlisted
markets are launched with the generic
market://protocol. - Review deep-link limits (Android): supported by OPPO (incl. realme, OnePlus), vivo and
Honor (market versionCode ≥ 160036301); elsewhere
reviewfalls back to the detail page. - Example app: see example/lib/main.dart for a complete example.
If you like my project, please click "Star" in the upper right corner of the project. Your support is my biggest encouragement! ^_^