app_intents

Two follow-ups to the AppIntentsBridge distribution work in v0.14.0. If you added the Swift package by path in 0.14.0, see Migration below.

app_intents

Fix: import AppIntentsBridge did not resolve on the CocoaPods route (#105)

app_intents_bridge.podspec had no s.module_name, so CocoaPods derived the module name from s.name and emitted framework module app_intents_bridge. Every generate_widget_swift output opens with import AppIntentsBridge, so the generated code could not be built as generated by a CocoaPods consumer.

The failure was easy to misread: the import line itself often reported nothing, and only the types surfaced, as Cannot find 'AppIntentsEntityCache' in scope.

Fixed by declaring s.module_name = 'AppIntentsBridge'. All three routes now take the same import line. Verified against the generated modulemap, which now reads framework module AppIntentsBridge.

AppIntentsBridge is now a product of the plugin's own Swift package

v0.14.0 recommended adding the bridge from ios/.symlinks/plugins/…, but .symlinks is created only by flutter_install_all_ios_pods while CocoaPods evaluates a Podfile. An app that had migrated to Swift Package Manager and run pod deintegrate — which the Flutter tool itself suggests once every plugin is a Swift Package — had no version-following local path at all, and was left with .package(url:), the one route that is not pinned to the pub version.

AppIntentsBridge is now a second product of the plugin's own Swift package, so the recommended route is:

File → Add Package Dependencies… → Add Local… → ios/Flutter/ephemeral/Packages/.packages/app_intents → add the AppIntentsBridge library

Flutter's Swift Package Manager integration generates that symlink, so the path needs no Podfile and survives app_intents upgrades. Add only AppIntentsBridge to an extension target — the sibling app-intents library links Flutter.

It has to be that package rather than a sibling directory: Xcode normalizes local-package paths lexically, so …/.packages/app_intents/../AppIntentsBridge collapses to .packages/AppIntentsBridge and fails to resolve.

The CocoaPods pod and the root-manifest .package(url:) route are otherwise unchanged. app_intents.podspec still globs app_intents/Sources/app_intents/** only, so the two pods carry no duplicate symbols.

Migration

If you added the Swift package by path in 0.14.0 (ios/.symlinks/plugins/app_intents/ios/AppIntentsBridge), re-point it at ios/Flutter/ephemeral/Packages/.packages/app_intents and select the AppIntentsBridge library.

CocoaPods and .package(url:) users need no change beyond the version bump — though CocoaPods users can now drop any import app_intents_bridge workaround.

app_intents_codegen / app_intents_annotations

No code changes; released in lockstep.

Also in this release

The example app gained a real TaskWidget app-extension target. app/ios/TaskWidget was previously a bare directory of generated Swift verified only by swiftc -typecheck; it now compiles in a genuine extension target, links the AppIntentsBridge product over the path above, and carries its own App Groups entitlement — so the downstream integration story is exercised on every example-app build.

Note for contributors: swift test in the bridge directory is gone. The plugin's package is iOS-only because it links Flutter, so the Swift tests run via xcodebuild test -scheme AppIntentsBridge on a simulator, which is what CI already did.

Full Changelog: v0.14.0...v0.15.0

• Fix: on the CocoaPods route the module was named app_intents_bridge, so import AppIntentsBridge did not resolve (#105). app_intents_bridge.podspec now declares s.module_name = 'AppIntentsBridge', so all three routes take the same import line — the one every generate_widget_swift output emits. The old failure was easy to misread: the import itself often reported nothing and only the types surfaced, as Cannot find 'AppIntentsEntityCache' in scope. Verified by reading the generated modulemap, which now says framework module AppIntentsBridge.

• AppIntentsBridge is now a second product of the plugin's own Swift package rather than a separate package beside it (#102 follow-up). This is what lets an app that has moved off CocoaPods reach it: Flutter's Swift Package Manager integration symlinks each plugin at ios/Flutter/ephemeral/Packages/.packages/<plugin_name>, which is the only stable path a downstream Xcode project can name, and Xcode normalizes local-package paths lexically so a ../ hop out of that symlink does not resolve. The recommended route is now:

  File → Add Package Dependencies… → Add Local… → ios/Flutter/ephemeral/Packages/.packages/app_intents → add the AppIntentsBridge library (not app-intents, which links Flutter).

  The path needs no Podfile, and it survives app_intents upgrades. The CocoaPods pod and the root-manifest .package(url:) route are unchanged and still work.

  Migration: if you added the package by path in 0.14.0 (ios/.symlinks/plugins/app_intents/ios/AppIntentsBridge), re-point it at ios/Flutter/ephemeral/Packages/.packages/app_intents and select the AppIntentsBridge library. CocoaPods and .package(url:) users need no change beyond the version bump.

app_intents

• Fix: AppIntentsBridge could not be reached from a downstream app (#102). The Swift package now ships inside the pub package at ios/AppIntentsBridge/, so import AppIntentsBridge — which the generate_widget_swift output requires — resolves without a separately versioned dependency. Three consumption routes, all building the same sources:

  Route	How
  Local Swift package (recommended, projects with a Podfile)	File → Add Package Dependencies… → Add Local… → ios/.symlinks/plugins/app_intents/ios/AppIntentsBridge
  CocoaPods	pod 'app_intents_bridge', :path => '.symlinks/plugins/app_intents/ios'
  Remote Swift package (required for Podfile-less SPM projects)	https://github.com/touyou/flutter_intents → AppIntentsBridge

  A new standalone app_intents_bridge podspec carries no Flutter dependency, so an App Extension target — which must not link Flutter and therefore sits outside flutter_install_all_ios_pods — can take it. app_intents.podspec deliberately does not include these sources, so a target may take both pods without duplicate symbols. The repository root Package.swift keeps the same AppIntentsBridge product, so existing .package(url:) consumers are unaffected.

  Previously the package lived only in the repository's ios-spm/ subdirectory, which neither pub nor CocoaPods shipped and which SPM cannot resolve over a Git URL — a Widget Extension target failed with No such module 'AppIntentsBridge'.

• Docs: AppIntentsEntityCacheKey.forEntity now states that its result is the cache key, not the raw UserDefaults key. The plugin namespaces it as app_intents.<storageIdentifier>.cache.<cacheKey>; reading with the un-namespaced key returns nil silently, which only surfaces as an empty widget configuration picker. Same note added to docs/usage.md / docs/usage.ja.md.

app_intents_codegen

• Widens the analyzer constraint to >=7.0.0 <15.0.0, so the package can be used alongside analyzer 14.x. Verified against analyzer 14.1.0 / _fe_analyzer_shared 105.0.0: analysis clean, full test suite passing, and build_runner, generate_swift, generate_widget_swift and generate_kotlin all producing byte-identical output to the 13.x resolution.
• Bumps app_intents_annotations to ^0.14.0.

app_intents_annotations

• No user-facing changes; released in lockstep.

Also in this release

• Example app: removed three stale, never-compiled copies of AppIntentsBridge sources (#104).
• Toolchain: AGP 9.2.1 → 9.3.1, Gradle wrapper 9.6.1 → 9.7.0, build 4.0.8, build_test 3.5.17, dart_style 3.1.12.
• RELEASING.md now lists the two podspecs, the three per-package READMEs, and the ^X.Y.Z pins in docs/ — all of which the checklist had been omitting.

Full Changelog: v0.13.0...v0.14.0

• Fix: AppIntentsBridge could not be reached from a downstream app (#102). The Swift package now ships inside this pub package at ios/AppIntentsBridge/, so import AppIntentsBridge — which the generate_widget_swift output requires — resolves without a separately versioned dependency. Three consumption routes, all building the same sources:

  • Local Swift package — add ios/.symlinks/plugins/app_intents/ios/AppIntentsBridge via File → Add Package Dependencies… → Add Local….
  • CocoaPods — new standalone app_intents_bridge podspec (no Flutter dependency, so an App Extension target can take it): pod 'app_intents_bridge', :path => '.symlinks/plugins/app_intents/ios'.
  • Remote Swift package — the repository root manifest still exposes the same AppIntentsBridge product for .package(url:).

  app_intents.podspec deliberately does not include these sources, so a target may take both pods without duplicate symbols. Previously the package lived only in the repository's ios-spm/ subdirectory, which neither pub nor CocoaPods shipped and which SPM cannot resolve over a Git URL.

• Docs: AppIntentsEntityCacheKey.forEntity now states that its result is the cache key, not the raw UserDefaults key — the plugin namespaces it as app_intents.<storageIdentifier>.cache.<cacheKey>. Reading with the un-namespaced key returns nil silently, which only surfaces as an empty widget configuration picker (#102). Same note added to docs/usage.md.

• feat: App Extension entity access + WidgetConfigurationIntent codegen (#97/#98, #99)
• fix(codegen): normalize entity id property to id for AppEntity conformance (#100)

Also fixes version references that were missed in the 0.12.0 release:
the iOS podspec (left at 0.11.0) and the ^0.11.0 dependency snippets in
docs/ and the per-package READMEs.

Co-Authored-By: Claude Opus 5 [email protected]

• AppIntentsEntityCacheKey.forEntity — Dart-side mirror of the App Group cache key used by the persisted-entity fallback, so the key is no longer an undocumented internal string that callers must hand-write (#97). Symmetric with AppIntentsEntityCache / AppIntentsCachedEntity in the AppIntentsBridge Swift package, which lets an App Extension (e.g. a Widget Extension, which cannot start a Flutter engine) read the cached entity list.
• Fixes the iOS podspec version, which was left at 0.11.0 during the 0.12.0 release.

Follow-up release after v0.11.0 reflecting the matsudate WWDC 2026 review #4 survey: three additive, opt-in items (#55 intent donation, #52 IntentParameter.ValueState, and the system.searchInApp schema rename) plus the deferred-items punch list in CLAUDE.md. All three packages are released together at the same version.

app_intents 0.12.0

• New API AppIntents().donateIntent(identifier, params) (#55): wraps AppIntent.donate() (stable iOS 16+) so the Dart side can record an executed intent for Siri / Apple Intelligence to learn from. The call is forwarded through AppIntentsPlugin.intentDonationForwarder (set in AppDelegate, mirroring relevantEntitiesDonationForwarder) to FlutterBridge.shared.donateIntent, which invokes the per-intent reverse-executor emitted by @IntentSpec(donatable: true) codegen. iOS-only; a no-op on other platforms.
• iOS native:
  • AppIntentsPlugin.intentDonationForwarder static hook for AppDelegate wiring. The donateIntent MethodChannel case returns DONATION_NOT_CONFIGURED when the forwarder is not set.
  • FlutterBridge.shared.registerIntentDonator(intentIdentifier:_:) / donateIntent(intentIdentifier:params:) / hasIntentDonator(for:); the donators dictionary is cleared by clearExecutors() alongside the other executor slots.
• Docs (docs/usage.md): adds the intentDonationForwarder wiring example next to the existing relevantEntitiesDonationForwarder block, plus the matching register<Intent>Donator() call site.

app_intents_annotations 0.12.0

• @IntentSpec(donatable: true) — opt-in for AppIntent.donate() so Siri / Apple Intelligence learns the user performed the action in-app (#55). Inert unless the donation experimental feature is enabled in app_intents_codegen. MVP restricts to primitive parameter types (String / int / double / bool / DateTime, optionals allowed); entity / file / enum / union / collection params are rejected at codegen time.
• @IntentParam(useValueState: true) — opt-in for IntentParameter.ValueState (@available(iOS 18.2, *) stable — no #if gating required). Distinguishes unset / set / cleared for an optional update parameter so the Dart handler can tell "don't touch" from "explicitly cleared." Only valid on a nullable Dart type; analyzer rejects use on non-optional params.
• AppSchemas.system.searchInApp — typed accessor for the iOS 27 system search-in-app schema (iOS 17 used .system.search; iOS 27 renamed it). The iOS-17 identifier remains reachable via AppSchemas.of(AppSchemaDomain.system, 'search'). Also adds AppSchemas.system.open.

app_intents_codegen 0.12.0

• @IntentSpec(donatable: true) (#55, requires --experimental=donation): emits a #if APP_INTENTS_WWDC26-gated register<Intent>Donator() reverse-executor that reconstructs the concrete intent from a [String: Any] params dict and calls intent.donate() (stable iOS 16+). Analyzer enforces the MVP primitive-only contract; rejects entityType / enumType / fileType / entityCollectionType / @UnionValue / non-primitive Dart types at codegen time.
• @IntentParam(useValueState: true) (#52): emits if #available(iOS 18.2, *) { switch $field.valueState { … @unknown default … } } in perform() and adds a sibling "<field>State": "unset" | "cleared" | "set" entry to the wire dict. The state key is added via if let in both FlutterBridge and cache-mode emit paths, so it is absent on iOS < 18.2 and the Dart handler can distinguish "no state info" from a present state. Analyzer rejects opt-in on non-optional Dart params. The Swift output uses @unknown default to future-proof against Swift 6's non-frozen enum errors. No experimental flag — this is a normal feature (the SDK symbol is stable iOS 18.2).
• AppSchemas.system.searchInApp — codegen consumes the schema string verbatim through the existing @AppIntent(schema:) / @AppEntity(schema:) macro emission (the app-schema experimental gate is unchanged); no codegen change beyond the typed accessor that lives in app_intents_annotations.
• Bumps app_intents_annotations dependency to ^0.12.0.

Repo meta

CLAUDE.md adds a new Deferred WWDC26 punch list section reserving ADR numbers 0005–0010 for the seven defer-with-ADR items uncovered by the matsudate review #4 audit (snippetView, dialogFullSupporting, requestValue, PlaceDescriptor export, LongRunningIntent progress/cancel forwarding, SyncableEntityIdentifier dual-id, @AppIntentsPackage). One document-only item (notificationEntity) is also tracked.

Verification

• All three Dart unit-test suites green (annotations, codegen, plugin), Swift AppIntentsBridge suite green (26 tests, .serialized trait fixed the shared-singleton race when adding the new intent-donator tests).
• swiftc -typecheck of the useValueState emit pattern against the Xcode 27 beta iOS 27 SDK (target iOS 17.0): exit 0, no warnings.
• The example app's regenerated Swift is byte-identical to the previous commit — the opt-in design means existing intents that don't opt in are completely unaffected.

• New API AppIntents().donateIntent(identifier, params) (#55): wraps AppIntent.donate() (stable iOS 16+) so the Dart side can record an executed intent for Siri / Apple Intelligence to learn from. The call is forwarded through AppIntentsPlugin.intentDonationForwarder (set in AppDelegate, mirroring relevantEntitiesDonationForwarder) to FlutterBridge.shared.donateIntent, which invokes the per-intent reverse-executor emitted by @IntentSpec(donatable: true) codegen. iOS-only; a no-op on other platforms.
• iOS native:
  • AppIntentsPlugin.intentDonationForwarder static hook for AppDelegate wiring. The donateIntent MethodChannel case returns DONATION_NOT_CONFIGURED when the forwarder is not set.
  • FlutterBridge.shared.registerIntentDonator(intentIdentifier:_:) / donateIntent(intentIdentifier:params:) / hasIntentDonator(for:); the donators dictionary is cleared by clearExecutors() alongside the other executor slots.
• Docs (docs/usage.md): adds the intentDonationForwarder wiring example next to the existing relevantEntitiesDonationForwarder block, plus the matching register<Intent>Donator() call site.

First release since v0.10.1 to ship the accumulated WWDC26 App Intents work (opt-in, default OFF), plus a documentation audit pass. All three packages are released together at the same version.

app_intents 0.11.0

• WWDC26 experimental bridges (opt-in; exercised only when experimental Swift generation is enabled):
  • IntentValueQuery (#51): registerValueQueryHandler + platform queryValuesAsync (generic inbound value query; the visual SemanticContentDescriptor variant is out of scope)
  • Donations & discovery (#55): donateRelevantEntities(id, entities, context:) via a reverse executor, wired through AppIntentsPlugin.relevantEntitiesDonationForwarder
  • Onscreen-awareness scaffold (#56): setOnscreenEntity(typeId, instanceId, title:) / clearOnscreenEntity() backed by NSUserActivity, plus AppIntentsPlugin.onscreenEntityBinder
  • Extended the platform interface, method channel, and iOS AppIntentsPlugin.swift accordingly
• Docs: fix the Android setup README (compileSdk/targetSdk 37, minSdk 36 — the previous "36" would fail the appfunctions:1.0.0-alpha09 AAR-metadata check) and replace the placeholder example app READMEs with real content

app_intents_annotations 0.11.0

• WWDC26 App Intents annotation surfaces (opt-in; inert unless experimental code generation is enabled in app_intents_codegen):
  • Intent execution control (#52): @IntentSpec(longRunning:, cancellable:, executionTargets:) + the IntentExecutionTarget enum
  • App Schema (#49): schema: on @EntitySpec / @IntentSpec / @EnumSpec, plus the AppSchemas catalog (messages / mail / photos)
  • Semantic indexing (#50): @EntityProperty(title:, indexingKey:)
  • Entity ownership (#55): @EntitySpec(ownership:) + EntityOwnershipState
  • Rich parameter types (#53): Duration parameters, the new PersonName value type, @IntentParam(entityCollectionType:), and @UnionValueSpec / @UnionCase (which codegen lowers to a native @UnionValue enum)
  • Cross-app export (#54): @EntitySpec(exportAs:) + EntityExportType
  • IntentValueQuery (#51) and donations/discovery (#55): @EntitySpec(valueQuery:, syncable:, relevantEntities:)

app_intents_codegen 0.11.0

• WWDC26 experimental code generation (opt-in, default OFF). Master switch --experimental-wwdc26 + per-feature --experimental=<flag> (app-schema, ownership, long-running, rich-types, value-query, value-representation, donation). Experimental Swift is emitted inside #if APP_INTENTS_WWDC26 with a mandatory stable #else fallback, so released-SDK builds (without the flag) still compile.
  • Intent execution control (#52): LongRunningIntent / CancellableIntent / execution targets
  • App Schema (#49) + semantic indexing (#50): @AppEntity/@AppIntent/@AppEnum(schema:) and @Property(indexingKey:) (indexing ships as a normal iOS 18.4 feature)
  • Entity ownership (#55): additive OwnershipProvidingEntity conformance
  • Rich parameter types (#53): native Duration / PersonNameComponents / EntityCollection / @UnionValue parameters with compile-everywhere fallbacks, plus a generated union fromMap factory
  • IntentValueQuery (#51), cross-app export (#54, IntentPerson), and SyncableEntity / RelevantEntities donation (#55)
  • Dual-branch output verified via swiftc -typecheck (with and without APP_INTENTS_WWDC26) against the Xcode 27 beta SDK; see scripts/verify_experimental_swift.sh
• AppIntentsTesting scaffold for the example app (#57, compile-checked, inert on stable Xcode)
• Docs: correct the @EnumSpec / @EnumCaseDisplay examples, the Dart SDK constraint (^3.10.0) and dependency ranges, the Android toolchain versions, and add the ownership experimental flag to the feature tables

Published to pub.dev:

• https://pub.dev/packages/app_intents/versions/0.11.0
• https://pub.dev/packages/app_intents_annotations/versions/0.11.0
• https://pub.dev/packages/app_intents_codegen/versions/0.11.0

Full Changelog: v0.10.1...v0.11.0

• WWDC26 experimental bridges (opt-in; exercised only when experimental Swift generation is enabled):
  • IntentValueQuery (#51): registerValueQueryHandler + platform queryValuesAsync (generic inbound value query; visual variant out of scope).
  • Donations & discovery (#55): donateRelevantEntities(id, entities, context:) via a reverse executor, wired through AppIntentsPlugin.relevantEntitiesDonationForwarder.
  • Onscreen awareness scaffold (#56): setOnscreenEntity(typeId, instanceId, title:) / clearOnscreenEntity() backed by NSUserActivity, plus AppIntentsPlugin.onscreenEntityBinder.
  • Extended the platform interface, method channel, and iOS AppIntentsPlugin.swift accordingly.
• Docs: fix the Android setup README (compileSdk/targetSdk 37, minSdk 36 — the previous "36" would fail the appfunctions:1.0.0-alpha09 AAR-metadata check) and replace the placeholder example app READMEs with real content.

app_intents 0.10.1

• Fix Android build on Kotlin 2.3+ / AGP 9.1.0+: migrate the plugin's android/build.gradle.kts from the deprecated kotlinOptions DSL to the modern compilerOptions DSL (#20, thanks @cpbritton)
  • The kotlinOptions block now causes "Script compilation errors" with recent Kotlin Gradle Plugin / AGP toolchains; compilerOptions { jvmTarget.set(JvmTarget.JVM_17) } is the supported replacement
• Maintenance: dependency bumps and OSS infrastructure hardening (CI, issue/PR templates, Dependabot)

app_intents_annotations 0.10.1 / app_intents_codegen 0.10.1

• No API changes; version-aligned with app_intents 0.10.1
• codegen: dependency maintenance (analyzer, source_gen, build, build_test, dart_style, test)

Published to pub.dev:

• https://pub.dev/packages/app_intents/versions/0.10.1
• https://pub.dev/packages/app_intents_annotations/versions/0.10.1
• https://pub.dev/packages/app_intents_codegen/versions/0.10.1

Full Changelog: v0.10.0...v0.10.1

• Fix Android build on Kotlin 2.3+ / AGP 9.1.0+: migrate the plugin's android/build.gradle.kts from the deprecated kotlinOptions DSL to the modern compilerOptions DSL (#20, thanks @cpbritton)
  • The kotlinOptions block now causes "Script compilation errors" with recent Kotlin Gradle Plugin / AGP toolchains; compilerOptions { jvmTarget.set(JvmTarget.JVM_17) } is the supported replacement
• Maintenance: dependency bumps and OSS infrastructure hardening (CI, issue/PR templates, Dependabot)

app_intents 0.10.0

• Add Swift Package Manager (SPM) support for the iOS plugin (#29, #30)
  • New manifest at ios/app_intents/Package.swift; native sources moved to ios/app_intents/Sources/app_intents/ (SPM-standard layout)
  • app_intents.podspec now points source_files/resource_bundles at the shared Sources/ location, so CocoaPods and SPM build the same files (both remain supported during the transition)
  • Fixes Flutter reporting app_intents as "does not support Swift Package Manager" when host apps enable SPM
  • Host apps that enable SPM need Flutter 3.24+; CocoaPods users are unaffected (flutter: '>=3.3.0' unchanged)
  • The privacy manifest is now actually bundled (previously commented out in the podspec)
• Declare the NSPrivacyAccessedAPICategoryUserDefaults required-reason API in PrivacyInfo.xcprivacy
  • Reasons CA92.1 (UserDefaults accessible only to the app itself) and 1C8F.1 (UserDefaults shared within the App Group, for cross-process cache/EntityQuery data)
  • Required for App Store review of downstream apps that bundle the plugin

app_intents_annotations 0.10.0 / app_intents_codegen 0.10.0

• No API changes; version-aligned with app_intents 0.10.0

Published to pub.dev:

• https://pub.dev/packages/app_intents/versions/0.10.0
• https://pub.dev/packages/app_intents_annotations/versions/0.10.0
• https://pub.dev/packages/app_intents_codegen/versions/0.10.0

• Add Swift Package Manager (SPM) support for the iOS plugin (#29)
  • New manifest at ios/app_intents/Package.swift; native sources moved to ios/app_intents/Sources/app_intents/ (SPM-standard layout)
  • app_intents.podspec now points source_files/resource_bundles at the shared Sources/ location, so CocoaPods and SPM build the same files (both remain supported during the transition)
  • Fixes Flutter reporting app_intents as "does not support Swift Package Manager" when host apps enable SPM
  • Host apps that enable SPM need Flutter 3.24+ (the minimum for app-side SPM); CocoaPods users are unaffected and the package's flutter: '>=3.3.0' constraint is unchanged
  • The privacy manifest is now actually bundled (it was previously present but commented out in the podspec)
• Declare the NSPrivacyAccessedAPICategoryUserDefaults required-reason API in PrivacyInfo.xcprivacy
  • Reason CA92.1 (UserDefaults accessible only to the app itself — the UserDefaults.standard fallback) and 1C8F.1 (UserDefaults shared within the App Group — UserDefaults(suiteName:) used for cross-process cache/EntityQuery data)
  • Required for App Store review of downstream apps that bundle the plugin via SPM or CocoaPods

• @AppShortcutsBuilder annotation in generated AppShortcuts (#25)
• App Group UserDefaults fallback for EntityQuery cold-start (#26)
  • New @EntitySpec.persistedCacheKey field
  • Defaults to app_intents.entities. when enumerable/indexed

Co-Authored-By: Claude Opus 4.7 (1M context) [email protected]

• No plugin API changes; version bump aligns with codegen 0.9.0 which adds EntityQuery cold-start fallback via App Group UserDefaults (#26) and the @AppShortcutsBuilder annotation in generated Swift (#25)

Bump all packages to v0.8.0 to publish the AppFunctions alpha09
upgrade (#23). Downstream Android hosts need AGP 9.1.0+, Gradle
9.3.1+, compileSdk 37, and the android.newDsl=false /
android.builtInKotlin=false shims in gradle.properties. Regenerate
Kotlin output with dart run app_intents_codegen:generate_kotlin
after upgrading.

Co-Authored-By: Claude Opus 4.7 (1M context) [email protected]

• No plugin API changes; version bump aligns with the AppFunctions alpha09 upgrade in app_intents_codegen (#23)
• Note for downstream Android users: bumping the generated Kotlin to alpha09 requires the host app to use AGP 9.1.0+, Gradle 9.3.1+, compileSdk = 37, and the android.newDsl=false / android.builtInKotlin=false shims in gradle.properties. See docs/usage.md for the full migration.

Fix: Android AppIntentsPlugin now handles iOS-only cache methods
(getCachedValue/setCachedValue/clearCachedValue/configureStorage/
processPendingActions) as no-ops returning null, instead of throwing
MissingPluginException. Prevents silent failures in release builds
where PlatformDispatcher.onError swallows the exception (#22).

Co-Authored-By: Claude Opus 4.7 (1M context) [email protected]

• Fix: Android AppIntentsPlugin now handles iOS-only cache methods as no-ops instead of throwing MissingPluginException (#22)
  • getCachedValue, setCachedValue, clearCachedValue, configureStorage, and processPendingActions return null on Android
  • Prevents silent failures in release builds where PlatformDispatcher.onError may swallow the exception
  • Cross-platform callers no longer need to wrap each invocation in try-catch or guard with Platform.isIOS

• Fix: Return empty list instead of throwing when entity query handler is not yet registered
  • iOS may issue entity queries (Spotlight indexing, Siri Suggestions) before Dart-side handlers are registered
  • handleEntityQuery() and handleSuggestedEntitiesQuery() now return [] for unregistered entities
  • The next query after handler registration returns real data

• Fix: Use App Group UserDefaults to prevent cross-process data resets on iOS
  • App Intents running in extension processes (WFIsolatedShortcutRunner) now share storage with the main app
  • Cache key prefix uses stable identifier instead of Bundle.main.bundleIdentifier (which differs across processes)
  • Added synchronize() after all UserDefaults read/writes for cross-process reliability
  • Added validation and error logging for invalid App Group identifiers
  • Added error logging for JSON serialization/deserialization failures in pending actions
• Add: configureStorage(appGroupIdentifier:) API for Dart-side App Group configuration (iOS only, no-op on other platforms)
• Add: AppIntentsPlugin.configure(appGroupIdentifier:) static method for Swift-side configuration
• Note: Existing cache keys from pre-0.7.6 are preserved when storageIdentifier is not set. If you use extension processes where Bundle.main.bundleIdentifier differs, set storageIdentifier explicitly in configure() to ensure consistent cache key prefixes.

• No API changes; version bump to align with codegen bug fix release

• No API changes; version bump to align with codegen bug fix release

• No API changes; version bump to align with codegen bug fix release

• No API changes; version bump to align with codegen bug fix release

• No API changes; version bump to align with codegen bug fix release

• No API changes; version bump to align with codegen package (xcstrings generation feature)

• Fix: Safe casts for all MethodChannel input — prevents crash on malformed native data
• Fix: Pending actions now use a queue (array) instead of single slot — no more silent drops on concurrent intents
• Fix: processPendingActions() now processes all queued actions in a loop
• Fix: Sanitize error messages across trust boundary — internal exception details no longer leak to native side
• Fix: Add bundle-ID-qualified prefix for UserDefaults cache keys to avoid namespace collisions
• Add: FlutterBridge.clearExecutors() for invalidating stale executors after Flutter engine restart

• Documentation fixes: correct outdated code examples and API references

• Version bump to align with annotations/codegen packages
• No API changes

• No API changes; version bump to align with other packages

• No API changes; version bump to align with codegen package

• Version bump to align with annotations/codegen packages
• No API changes

• Add caching API: getCachedValue(), setCachedValue(), clearCachedValue()
• Add processPendingActions() for delivering cached intent actions after Flutter startup
• Add pendingActionsStream via FlutterEventChannel for buffered pending action notifications
• iOS Plugin: setPendingAction() for caching intent params in UserDefaults
• iOS Plugin: PendingActionStreamHandler with thread-safe buffered push
• Fix: Return action data directly from processPendingActions instead of nested MethodChannel call

• Add Android AppFunctions support via AppIntentsPlugin.kt
• Register Android platform in pubspec.yaml (com.example.app_intents)
• MethodChannel bridge for Android AppFunctions ↔ Flutter communication
• Update documentation for cross-platform support

• Fix podspec: update iOS platform from 13.0 to 17.0
• Fix podspec: update Swift version from 5.0 to 5.9
• Documentation updates

• BREAKING: Raise iOS minimum to 17.0
• No API changes; version bump to align with annotations/codegen packages

• Initial release
• Intent handler registration via registerIntentHandler
• Entity query handlers via registerEntityQueryHandler and registerSuggestedEntitiesHandler
• Intent execution stream via onIntentExecution
• iOS 17+ App Intents framework integration