Merge pull request #1 from okmsbun/develop

Develop

Author: okmsbun

CHANGELOG.md

@@ -1,3 +1,6 @@
+## 0.4.0
+App change events now forward the raw Android action string to Dart, which maps it to AppChangeType without breaking existing API.
+
 ## 0.2.0
 - Enhanced README.md with professional badge layout for better package visibility
 - Added centered HTML badges for pub.dev, GitHub stars, Flutter documentation, and MIT license

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 okmsbun
+Copyright (c) 2026 okmsbun
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -16,107 +16,6 @@ This package defines the common API contract (Dart side) that all platform imple
 
 ---
 
-## ✨ What it provides
+## License
 
-* `AppInfo` model → metadata for installed apps (package name, version, install/update times, system flag, optional icon bytes).
-* `AppChangeEvent` model → events for install, uninstall, update.
-* `FlutterDeviceAppsPlatform` abstract class → base interface every platform package must extend.
-  - `listApps()` - List installed applications
-  - `getApp()` - Get details for a specific app
-  - `openApp()` - Launch an application
-  - `openAppSettings()` - Open app settings page
-  - `uninstallApp()` - Uninstall an application
-  - `getInstallerStore()` - Get installer store information
-  - `appChanges` - Stream of app change events
-  - `startAppChangeStream()` / `stopAppChangeStream()` - Control event monitoring
-
----
-
-## 🚫 When NOT to use this package
-
-You should **not** depend on this package directly in your Flutter apps.
-
-Instead, use the umbrella package:
-
-```yaml
-dependencies:
-  flutter_device_apps: latest_version
-```
-
-This interface is only intended for platform implementors (e.g. `flutter_device_apps_android`).
-
----
-
-## 🛠 For platform implementors
-
-To add support for a new platform:
-
-1. Create a new package (e.g. `flutter_device_apps_linux`).
-
-2. Add a dependency on this package:
-
-   ```yaml
-   dependencies:
-     flutter_device_apps_platform_interface: latest_version
-   ```
-
-3. Extend `FlutterDeviceAppsPlatform` and override the required methods:
-
-   ```dart
-   class FlutterDeviceAppsLinux extends FlutterDeviceAppsPlatform {
-     @override
-     Future<List<AppInfo>> listApps({bool includeSystem = false, bool onlyLaunchable = true, bool includeIcons = false}) {
-       // implement using Linux APIs
-     }
-
-     @override
-     Future<AppInfo?> getApp(String packageName, {bool includeIcon = false}) {
-       // implement
-     }
-
-     @override
-     Future<bool> openApp(String packageName) {
-       // implement
-     }
-
-     @override
-     Future<bool> openAppSettings(String packageName) {
-       // implement - open app settings page
-     }
-
-     @override
-     Future<bool> uninstallApp(String packageName) {
-       // implement - uninstall app
-     }
-
-     @override
-     Future<String?> getInstallerStore(String packageName) {
-       // implement - get installer store information
-     }
-
-     @override
-     Stream<AppChangeEvent> get appChanges => _streamController.stream;
-
-     @override
-     Future<void> startAppChangeStream() async {
-       // setup listener
-     }
-
-     @override
-     Future<void> stopAppChangeStream() async {
-       // tear down listener
-     }
-   }
-   ```
-
-4. Register your implementation by setting:
-
-   ```dart
-   FlutterDeviceAppsPlatform.instance = FlutterDeviceAppsLinux();
-   ```
-
----
-
-## 📄 License
-
-MIT © 2025 okmsbun
+MIT © 2026 okmsbun

lib/flutter_device_apps_platform_interface.dart

@@ -128,20 +128,10 @@ abstract class FlutterDeviceAppsPlatform extends PlatformInterface {
   ///
   /// Platform implementations should emit [AppChangeEvent] objects when apps
   /// are installed, removed, or updated on the device.
-  /// Call [startAppChangeStream] to begin receiving events.
-  Stream<AppChangeEvent> get appChanges;
-
-  /// Starts monitoring for app change events.
-  ///
-  /// Call this method to begin receiving app change events via [appChanges] stream.
-  /// Platform implementations should set up necessary listeners or broadcast receivers.
-  Future<void> startAppChangeStream();
-
-  /// Stops monitoring for app change events.
   ///
-  /// Call this method to stop receiving app change events and clean up resources.
-  /// Platform implementations should remove listeners or unregister broadcast receivers.
-  Future<void> stopAppChangeStream();
+  /// The stream automatically starts listening when the first subscriber is added
+  /// and stops when all subscribers are removed (broadcast stream behavior).
+  Stream<AppChangeEvent> get appChanges;
 
   /// Opens the app settings for the specified package name.
   ///
@@ -186,14 +176,6 @@ class _UnimplementedPlatform extends FlutterDeviceAppsPlatform {
   Stream<AppChangeEvent> get appChanges =>
       Stream.error(UnsupportedError('FlutterDeviceAppsPlatform not implemented'));
 
-  @override
-  Future<void> startAppChangeStream() =>
-      Future.error(UnsupportedError('FlutterDeviceAppsPlatform not implemented'));
-
-  @override
-  Future<void> stopAppChangeStream() =>
-      Future.error(UnsupportedError('FlutterDeviceAppsPlatform not implemented'));
-
   @override
   Future<bool> openAppSettings(String packageName) =>
       Future.error(UnsupportedError('FlutterDeviceAppsPlatform not implemented'));

pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_device_apps_platform_interface
 description: Platform-agnostic API contract for flutter_device_apps (federated).
-version: 0.2.0
+version: 0.4.0
 repository: https://github.com/okmsbun/flutter_device_apps_platform_interface
 issue_tracker: https://github.com/okmsbun/flutter_device_apps_platform_interface/issues
 topics: