Skip to main content

in_app_update_flutter 4.1.3 copy "in_app_update_flutter: ^4.1.3" to clipboard
in_app_update_flutter: ^4.1.3 copied to clipboard

A Flutter plugin to prompt users for in-app updates using StoreKit on iOS and Play Core API on Android.

4.1.3 #

  • Fixed checkUpdateIos hanging when StoreKit never returns the storefront. Storefront.current has no timeout of its own. The plugin now waits at most 10 seconds and then throws a PlatformException with code STOREFRONT_UNAVAILABLE.
  • Fixed showUpdateForIos hanging when StoreKit never finishes loading the product. The plugin now waits at most 10 seconds and then throws a PlatformException with code STORE_NOT_LOADED. A load that finishes after the timeout no longer presents the App Store sheet, and a stuck StoreKit callback no longer keeps the caller or the store view controller in memory.
  • Fixed installStateStreamAndroid dropping events with more than one listener. Each access returned a new stream, so a second listener cut off the first and cancelling either one stopped events for both. The getter now returns one shared broadcast stream: every listener gets every event, and events keep flowing until the last listener cancels.
  • README: noted the 10-second timeouts under STORE_NOT_LOADED and STOREFRONT_UNAVAILABLE, and that installStateStreamAndroid can have several listeners.

4.1.2 #

  • Moved the repository, homepage and issue tracker to github.com/meagarwalpulkit/in_app_update_flutter.
  • README: the screenshots now render at the same size on GitHub and pub.dev.

4.1.1 #

  • Fixed showUpdateForIos hanging when called again before the first call finished. A second call overwrote the first call's result, so the first Future never completed. Each call now completes exactly once, and a call made while an App Store sheet is already loading or on screen throws a PlatformException with code ALREADY_RUNNING, matching Android. The plugin also no longer presents onto a view controller that is mid-transition and throws NO_VIEW_CONTROLLER instead.
  • Fixed installStateStreamAndroid missing or duplicating events. Listening while no Activity was attached gave a stream that never emitted, and cancelling after the Activity detached left the listener registered, so the next listen delivered every event twice. The listener also leaked when the Flutter engine was destroyed. The plugin now keeps the update manager for the engine's lifetime and unregisters the listener on cancel, on re-listen and on engine detach.
  • Supported Flutter 3.50: the plugin's build now uses AGP 9.1.1, and the example app uses Gradle 9.5.0 and package:material_ui.
  • README: added ALREADY_RUNNING to the iOS error codes.

4.1.0 #

  • Migrated the Android plugin to built-in Kotlin (AGP 9). The plugin no longer applies the kotlin-android Gradle plugin, so it builds on Android Gradle Plugin 9 with android.builtInKotlin=true (the default) as well as with built-in Kotlin turned off. The plugin's build now uses AGP 9.1.0 and Kotlin 2.4.0.
  • Raised the minimum supported versions to Flutter 3.44 and Dart 3.12.
  • Updated the example app to AGP 9.1.0, Gradle 9.3.1 and Kotlin 2.4.0.

4.0.0 #

  • Added checkUpdateIos() to check whether a newer version of your app is on the App Store. It looks the app up by bundle ID in the device's App Store storefront, compares versions numerically, and returns an AppUpdateInfoIos with an UpdateAvailabilityIos value (updateAvailable, updateNotAvailable, installedNewer or updateIncompatible) plus the App Store ID ready for showUpdateForIos. Failures throw a PlatformException with code MISSING_BUNDLE_ID, STOREFRONT_UNAVAILABLE, NETWORK_ERROR, HTTP_ERROR, INVALID_RESPONSE, APP_NOT_FOUND or INVALID_VERSION. Calling it on a platform other than iOS throws UnsupportedError.
  • BREAKING: Removed showUpdate(), deprecated since 2.0.0. Use showUpdateForIos() on iOS, and checkUpdateAndroid() with startImmediateUpdateAndroid() or startFlexibleUpdateAndroid() on Android.
  • README: documented checkUpdateIos(), its fields, error codes, limitations and privacy, and added it to the features list and comparison table.

