floaty_chatheads_android 2.0.0

Android implementation of floaty_chatheads with SYSTEM_ALERT_WINDOW, foreground service, spring physics, theming, and TalkBack accessibility.

Changelog

2.0.0

Released as part of the floaty_chatheads 2.0 line. See the main package CHANGELOG for the full migration guide.

⚙ Toolchain (BREAKING)

• Android minSdk raised to 24 (was 23).
• compileSdk bumped to 35 (Android 15).
• Plugin Java/Kotlin JVM target raised to 11 (was 1.8).
• Dart SDK floor ^3.0.0, Flutter floor >=3.10.0 — the bare minimum the Dart code requires (final class, sealed class, records, pattern matching). The Kotlin Gradle setup stays on the legacy apply plugin: 'kotlin-android' + kotlinOptions { ... } pattern so it works on every Flutter version with Kotlin support.
• Pigeon constraint normalized to ^26.3.3.
• Depends on floaty_chatheads_platform_interface: ^2.0.0.

ℹ Built-in Kotlin migration deferred

android/build.gradle keeps the legacy pattern:

plugins {
    id "com.android.library"
    id "kotlin-android"
}

android {
    // ...
    kotlinOptions {
        jvmTarget = '11'
    }
}

Switching to Flutter's Built-in Kotlin pattern (top-level kotlin { compilerOptions { … } } and conditional KGP application) would require Kotlin Gradle Plugin 2.0+, which Flutter only ships starting at 3.27. Adopting it would lock out every consumer on Flutter 3.10–3.26 just to silence one warning.

On Flutter 3.44+ you will see:

WARNING: Your app uses the following plugins that apply Kotlin Gradle Plugin (KGP): floaty_chatheads_android, …

That's intentional. When Flutter promotes the warning to a hard error, this plugin will migrate to Built-in Kotlin in a major release; until then, compatibility with the 3.10–3.43 install base is the priority. See https://docs.flutter.dev/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors for the migration path.

♻ Internals

• showChatHead now delegates default-value resolution to ChatHeadConfigResolver in floaty_chatheads_platform_interface, eliminating duplication with the iOS Dart shim. Pigeon enum/message construction stays in this package.

1.1.0

✨ Enhancements

• Widget-based chathead icons. The chathead bubble icon can now be any Flutter widget (rendered to an image via the Dart offscreen pipeline). Supports static widgets and animated widgets with per-frame RGBA updates through the new updateChatHeadIcon Pigeon method. Bitmap creation from RGBA bytes runs on Dispatchers.Default to keep the main thread free.
• Widget-based close icons. The close target icon and background can also be Flutter widgets. Widget-rendered close icons are scaled to the full close-target size (64 dp) instead of the 28 dp default, so the widget design controls the visual appearance.
• Added closeIconIsWidget / closeBackgroundIsWidget flags to OverlayConfig for size-aware scaling in Close.kt.

📦 Dependencies

• Bumped floaty_chatheads_platform_interface to ^1.0.5.

1.0.7

✨ Enhancements

• Added autoLaunchOnBackground support. The plugin registers Application.ActivityLifecycleCallbacks to detect when all activities leave the foreground. When enabled, the chathead is shown automatically on background and dismissed on foreground.
• Added persistOnAppClose support. Controls whether the foreground service returns START_STICKY (survives app death) or START_NOT_STICKY (stops on main app disconnect). When disabled, the service calls closeWindow(true) as soon as the main app disconnects.
• Both new flags are persisted to SharedPreferences for recovery after a START_STICKY restart.

⚡ Performance

• Migrated from ExecutorService to Kotlin Coroutines. All icon I/O (asset, network, byte-array decoding) now runs on Dispatchers.IO via structured async/await, replacing the previous ExecutorService + Callable approach. The main thread is never blocked — each icon load has an individual withTimeoutOrNull guard.
• Added CoroutineScope lifecycle management. A SupervisorJob-backed scope (pluginScope) is created in onAttachedToEngine and cancelled in onDetachedFromEngine, ensuring all in-flight coroutines are cleaned up when the plugin is detached.

🐛 Bug Fixes

• Fixed chathead freeze caused by async race condition. showChatHead and addChatHead are now @async Pigeon methods. The Dart Future resolves only after the overlay window is fully created, preventing the half-initialized state that caused the overlay to appear frozen.

📦 Dependencies

• Added kotlinx-coroutines-android:1.7.3.

1.0.6

🐛 Bug Fixes

• Fixed CompletableFuture crash on Android 6.0 (API 23). CompletableFuture.supplyAsync requires API 24+, but the module's minSdkVersion is 23. Replaced with ExecutorService + Callable (available since API 1) for parallel icon loading.
• Fixed resource leak in loadBitmapFromNetwork. InputStream and HttpURLConnection are now released via use { } and a finally block, ensuring cleanup even if BitmapFactory.decodeStream throws.

1.0.5

🐛 Bug Fixes

