flutter_in_store_app_version_checker 3.1.0-dev.1

A lightweight Flutter plugin to check app versions in Google Play, Apple App Store, ApkPure, RuStore, and AppGallery

flutter_in_store_app_version_checker

Description

A lightweight Flutter plugin to check whether your app (or any other app) has a newer version published on Google Play, ApkPure, RuStore, AppGallery, or Apple App Store.

Minimum supported SDKs:

• Flutter >=3.44.1
• Dart >=3.12.1 <4.0.0

The plugin uses Flutter 3.44+ built-in Kotlin support on Android and retrieves installed app metadata through its own native method channel. It no longer depends on package_info_plus.

Add the dependency:

dependencies:
  flutter_in_store_app_version_checker: <current>

Supported platforms

Platform	Stores
Android	Google Play, ApkPure, RuStore, AppGallery
iOS	Apple App Store

Other platforms (Web, Windows, Linux, macOS, etc.) are not supported.

Supported Android stores

Android enum value	Description
InStoreAppVersionCheckerAndroidStoreType.googlePlayStore	Default Google Play flow
InStoreAppVersionCheckerAndroidStoreType.apkPure	Alternative ApkPure scrape
InStoreAppVersionCheckerAndroidStoreType.ruStore	RuStore public catalog page
InStoreAppVersionCheckerAndroidStoreType.appGallery	Arbitrary AppGallery listing by storeID
InStoreAppVersionCheckerAndroidStoreType.appGalleryNative	Installed application through Huawei AppUpdateClient

API Overview

Main access point: InStoreAppVersionChecker (singleton: InStoreAppVersionChecker.instance) returning IInStoreAppVersionChecker implemented by InStoreAppVersionChecker.

Legacy factory-based API from 2.0.x has been removed. Use InStoreAppVersionChecker.instance or InStoreAppVersionChecker.instanceFor(...) together with InStoreAppVersionCheckerParams. InStoreAppVersionChecker.custom(...) is now deprecated and forwards to instanceFor(...).

Request parameters: InStoreAppVersionCheckerParams

Response object: InStoreAppVersionCheckerResponse

Internal installed-app metadata helper: AppMetadata

Key response fields:

• isSuccess / isError
• currentVersion
• newVersion
• canUpdate
• appURL
• errorMessage

Version comparison logic considers:

• Pre-release tokens (numeric and mixed) after core version comparison.
• Build metadata (+xyz) is ignored for equality/update decisions.
• Whitespace trimmed; non-alphanumeric symbols stripped (see tests).
• Mixed alphanumeric pre-release segments compared token-by-token with numeric-aware ordering.

Store locale

Use one regional locale for both platforms, for example en-US or en-AE. Google Play uses the complete locale for its hl language parameter. On iOS, the region selects the App Store storefront country; it does not automatically detect the country of the user's App Store account.

locale	Google Play hl	App Store country
en-US	en-US	us
en_AE	en-AE	ae
pt-BR	pt-BR	br
zh-Hant-TW	zh-Hant-TW	tw
ru	ru	ru (legacy country-only input)
en	en	Invalid country; Apple returns an error

Supported regional forms are language-REGION and language-Script-REGION. Underscores are accepted as separators; surrounding whitespace and letter case are normalized. On Google Play, other locale forms are passed through unchanged. ApkPure and RuStore ignore locale. AppGallery web requests use it to localize the store response, but storeID remains the authoritative listing identifier. AppGallery native checks let Huawei select the locale.

On iOS, existing two-letter country-only values such as us, ae, and ru remain supported. Short values are interpreted as countries: ar means Argentina, while ar-AE explicitly selects the UAE storefront. A language such as en cannot determine a country, and the package never silently falls back to a different storefront.

iOS rejects malformed values, locales without a country such as zh-Hant, numeric regions such as es-419, and locale variants or extensions. This is structural validation, not a list of supported storefronts: Apple determines whether the requested country is supported and whether the app is available there. See Apple's country parameter documentation.

Example

Simple check (Play Store HTML with fallback API)

import 'dart:developer' as dev;

import 'package:flutter_in_store_app_version_checker/flutter_in_store_app_version_checker.dart';

Future<void> check() async {
  const params = InStoreAppVersionCheckerParams(
    locale: 'en-US',
    // packageName:    'com.example.app', // optional override
    // currentVersion: '1.2.3',           // optional override
    // androidStore:   InStoreAppVersionCheckerAndroidStoreType.apkPure,
  );
  final res = await InStoreAppVersionChecker.instance.checkUpdate(params);
  if (res.isError) {
    dev.log(
      res.errorMessage ?? 'Update check failed',
      error: res.error,
      stackTrace: res.stackTrace,
    );
    return;
  }
  dev.log('Current version: ${res.currentVersion}');
  dev.log('New version    : ${res.newVersion}');
  dev.log('App url        : ${res.appURL}');
  dev.log('Can update     : ${res.canUpdate}');
}

ApkPure

const params = InStoreAppVersionCheckerParams(
  locale: 'en',
  androidStore: InStoreAppVersionCheckerAndroidStoreType.apkPure,
);
final res = await InStoreAppVersionChecker.instance.checkUpdate(params);

