restart_app

Version 1.9.2 adds bundled package skills and hardens native restarts across Android, iOS, macOS, Linux, and Windows. Overlapping requests are rejected, failure paths preserve the running app where possible, and the documentation now describes accepted requests separately from completed restarts. The existing library SDK and OS minimums remain unchanged.

• Bundled versioned agent skills for restart integration and iOS engine configuration, installable with dart run skills@ get restart_app
• Added complete skill references for restart modes, structured results, saved state, web routes, background isolates, and iOS lifecycle and failure handling
• Return a failed MISSING_PLUGIN result when native registration is absent, and report unavailable capabilities for missing or malformed channel responses
• Reject overlapping native restart requests across plugin instances, including races between iOS engine and notification restarts; release pending state when a restart fails
• Fixed iOS engine reconfiguration retaining a previous custom view-controller installer; omitting the installer now restores the default root protection
• Restrict automatic iOS window selection to active scenes, respect a windowProvider that returns nil instead of selecting another scene, and reject unknown native restart modes
• Preserve an in-flight iOS fallback notification when another Flutter engine registers plugins
• Keep the Linux application alive if a deferred execv fails; bound saved command-line arguments by argc and release replaced argument storage
• Handle Windows relaunch scheduling failures before reporting success, and clean up the suspended child and native handles on failure
• Treat an empty macOS application launch result as a failed restart
• Migrated the iOS example to Flutter's UIScene lifecycle for current Xcode and iOS, with native regression tests for engine failures, repeated requests, and custom hosts
• Restore example controls after storage or restart failures, require successful state writes before restart, add Android release network permission, and avoid counting skipped platform probes as successful checks
• Expanded compatibility checks across minimum and current Flutter SDKs, CocoaPods and SwiftPM, and AGP 9 with and without built-in Kotlin
• Added repeated real desktop restart checks with fresh run identities, process IDs, saved state, concurrent requests, argument preservation, and failure recovery, plus Android and browser runtime probes
• Restored search, code copying, mobile navigation, and appearance controls in the static documentation site
• Updated platform limits, host configuration, SDK requirements, and skill installation guidance; the plugin's minimum Dart, Flutter, and native OS versions remain unchanged

Install the bundled skills from your Flutter project (Dart 3.12+):

flutter pub get
dart run skills@ get restart_app

Validation includes real restart applications on Android 5 and Android 17 (16 KB pages), iOS 18.5 and 27, macOS 27, Linux, and Windows; repeated restart and duplicate-request checks; saved versus in-memory state; iOS notification denial and notification-tap reopening; Windows native failure injection; Linux executable failure and recovery; and browser reload/route probes in both JavaScript and Wasm builds. Consumer builds cover selected Flutter versions from 3.22 to 3.47.5, CocoaPods, both SwiftPM generations, and AGP 9 with built-in Kotlin on and off.

These results cover the recorded simulator, emulator, browser, and desktop CI environments. They do not establish behavior on every physical/OEM device, Store/MSIX distribution, Linux distribution, or custom native host. The runtime verification guide provides reproducible checks for the application you ship.

Package · Agent skills guide

Fixes the AGP 9 build failure in 1.9.0. Projects generated by Flutter 3.44 and later use Android Gradle Plugin 9 with android.builtInKotlin=false, and 1.9.0 left that combination with no Kotlin plugin at all, so evaluation failed with Could not find method kotlin(). Upgrading is enough; no app-side change is needed.

