fix: Android initialization bug and iOS 14 availability annotations (#647)

* fix: Android initialization bug and iOS 14 availability annotations

- Fix Android PlatformException on first run after initialize (fixes #645)
  - Update currentDispatcherHandle when initialize() is called
  - Add validation for callback handle
- Add iOS 14.0 availability annotation to LoggingDebugHandler (fixes #641)
  - Prevents build errors when os.Logger is used
- Update documentation with iOS 14.0 minimum deployment target requirement (fixes #639)

Co-Authored-By: Claude <[email protected]>

* docs: add version management guidelines for melos workflow

* chore: regenerate pigeon files after pub upgrade

* fix: remove invalid handle validation that was rejecting valid callback handles

The handle validation was too strict and incorrectly rejected valid callback
handles (including 0) which caused all initialize calls to fail in integration tests

---------

Co-authored-by: Claude <[email protected]>

Author: ened

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