RuStore

const params = InStoreAppVersionCheckerParams(
  locale: 'ru-RU',
  packageName: 'ru.beautybox.twa',
  currentVersion: '38.2.0',
  androidStore: InStoreAppVersionCheckerAndroidStoreType.ruStore,
);
final res = await InStoreAppVersionChecker.instance.checkUpdate(params);

RuStore identifies public catalog pages by Android package name. The checker reads SoftwareApplication.softwareVersion from the page JSON-LD. Network restrictions, missing cards, and malformed metadata are returned as errors.

AppGallery: arbitrary application

const params = InStoreAppVersionCheckerParams(
  locale: 'ru-RU',
  packageName: 'ru.beautybox.twa',
  storeID: 'C107631977',
  currentVersion: '38.2.0',
  androidStore: InStoreAppVersionCheckerAndroidStoreType.appGallery,
);
final res = await InStoreAppVersionChecker.instance.checkUpdate(params);

packageName and storeID are different identifiers. The package name comes from the Android application, while AppGallery assigns a listing ID such as C107631977. Store-specific builds may use different Android package names.

This mode supports arbitrary applications, but it uses the same internal, undocumented web endpoint as the public AppGallery website. Huawei can change that endpoint or its response format without notice. The checker validates the returned App ID and, when packageName is explicitly supplied, its package. Endpoint failures and unexpected responses are returned as errors.

AppGallery: installed application with the official SDK

const params = InStoreAppVersionCheckerParams(
  locale: 'ru-RU',
  androidStore: InStoreAppVersionCheckerAndroidStoreType.appGalleryNative,
);
final res = await InStoreAppVersionChecker.instance.checkUpdate(params);

This mode uses Huawei AppUpdateClient and is the recommended AppGallery option for the installed application. It does not support arbitrary applications or packageName and currentVersion overrides. When Huawei reports no update, the response is successful with newVersion == null and canUpdate == false.

The plugin includes com.huawei.hms:appservice:6.16.2.300 and the Huawei Maven repository. Projects that enforce repositories in settings.gradle must also allow the Huawei repository:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

Huawei documents that checkAppUpdate checks the AppGallery server even when the AppGallery client is not installed. The client is still required when the user proceeds to the AppGallery details and installation flow. See the AppUpdateClient FAQ.

iOS

const params = InStoreAppVersionCheckerParams(locale: 'en-AE');
final res = await InStoreAppVersionChecker.instance.checkUpdate(params);

This explicitly checks the UAE storefront. Choose the region where the app is available; the English language alone (en) is not an App Store country.

Custom HTTP client

final checker = InStoreAppVersionChecker.instanceFor(
  httpClient: customHTTPClient,
);
const params = InStoreAppVersionCheckerParams(locale: 'en-US');
final res = await checker.checkUpdate(params);

How package name and version are resolved

If packageName or currentVersion are not provided in InStoreAppVersionCheckerParams, the plugin resolves them from the installed app metadata on the host platform.

• Android: package name and version from the plugin's native Android implementation
• iOS: bundle identifier and CFBundleShortVersionString from the plugin's native iOS implementation

This behavior is covered by unit tests in test/unit/app_metadata_test.dart.

storeID is separate from packageName. It is required only for AppGallery web checks. AppGallery native checks obtain the installed application identity from Huawei and ignore storeID.

Version comparison notes

• Release vs pre-release: a pure release is considered higher than a pre-release with the same core; therefore if current is release and new is pre-release -> treated as update (legacy-compatible).
• Numeric pre-release tokens compared numerically; mixed/alphanumeric tokens compared lexicographically after numeric segments.
• Trailing zero segment normalization: 1.2 equals 1.2.0 (no update).
• Fully non-numeric current vs numeric new => update.
• Fully non-numeric new vs numeric current => no update.
• Build metadata (+build) ignored. See unit tests in test/unit for authoritative behavior.

Error handling

Types:

• success
• error (invalid parameters, HTTP/network failures, malformed store data, app not found in the selected storefront, native SDK failures, unsupported platform)

errorMessage is populated only for error responses. An error response may still indicate canUpdate == true if newVersion is greater.

Check isError before using canUpdate. A failed lookup with no store version also returns canUpdate == false; that alone does not mean the app is up to date.

Apple HTTP errors include the status, original locale, and resolved storefront. HTTP 400 includes guidance to check the country code. A successful HTTP 200 response with empty results instead reports that the app was not found in that storefront; check both its bundle ID and regional availability.

Platform integration notes

• Android example app is migrated to Flutter built-in Kotlin.
• AppGallery native checks use Huawei App Service SDK 6.16.2.300.
• iOS Swift Package Manager support includes the required FlutterFramework dependency in Package.swift.
• CocoaPods support remains available alongside Swift Package Manager.

Changelog

Refer to the Changelog to get all release notes.

Maintainers

Anton Ustinoff (ziqq)

License

MIT

Funding

If you want to support the development of our library, there are several ways you can do it:

• Buy me a coffee
• Subscribe through Boosty

Coverage