3.0.1 #

  • Fixed Android install statuses being decoded incorrectly. InstallStatusAndroid now uses Play Core's actual InstallStatus values. Previously a failed update was reported as installing, a canceled one as installed, and real installing/installed states as unknown. This affects both installStateStreamAndroid events and AppUpdateInfoAndroid.installStatus.
  • Fixed startImmediateUpdateAndroid and startFlexibleUpdateAndroid hanging when Google Play doesn't start the update flow. They now throw a PlatformException with code UPDATE_NOT_STARTED when Play declines to start the flow, or START_UPDATE_FAILED when launching it throws (the message is in details). Previously the future never completed, every later start call failed with ALREADY_RUNNING, and a launch exception could crash the app.
  • Moved the Android plugin package from tech.axions.in_app_update_flutter to me.pulkitagarwal.in_app_update_flutter. Flutter's generated plugin registration picks this up automatically; it only affects native Android code or ProGuard/R8 rules that reference InAppUpdateFlutterPlugin by its fully qualified name.
  • Moved the repository, homepage and issue tracker to github.com/buildwithpulkit/in_app_update_flutter, and updated the author and license holder to Pulkit Agarwal.
  • README: added an Error Handling section listing every Android and iOS error code and an InstallStateAndroid fields table, fixed the flexible update example (state.installStatus → state.status), and listed inAppUpdateFailed as a possible immediate update result.

3.0.0 #

  • Fixed iOS showUpdateForIos always failing with STORE_NOT_LOADED. The App Store ID is now passed to StoreKit as an NSNumber (as required by SKStoreProductParameterITunesItemIdentifier) instead of a String, so the App Store overlay loads correctly.
  • Fixed the App Store overlay failing to present because the view controller was captured (and often nil) at plugin registration. It is now resolved at call time via the active window scene.
  • Added distinct error codes for clearer diagnostics: INVALID_APP_STORE_ID (non-numeric ID) and NO_VIEW_CONTROLLER (nothing available to present from), separate from STORE_NOT_LOADED.
  • BREAKING: Raised the minimum supported iOS version from 12.0 to 13.0.

2.0.3 #

  • Fixed README screenshots not rendering on pub.dev by using absolute GitHub raw URLs

2.0.2 #

  • Added homepage and issue_tracker fields to pubspec.yaml for pub.dev sidebar links
  • Updated pub.dev topics for better discoverability.
  • Updated screenshots for Android immediate and flexible update flow

2.0.1 #

  • Added pub.dev screenshots for iOS, Android immediate, and Android flexible update flows
  • Updated package description to reflect both iOS (StoreKit) and Android (Play Core) support
  • Updated repository URL and author to Axions

2.0.0 #

  • Added Android in-app updates support via Google Play's In-App Updates API
  • Added checkUpdateAndroid() to retrieve update availability and metadata
  • Added startImmediateUpdateAndroid() for full-screen, blocking update flow
  • Added startFlexibleUpdateAndroid() for background download update flow
  • Added completeUpdateAndroid() to apply a downloaded flexible update
  • Added installStateStreamAndroid stream for monitoring flexible update download progress
  • Added AppUpdateInfoAndroid, InstallStateAndroid, InstallStatusAndroid, UpdateAvailabilityAndroid, and UpdateResultAndroid models
  • Renamed showUpdate() to showUpdateForIos() (old method is deprecated)
  • Updated Android toolchain to latest stable versions

1.0.4 #

  • Added Swift Package Manager (SPM) support for iOS while maintaining CocoaPods backward compatibility
  • Restructured iOS plugin sources into SPM-compatible directory layout
  • Updated podspec metadata (version, summary, description, homepage, author)
  • Enabled PrivacyInfo.xcprivacy resource bundle
  • Fixed iOS unit tests to match actual plugin API
  • Shortened package description to meet pub.dev requirements

1.0.3 #

  • Restructured plugin with federated architecture pattern

1.0.2 #

  • Updated README and package metadata

1.0.1 #

  • Minor documentation fixes

1.0.0 #

  • Initial release: iOS in-app update support via SKStoreProductViewController (StoreKit)