• Fixed chathead close crash when GPS streaming is active. Removing the FlutterView from its parent during the drag-to-close gesture while the overlay engine was still processing GPS data caused a 300ms window of orphaned rendering. The redundant content.removeAllViews() call was removed — closeWindow(true) already handles cleanup via detachEngine().
• Fixed foreground service not stopping after chathead close. The destroyEngine() call threw an exception (self-destructing engine from Pigeon handler), preventing stopSelf() from being reached. Reordered service teardown so stopForeground() and stopSelf() execute before destroyEngine(), with the latter wrapped in a try/catch.
• Fixed NPE in hideChatHeads delayed callback. Replaced FloatyContentJobService.instance!! force-unwrap with safe call ?. to handle cases where the service is already destroyed.

✨ Enhancements

• Deferred connection signal on app restart. onAttachedToEngine no longer sends connected:true to the overlay immediately when an existing service is detected. Instead it sets up the message relay via onMainAppRelay() and defers the connection signal until isChatHeadActive() is called from the Dart side — acting as an implicit "ready" signal that guarantees channel handlers are registered before the overlay flushes its action queue.
• Native close notification to main app. When the chathead is closed via drag-to-close or the overlay's close button, the native layer now sends a system envelope message to the main Dart isolate so FloatyChatheads.onClosed fires reliably.
• Extracted magic delay constants. Replaced inline delay numbers with named companion-object constants (CLOSE_DELAY_MS, HIDE_DELAY_MS, EXPAND_CONTENT_DELAY_MS).
• Improved null safety in onSpringUpdate. Replaced ~10 topChatHead!! force-unwraps with a safe local binding.
• DRY: consolidated hideChatHeads(). Merged two near-identical branches into a single method with an isClosed parameter.
• DRY: extracted notifyOverlay() helper. Consolidated 5 repeated Pigeon notification methods into a single inline function.
• Added NotificationConfig.description support. The foreground notification now shows a custom title and body text when description is provided.

1.0.4

🐛 Bug Fixes

• Fixed overlay ↔ main app communication completely broken. When FlutterEngineGroup.createAndRunEngine() creates the overlay engine, it auto-registers all plugins — including FloatyChatheadsPlugin. This second onAttachedToEngine call overwrote the companion-object activeInstance and mainMessenger with the overlay engine's instances, causing all messages from the overlay to loop back to the overlay instead of reaching the main Dart isolate. Added an activeInstance != null guard in onAttachedToEngine to skip setup on the overlay engine, and a matching isMainEnginePlugin guard in onDetachedFromEngine to prevent the overlay engine from tearing down the main engine's state.

📦 Metadata

• Shortened pubspec description to meet pub.dev 60–180 character guideline.
• Added example/example.md for the pub.dev example tab.

1.0.3

✨ Enhancements

• Upgraded Pigeon to 26.2.3. Regenerated all Dart and Kotlin Pigeon bindings. No API surface changes — the upgrade picks up codec and code-generation improvements from the latest Pigeon release.

1.0.2

✨ Enhancements

• Debug logs are now optional and silent by default. All native Log.d/w/e output is gated behind Managment.debugMode. Developers enable verbose logging by setting debugMode: true in ChatHeadConfig; production builds produce zero log noise. Three convenience helpers (Managment.logD, logW, logE) replace every raw Log.* call across FloatyContentJobService, FlutterContentPanel, and ChatHeads.

🐛 Bug Fixes

• Fixed content panel rendering fullscreen on subsequent launches. The root cause was a two-stage data loss: when the service had not started yet, showChatHead() only persisted the entry point to SharedPreferences, omitting content dimensions and all other config. When the service's onCreate() later called restoreConfig(), it overwrote the in-memory Managment values with null, causing createWindow() to skip setContentSize() and fall back to MATCH_PARENT. The fix saves the full config to SharedPreferences in the plugin's else branch and adds a defensive guard in onCreate() to skip restoreConfig() when Managment is already populated.
• Fixed content panel dimensions and touch interaction leaking between chathead sessions. The plugin now explicitly tears down stale windows and calls createWindow() directly with fresh Managment values instead of deferring to onStartCommand().

1.0.1

• Documentation and metadata updates.

1.0.0

🎉 Initial Release

• Android implementation of floaty_chatheads using SYSTEM_ALERT_WINDOW.
• Pigeon-generated type-safe Dart ↔ Kotlin communication.
• Facebook Rebound spring physics for bubble drag and snap animations.
• Foreground service with configurable notification.
• Separate FlutterEngine for overlay content panels.
• Theming support: badge colors, bubble border, shadow, close tint.
• Overlay palette delivery to Flutter overlay isolate.
• Size preset resolution with half-screen and full-screen sentinels.
• Debug overlay view with bounds, spring HUD, FPS counter, and Pigeon message log.
• Full TalkBack accessibility: content descriptions, state announcements, focus management, and custom accessibility actions.
• Snap-to-edge with configurable margin and position persistence.
• Entrance animations: slide-in and fade-in variants.
• Badge counter updates from both main app and overlay.
• Programmatic expand / collapse.