fix: Android initialization bug and iOS 14 availability annotations

CLAUDE.md

@@ -1,3 +1,12 @@
+## Version Management
+- **DO NOT manually edit CHANGELOG.md files** - Melos handles changelog generation automatically
+- **Use semantic commit messages** for proper versioning:
+  - `fix:` for bug fixes (patch version bump)
+  - `feat:` for new features (minor version bump) 
+  - `BREAKING CHANGE:` or `!` for breaking changes (major version bump)
+  - Example: `fix: prevent iOS build errors with Logger availability`
+- Melos will generate changelog entries from commit messages during release
+
 ## Pre-Commit Requirements
 **CRITICAL**: Always run from project root before ANY commit:
 1. `dart analyze` (check for code errors)

docs/quickstart.mdx

@@ -23,6 +23,15 @@ flutter pub get
 Android works automatically - no additional setup required! ✅
 
 ### iOS
+
+<Warning>
+**iOS Minimum Deployment Target:** iOS 14.0 or later is required. Update your project's deployment target in Xcode:
+1. Open `ios/Runner.xcodeproj` in Xcode
+2. Select the Runner target
+3. Set "Minimum Deployments" to iOS 14.0 or later
+4. Or edit `ios/Runner.xcodeproj/project.pbxproj` and set `IPHONEOS_DEPLOYMENT_TARGET = 14.0;`
+</Warning>
+
 iOS requires a 5-minute setup in Xcode. Choose your approach based on your needs:
 
 #### Option A: Periodic Tasks (Recommended for most use cases)

workmanager_android/android/src/main/kotlin/dev/fluttercommunity/workmanager/WorkmanagerPlugin.kt

@@ -47,7 +47,14 @@ class WorkmanagerPlugin :
         callback: (Result<Unit>) -> Unit,
     ) {
         try {
-            preferenceManager.saveCallbackDispatcherHandleKey(request.callbackHandle)
+            val handle = request.callbackHandle
+
+            // Save to SharedPreferences
+            preferenceManager.saveCallbackDispatcherHandleKey(handle)
+
+            // Update the local variable to match
+            currentDispatcherHandle = handle
+
             callback(Result.success(Unit))
         } catch (e: Exception) {
             callback(Result.failure(e))

workmanager_android/android/src/main/kotlin/dev/fluttercommunity/workmanager/pigeon/WorkmanagerApi.g.kt

@@ -1,7 +1,7 @@
 // // Copyright 2024 The Flutter Workmanager Authors. All rights reserved.
 // // Use of this source code is governed by a MIT-style license that can be
 // // found in the LICENSE file.
-// Autogenerated from Pigeon (v26.0.0), do not edit directly.
+// Autogenerated from Pigeon (v26.0.1), do not edit directly.
 // See also: https://pub.dev/packages/pigeon
 @file:Suppress("UNCHECKED_CAST", "ArrayInDataClass")
 

workmanager_apple/ios/Sources/workmanager_apple/LoggingDebugHandler.swift

@@ -3,7 +3,9 @@ import os
 
 /**
  * A debug handler that outputs debug information to iOS's unified logging system.
+ * Note: This class requires iOS 14.0 or later due to the use of os.Logger.
  */
+@available(iOS 14.0, *)
 public class LoggingDebugHandler: WorkmanagerDebug {
     private let logger = os.Logger(subsystem: "dev.fluttercommunity.workmanager", category: "debug")
 

workmanager_apple/ios/Sources/workmanager_apple/pigeon/WorkmanagerApi.g.swift

@@ -1,7 +1,7 @@
 // // Copyright 2024 The Flutter Workmanager Authors. All rights reserved.
 // // Use of this source code is governed by a MIT-style license that can be
 // // found in the LICENSE file.
-// Autogenerated from Pigeon (v26.0.0), do not edit directly.
+// Autogenerated from Pigeon (v26.0.1), do not edit directly.
 // See also: https://pub.dev/packages/pigeon
 
 import Foundation

workmanager_platform_interface/lib/src/pigeon/workmanager_api.g.dart

@@ -1,7 +1,7 @@
 // // Copyright 2024 The Flutter Workmanager Authors. All rights reserved.
 // // Use of this source code is governed by a MIT-style license that can be
 // // found in the LICENSE file.
-// Autogenerated from Pigeon (v26.0.0), do not edit directly.
+// Autogenerated from Pigeon (v26.0.1), do not edit directly.
 // See also: https://pub.dev/packages/pigeon
 // ignore_for_file: public_member_api_docs, non_constant_identifier_names, avoid_as, unused_import, unnecessary_parenthesis, prefer_null_aware_operators, omit_local_variable_types, unused_shown_name, unnecessary_import, no_leading_underscores_for_local_identifiers