release: 9.0.0

Author: Dev-hwang

CHANGELOG.md

@@ -1,3 +1,13 @@
+## 9.0.0
+
+* [**CHORE**] Bump minimum supported SDK version to `Flutter 3.22/Dart 3.4`
+* [**CHORE**] Bump `kotlin_version(1.7.10 -> 1.9.10)`, `gradle(7.3.0 -> 8.6.0)` for Android 15
+* [**FEAT**] Add `isTimeout` param to the onDestroy callback
+* [**FIX**] Fix "null object" error [#332](https://github.com/Dev-hwang/flutter_foreground_task/issues/332)
+* [**FIX**] Fix "Reply already submitted" error [#330](https://github.com/Dev-hwang/flutter_foreground_task/issues/330)
+* [**FIX**] Prevent crash by catching exceptions during foreground service start
+* Check [migration_documentation](./documentation/migration_documentation.md) for changes
+
 ## 8.17.0
 
 * [**FEAT**] Allow `onNotificationPressed` to trigger without `SYSTEM_ALERT_WINDOW` permission

README.md

@@ -27,13 +27,20 @@ To use this plugin, add `flutter_foreground_task` as a [dependency in your pubsp
 
 ```yaml
 dependencies:
-  flutter_foreground_task: ^8.17.0
+  flutter_foreground_task: ^9.0.0
 ```
 
 After adding the plugin to your flutter project, we need to declare the platform-specific permissions ans service to use for this plugin to work properly.
 
 ### :baby_chick: Android
 
+This plugin requires `Kotlin version 1.9.10+` and `Gradle version 8.6.0+`. Please refer to the migration documentation for more details.
+
+- [project/settings.gradle](https://github.com/Dev-hwang/flutter_foreground_task/blob/master/example/android/settings.gradle)
+- [project/gradle-wrapper.properties](https://github.com/Dev-hwang/flutter_foreground_task/blob/master/example/android/gradle/wrapper/gradle-wrapper.properties)
+- [app/build.gradle](https://github.com/Dev-hwang/flutter_foreground_task/blob/master/example/android/app/build.gradle)
+- [migration_documentation](https://github.com/Dev-hwang/flutter_foreground_task/blob/master/documentation/migration_documentation.md)
+
 Open the `AndroidManifest.xml` file and declare the service tag inside the `<application>` tag as follows.
 
 If you want the foreground service to run only when the app is running, add `android:stopWithTask="true"`.

documentation/migration_documentation.md

@@ -1,5 +1,68 @@
 ## Migration
 
+### ver 9.0.0
+
+- chore: Bump minimum supported SDK version to `Flutter 3.22/Dart 3.4`.
+
+```
+environment:
+   // sdk: ">=3.0.0 <4.0.0"
+   // flutter: ">=3.10.0"
+   sdk: ^3.4.0
+   flutter: ">=3.22.0"
+```
+
+- chore: Bump `kotlin_version(1.7.10 -> 1.9.10)`, `gradle(7.3.0 -> 8.6.0)` for Android 15.
+
+```
+[android/settings.gradle]
+plugins {
+    // id "com.android.application" version "7.3.0" apply false
+    // id "org.jetbrains.kotlin.android" version "1.7.10" apply false
+    id "com.android.application" version "8.6.0" apply false
+    id "org.jetbrains.kotlin.android" version "1.9.10" apply false
+}
+
+[android/gradle/wrapper/gradle-wrapper.properties]
+// distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
+
+[android/app/build.gradle]
+android {
+    // compileSdk 34
+    compileSdk 35
+    
+    compileOptions {
+        // sourceCompatibility JavaVersion.VERSION_1_8
+        // targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_11
+        targetCompatibility JavaVersion.VERSION_11
+    }
+
+    kotlinOptions {
+        // jvmTarget = JavaVersion.VERSION_1_8
+        jvmTarget = JavaVersion.VERSION_11
+    }
+    
+    defaultConfig {
+        // targetSdkVersion 34
+        targetSdkVersion 35
+    }
+}
+```
+
+- feat: Add `isTimeout` param to the onDestroy callback.
+
+```dart
+// from
+@override
+Future<void> onDestroy(DateTime timestamp) async {}
+
+// to
+@override
+Future<void> onDestroy(DateTime timestamp, bool isTimeout) async {}
+```
+
 ### ver 8.16.0
 
 - Change `ServiceRequestResult` class to `sealed class` for improved code readability.

pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_foreground_task
 description: This plugin is used to implement a foreground service on the Android platform.
-version: 8.17.0
+version: 9.0.0
 homepage: https://github.com/Dev-hwang/flutter_foreground_task
 
 environment: