chore(deps): Bump androidx.appfunctions to 1.0.0-alpha11 (#113)

* chore(deps): Bump androidx.appfunctions to 1.0.0-alpha11

Bump `appfunctions` and `appfunctions-compiler` from 1.0.0-alpha10 to
1.0.0-alpha11 (released 2026-08-26). Keep `appfunctions-service` pinned
at alpha09 — alpha11 omits this artifact from its release entirely,
which may indicate it is being deprecated or merged.

Notable alpha11 changes (no generated-code impact):
- `AppFunctionState` / `AppFunctionManager#getAppFunctionStates` replaces
  deprecated `AppFunctionMetadata#isEnabled`
- `AppFunctionManager#getAppFunctionActivityStates` added
- `ExtensionsAppFunctionService` added for sidecar support
- `@AppFunctionSignature` experimental public API added
- `observeAppFunctions` updated to match platform API
- Bug fix: missing runtime metadata crash during OOBE

Package paths for `@AppFunction`, `@AppFunctionSerializable`, and
`AppFunctionContext` are unchanged; KotlinGenerator needs no update.

Also updates CLAUDE.md to document the alpha11 appfunctions-service
absence and recency of the Kotlin-version-pin table baseline.

* docs: Update docs/usage.md and CLAUDE.md for appfunctions alpha11

- docs/usage.md: bump appfunctions/appfunctions-compiler version
  references from alpha10 to alpha11; update KSP snippet from 2.3.9
  to 2.3.11 (actual version in settings.gradle.kts); refresh
  appfunctions-service comment to reflect it is absent from alpha11
- CLAUDE.md: fix Kotlin compatibility note KSP version from 2.3.9
  to 2.3.11 to match the example app's declared toolchain

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: touyou

CLAUDE.md

@@ -271,10 +271,10 @@ Options:
 - KSP compiler cannot handle `Map<String, Any?>` as `@AppFunction` return type — use `String` (JSON)
 - KSP version: KSP1 used the `{kotlin-version}-{ksp-version}` concatenation (e.g., `2.2.20-2.0.4`); KSP2 (current) uses a standalone version (e.g., `2.3.9`) — match whatever the example app's `settings.gradle.kts` declares
 - Three Jetpack artifacts: `appfunctions`, `appfunctions-service`, `appfunctions-compiler`
-- **`appfunctions-service` publishing lag (still unresolved as of 2026-08-21)**: the [release notes page](https://developer.android.com/jetpack/androidx/releases/appfunctions) lists `appfunctions-service:1.0.0-alpha10`, but Google Maven had not actually published that artifact yet (`maven-metadata.xml`/`group-index.xml` for `androidx.appfunctions` topped out at alpha09 for `appfunctions-service` while `appfunctions` and `appfunctions-compiler` alpha10 were live) — `:app:mergeDebugAssets` fails to resolve `androidx.appfunctions:appfunctions-service:1.0.0-alpha10`. **Fix**: pin `appfunctions-service` one version behind (`alpha09`) while bumping `appfunctions`/`appfunctions-compiler` to the new version; re-check Maven before un-pinning. **Re-checked 2026-08-21 (PR #83, closed)**: `appfunctions-service` alpha10 POM still returns HTTP 404 on both `google()` and `mavenCentral` (`maven-metadata.xml` tops out at alpha09), while `appfunctions`/`appfunctions-compiler` alpha10 return 200 — the pin must stay. Verified: `flutter build apk --debug` succeeds with this mixed-version pin and the *existing* `KotlinGenerator` output unchanged — no `@AppFunctionServiceEntryPoint`/service-wrapper migration was actually required for this project's plain `@AppFunction` usage.
+- **`appfunctions-service` status (pinned at alpha09, possibly deprecated)**: `appfunctions-service:1.0.0-alpha10` was never published to Google Maven (artifact 404 as of 2026-08-21, PR #83). More significantly, the **alpha11 release (2026-08-26) omits `appfunctions-service` entirely** from its artifact list — only `appfunctions`, `appfunctions-compiler`, and `appfunctions-testing` are released. This may signal the artifact is being deprecated or merged into another artifact. **Current fix**: pin `appfunctions-service` at `alpha09` while bumping the other two artifacts. If `appfunctions-service` is permanently dropped upstream, remove this dependency. Verified: `flutter build apk --debug` succeeds with the mixed-version pin and the *existing* `KotlinGenerator` output unchanged.
 - **Kotlin version is gated by the AppFunctions/KSP toolchain — do NOT blindly accept
   Dependabot Kotlin bumps.** The example app pins Kotlin **2.2.20** (KSP `2.3.9`,
-  `appfunctions:1.0.0-alpha10`). Bumping to **Kotlin 2.4.0** (released 2026-06-03) failed
+  `appfunctions:1.0.0-alpha11`, KSP `2.3.11`). Bumping to **Kotlin 2.4.0** (released 2026-06-03) failed
   `:app:kspDebugKotlin` when bisected against KSP `2.3.9` + appfunctions **alpha09** with
   `Can't escape identifier `$Android:appDebug_FunctionComponentRegistry` because it
   contains illegal characters: :` — the AppFunctions compiler emits a colon-bearing
@@ -291,7 +291,7 @@ Options:
 
   | Kotlin | KSP | appfunctions | Result |
   |---|---|---|---|
-  | 2.2.20 | 2.3.9 | alpha10 | ✅ baseline |
+  | 2.2.20 | 2.3.9 | alpha10 | ✅ baseline (at time of test) |
   | **2.4.10** | **2.3.11** | alpha10 | ❌ same `Can't escape identifier` failure |
   | 2.2.20 | **2.3.11** | alpha10 | ✅ |
 

app/android/app/build.gradle.kts

@@ -46,12 +46,13 @@ ksp {
 }
 
 dependencies {
-    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
-    // appfunctions-service alpha10 has not actually been published to Google Maven yet
-    // (the release notes page lists it, but the artifact 404s) — keep this pinned to
-    // alpha09 until Google publishes it, or the build fails to resolve dependencies.
+    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha11")
+    // appfunctions-service was not included in the alpha10 or alpha11 artifact releases
+    // (it 404s on Google Maven for alpha10; alpha11 release notes omit it entirely).
+    // Keep pinned to alpha09. Re-check each release cycle; if appfunctions-service is
+    // permanently dropped, remove this dependency.
     implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha09")
-    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10")
+    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11")
 }
 
 flutter {

docs/usage.md

@@ -29,7 +29,7 @@ platform :ios, '17.0'
 
 #### Android
 
-`appfunctions:1.0.0-alpha10` requires **Android Gradle Plugin 9.1.0+**, **Gradle 9.3.1+**, and **compileSdk 37**.
+`appfunctions:1.0.0-alpha11` requires **Android Gradle Plugin 9.1.0+**, **Gradle 9.3.1+**, and **compileSdk 37**.
 Update `android/app/build.gradle.kts` (`minSdk = 36` because AppFunctions requires Android 16):
 
 ```kotlin
@@ -48,7 +48,7 @@ Add KSP and AppFunctions dependencies:
 // android/settings.gradle.kts
 id("com.android.application") version "9.2.1" apply false
 id("org.jetbrains.kotlin.android") version "2.2.20" apply false
-id("com.google.devtools.ksp") version "2.3.9" apply false
+id("com.google.devtools.ksp") version "2.3.11" apply false
 
 // android/app/build.gradle.kts
 plugins {
@@ -58,11 +58,11 @@ plugins {
     id("dev.flutter.flutter-gradle-plugin")
 }
 dependencies {
-    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
-    // appfunctions-service alpha10 was not yet published on Google Maven as of July 2026
-    // (release notes list it, but the artifact 404s) — pin one version behind until it lands.
+    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha11")
+    // appfunctions-service was absent from the alpha10 and alpha11 releases; pin at alpha09.
+    // If permanently dropped upstream, remove this dependency entirely.
     implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha09")
-    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10")
+    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11")
 }
 
 ksp {
@@ -85,7 +85,7 @@ Update the Gradle wrapper to 9.3.1+ in `android/gradle/wrapper/gradle-wrapper.pr
 distributionUrl=https\://services.gradle.org/distributions/gradle-9.5.1-all.zip
 ```
 
-> **Note**: AppFunctions requires Android 16 (API 36) or later. The `compileSdk = 37` requirement comes from the `appfunctions:1.0.0-alpha10` AAR metadata.
+> **Note**: AppFunctions requires Android 16 (API 36) or later. The `compileSdk = 37` requirement comes from the `appfunctions:1.0.0-alpha11` AAR metadata.
 
 ### 3. iOS Native Setup (AppIntentsBridge)