launch_mode 0.2.0

Automatic launch modes for Flutter root and child isolates, with scoped background handler contexts and explicit initialization when needed.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.2.0 - 2026-09-14

Added

• LaunchMode.initializeAutomatically() for synchronous detection of Flutter root and child isolates, preserving existing explicit modes and background scopes. Flutter Web selects foreground without reading the root isolate token.
• LaunchMode.withBackgroundMode() for background contexts that survive async work without changing the isolate's base mode or concurrent foreground work.
• Firebase Messaging, Workmanager, and native worker examples, plus native and browser regression tests for automatic initialization and background scopes.

Changed

• Breaking: Version 0.2.0 requires Flutter SDK 3.10.0 or later. Standalone Dart applications must stay on 0.1.0. The Dart SDK minimum remains 3.0.0.
• Getters and explicit initialization now respect the active background scope.
• Replaced the console example with a runnable Flutter Web application.

0.1.0 - 2026-09-14

Added

• LaunchModeType with unspecified, foreground, background, and isolate modes.
• Synchronous LaunchMode.initialize with one mode per isolate. Repeating the same mode is allowed; conflicting modes throw StateError, and unspecified throws ArgumentError without changing the current mode.
• LaunchMode.current, isInitialized, isForeground, isBackground, and isIsolate for selecting application logic by launch mode.
• A pure Dart library compatible with Flutter and Web, with no runtime dependencies.
• Entry point examples, lifecycle and Web guidance, strict analyzer configuration, and regression tests for initialization and isolate independence.