NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #3504 most downloaded on pub.dev
Easily show material update dialog in Android or Cupertino dialog in IOS with support for Google play in app updates.
Latest stable
1.3.0
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 12 of 13 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
14 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
implementing version update by @basemosama in https://github.com/playx-flutter/playx_version_update/pull/1
Full Changelog: https://github.com/playx-flutter/playx_version_update/commits/v2.0.0-beta.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Pre-release of 2.0.0. It is not picked up by
^1.xconstraints. Try it withplayx_version_update: ^2.0.0-beta.1and report problems on the issue tracker. The final 2.0.0 will have the same changes unless a fix is needed.
A big release: version sources, "Later" and "Skip", events, macOS, a rewritten network layer and many fixes. See the migration guide for the few changes you may need to make.
package_info_plus
is ^10.2.2 and dio is ^5.11.1.playx_network is removed. The package now has its own small dio based client. The NetworkException
types are still exported under the same names, but they are this package's own types: they have an
errorCode, message, cause and isRetryable, and no apiErrorMessage / shouldShowApiError.
PlayxVersionNetworkError.errorCode is now the stable NetworkErrorCode (it used to be the status code or the message).PlayxVersionUpdate.openStore now opens the store app first (market://, itms-apps://, macappstores://)
and the web URL after it, no longer calls canLaunchUrl (no <queries> / LSApplicationQueriesSchemes
needed), and returns an error whenever nothing could be opened (before, launchUrl returning false
gave success(false)).PlayxInAppUpdateCanceledError (it was
success(false)) and a failed one is PlayxInAppUpdateFailedError (it was success(true)).
getUpdateStalenessDays / getUpdatePriority return -1 when there is no update instead of an error.PlayxVersionUpdateError has three new subclasses (PlayxUpdateNotAvailableError,
PlayxUpdateInProgressError, PlayxUpdateNotAllowedError), so an exhaustive switch needs them.PlayxVersionRequest (new) exposes platform: PlayxPlatform instead of a boolean.PlayxUpdateOptions.versionSource with PlayxStoreVersionSource (default),
PlayxCallbackVersionSource (Remote Config or your backend), PlayxStaticVersionSource (fixed values per
platform) and PlayxFallbackVersionSource. Implement PlayxVersionSource for your own.PlayxPlatform (android, ios, macos, windows, linux), the generic
PlayxPlatformValue<T>, and PlayxPlatformVersion with macos, windows and linux values.
PlayxUpdateOptions.appIds sets the app id per platform and storeUrls a custom store URL per platform.
checkVersion runs on Windows and Linux with a custom versionSource.reminderOptions on showUpdateDialog (iosReminderOptions on
showInAppUpdateDialog) with pluggable PlayxUpdateStorage (in memory by default) and PlayxUpdateReminder.
showUpdateDialog returns success(false) when the prompt is suppressed.PlayxUpdateEvents (PlayxUpdateUIOptions.events): shown, update tapped, store open result,
dismissed, skipped, suppressed, and Android in-app update started / result.storeLauncher and onStoreOpenResult to open the store yourself, preferStoreApp, and
openStore without a URL (it resolves one from the options) for an "Update" or "Rate us" button.PlayxUpdateOptions.networkOptions (PlayxNetworkOptions: retries, timeouts, headers, a custom
Dio, a CancelToken), full request and response logging with enableNetworkLogging (credentials are
masked), automatic retry of failures that can succeed later, stable NetworkErrorCodes, isRetryable,
and new AppNotFoundException, ConsentRequiredException, BadRequestException,
TooManyRequestsException and BadCertificateException.ConsentRequiredException
(STORE_CONSENT_REQUIRED) instead of a version format error.UpdatePressedCallback, StoreLauncherCallback, ...) are exported.lib/), CI on every pull request, and publishing to pub.dev
automated from v* tags.newVersion, the Google Play page is no longer requested on Android; on iOS the App Store
lookup (needed for the store URL) is best-effort. Passing storeUrls with newVersion skips it.Accept-Language.forceUpdate: true still applies), and an empty minVersion falls back to the source's.PlayxUpdateOptions.newPlatformVersion and minPlatformVersion: use versionSource: PlayxStaticVersionSource(...).PlayxUpdateOptions.androidPackageName and iosBundleId: use appIds.They keep working and will be removed in a future major release.
onCancel no longer also exits the app and is no
longer closed by its dismiss button; the page's dismiss button closes a dismissible page; the page handles
the back button like the dialog; the iOS dialog no longer pops its route twice; double taps no longer pop an
unrelated route or launch the store twice; onShown is only reported when something is on screen.onUpdate, onCancel, storeLauncher) are reported to
FlutterError.onError instead of leaving the update half-handled.PlayxUpdateOptions.localVersion is honored (it was ignored).v prefix or surrounding spaces are parsed (v2.0.0 was read as 0.0.0), and
Version.hashCode is consistent with ==.consent.google.com is no longer rejected as the consent form.Add PlayxPlatformVersion with newPlatformVersion and minPlatformVersion overrides for Android- and iOS-specific app version checks.
PlayxPlatformVersion with newPlatformVersion and minPlatformVersion overrides for Android- and iOS-specific app version checks.newVersion and minVersion as the effective resolved values in PlayxVersionUpdateInfo for backward compatibility.- Update packages
Update package_info_plus, playx_network, url_launcher packages
> Note: This release is a major release and may break some of the existing implementations. Please read the documentation carefully.
Note: This release is a major release and may break some of the existing implementations. Please read the documentation carefully.
This major release introduces significant refactoring, enhanced error handling, improved customization options, and updated build infrastructure.
PlayxUpdateOptions to consolidate parameters for version checking (e.g., store IDs, local/new versions, country, language).PlayxUpdateUIOptions to consolidate parameters for the visual presentation of update dialogs/pages (e.g., titles, descriptions, button labels, callbacks, show/hide elements).checkVersion, showUpdateDialog, and showInAppUpdateDialog, improving organization and extensibility.PlayxInAppUpdateFailed with a detailed PlayxInstallError sealed class, directly mapping to Android's InstallErrorCode for specific error types (e.g., ApiNotAvailable, AppNotOwned, DownloadNotPresent).PlayxVersionNetworkError to wrap playx_network's NetworkException, differentiating network issues from other update errors, while providing specific, user-friendly messages for network-related exceptions during app version checksPlayxInAppUpdateInfoRequestCanceledError into PlayxInAppUpdateCanceledError for simplified error handling.Version class for robust and flexible parsing/comparison of version strings (supporting SemVer, multi-part numeric versions, and ignoring non-numeric tags) like 2.25.18.80.Version class.version package dependency.PlayxUpdateDisplayType enum to control Flutter-based update prompt presentation (Dialog, Page, or Page on Force Update).titleTextStyle, descriptionTextStyle, releaseNotesTitleTextStyle, releaseNotesTextStyle, button text styles) and button styles.PlayxUpdateUIOptions.displayType now defaults to pageOnForceUpdate.UpdateNameInfoCallback renamed to UpdateTextInfoCallback.showInAppUpdateDialog now prompts to complete it.PlayxVersionUpdate, providing clearer descriptions of immediate and flexible flows, detailed error types, and best practice recommendations.updateData and updateError getters to PlayxVersionUpdateResult for easier access to success data or error information.8.7.3 and Kotlin to 2.1.0.36.17.8.12..gradle.kts).PlayxUpdateUIOptions (custom leading widget, text styles, button styles, action callbacks).iosUiOptions examples.PlayxUpdateOptions for checkVersion and conditional display of PlayxUpdatePage (forced) and PlayxUpdateDialog (optional) with custom UI.>=3.6.0 <4.0.0 and Flutter to >=3.27.0.playx_network to ^0.5.1.> Note : This release is a major release and may break some of the existing implementations. Please read the documentation carefully.
Note : This release is a major release and may break some of the existing implementations. Please read the documentation carefully.
PlayxVersionUpdateResult.when now returns a value instead of requiring callbacks to handle data.map and mapAsync now directly return transformed results instead of requiring wrapped factory calls.Success and ERROR classes to PlayxVersionUpdateSuccessResult and PlayxVersionUpdateErrorResult.isSuccess and isError Getters – Easily check the result type.when, map, and mapAsync Methods – Now return transformed values instead of requiring extra wrapping.playx_network for network requests for better error handling.forceUpdate can close the app using SystemNavigator.pop() if no onCancel callback is provided.> Note : This release is a major release and may break some of the existing implementations. Please read the documentation carefully.
Note : This release is a major release and may break some of the existing implementations. Please read the documentation carefully.
Plugin now requires the following:
Update packages.
The plugin now supports wasm for web.
Add new methods getAppVersion and getAppBuildNumber in PlayxVersionUpdate to get the app version and build number.
Enhance compatibility with web.
Update example app to latest android version and added other platforms.
Nothing published for this version
Add namespace to build.gradle for the plugin.
namespace to build.gradle for the plugin.Enhance network requests logging in debug.
Bump Dart version to 3.2.0 and flutter to 13.16.0
Add PlatformNotSupportedError error when the platform is not supported, for example trying to use Google play in app update on IOS.
PlatformNotSupportedError error when the platform is not supported, for example trying to use Google play in app update on IOS.- Enhancements for force update.
- Initial release.
One column per quarter.