• Fixed the Android build failing on AGP 9 with Could not find method kotlin(), which hit every project generated by Flutter 3.44 and later (#56)
• Changed how the plugin decides to apply the Kotlin Gradle Plugin: it now checks whether Kotlin has already been provided instead of reading the AGP major version, so AGP 9 with android.builtInKotlin=false gets a Kotlin toolchain like every other combination
• Kept the Android namespace unconditional now that every supported AGP requires it
• Added a CI job that builds a fresh app against AGP 9.0 and AGP 9.1 on their matching Gradle versions

Verified on AGP 8.6, 8.11, 9.0.1, 9.1.0 and 9.3.1, on Flutter 3.44 and 3.47, with built-in Kotlin both off and on.

Upgrade notes: Android minSdk rises from 16 to 21 and the Android toolchain moves to Java 17, AGP 8.1.4 and Kotlin 2.0.21; the iOS CocoaPods minimum rises from 11.0 to 12.0. Apps on older toolchains must update their build setup before upgrading. On web, the default restart now reloads the current page instead of navigating to the site origin root; pass webOrigin to keep the previous behavior.

• Changed the web default restart to reload the current page, keeping the active route instead of jumping to the origin root; webOrigin still overrides the target
• Fixed Windows so a failed relaunch (for example MSIX/Store-packaged apps) returns a RESTART_FAILED error instead of a false success; the new instance now starts suspended and only resumes after the result is delivered
• Made unknown platform response modes fall back to the requested mode instead of silently reporting platformDefault
• Hardened result parsing so non-string code, message, and reason values can never throw
• Added web plugin tests that cover the full method-channel contract, plus a Chrome test step in CI
• Added CI restart proofs that build, run, and verify a real process restart on Linux, Windows, and macOS runners
• Added explicit engine restart, force-kill restart, and webOrigin buttons to the example app
• Fixed the example Android manifest so url_launcher link checks pass on Android 11+ (package visibility <queries>)
• Removed the redundant Android finishAffinity() after the relaunch intent, which made ActivityTaskManager log a "Duplicate finish request" on every default restart
• Prepared the Android build for Flutter's Built-in Kotlin: the Kotlin Gradle Plugin is now applied only on AGP versions below 9, with modernized Kotlin 2.0 tooling
• Aligned the iOS CocoaPods minimum with Swift Package Manager at iOS 12
• Made the macOS handler hop to the main thread explicitly before touching AppKit

1.8.3

• Made Restart.restartApp(...) the single Dart restart entry point
• Changed Restart.restartApp(...) to return RestartResult, giving one call with success, resolved mode, code, and message
• Kept all restart customization on Restart.restartApp(...): mode, webOrigin, forceKill, notificationTitle, and notificationBody
• Refined the example so main.dart shows the restart calls directly, while package survival checks live in focused helper files
• Updated README and example docs so the quick start is platform-neutral and iOS details stay in the iOS section

ci: align example plugin constraints

Patch release focused on restart mode correctness and release stability.

• Fixes structured restart mode handling so unsupported modes fail instead of silently using a platform default.
• Returns resolved structured restart modes from Android, web, Linux, macOS, and Windows.
• Makes Android RestartMode.process use the full force-kill restart path automatically.
• Runs the iOS beforeRestart hook before creating the replacement FlutterEngine.
• Updates the bundled example Android Gradle project for current Java and Flutter toolchains.

Validated with flutter analyze, package and example tests, Android/iOS/web example builds, a fresh-template macOS build, native format checks, and dart pub publish --dry-run with 0 warnings.

Changes

• Added structured restart API with Restart.restart(), RestartResult, RestartMode, and Restart.restartCapability().
• Added opt-in iOS Flutter engine restart with fresh FlutterEngine creation, Dart re-run, host-owned plugin registration, root FlutterViewController replacement, and old engine teardown.
• Kept the existing iOS notification + exit(0) behavior as an explicit legacy fallback.
• Added restart capability reporting across supported platforms.
• Updated documentation and example integration to distinguish iOS engine restart from unsupported full process restart.

Verification

• flutter analyze
• flutter test
• cd example && flutter test
• dart pub publish --dry-run
• iOS no-codesign build
• web build
• Swift/Kotlin/C++ format and lint checks

Note: Android APK build is blocked locally by the existing Gradle 7.6.3 and Java 21 mismatch on this machine.

• Fixed the SwiftPM target path causing Xcode build failures (#52).

• Fixed SwiftPM file locations for iOS and macOS.

• Added Swift Package Manager support for iOS and macOS.

• Added Linux and Windows support.
• Added Android TV and Fire TV support.
• Changed native failures to return false instead of throwing PlatformException.
• Added automated checks and unit tests.

• Added native macOS app relaunch support.

• Fixed Android FlutterJNI errors by delivering the result before tearing down the engine.
• Lowered the Dart minimum to 3.4.0 (Flutter 3.22 or later).
• Corrected iOS setup instructions and documented background-isolate use.

• Added Android forceKill and fixed iOS notification relaunch.
• Breaking change on iOS: denied notification permission now throws PlatformException with code NOTIFICATION_DENIED.
• Removed the unused plugin_platform_interface dependency and corrected package metadata and examples.

• Fixed web argument parsing crashes (#35, #51) and hash routing (#14).
• Fixed Android crashes when no launch intent is available (#50).
• Fixed iOS restartApp() always returning false (#48).

• Updated to the stable web package.

• Updated JVM, Kotlin, and web dependencies; resolved Firebase dependency conflicts.

• Added custom iOS notification titles and messages.
• Added web WebAssembly support.
• Updated Android namespace, Kotlin, and activity handling.

• Added API documentation.

• Added iOS support.

• Updated to Flutter 3.10 and refreshed the example.

• Updated to Flutter 3.7.

• Documented iOS support.

• Updated Gradle.

• Updated to Flutter 3.0.

• Added web support.

• Updated the README version.

• Updated the package name in examples.

• Updated the package name.

• Added null safety.