Android 开发者的 AI 时代新武器：AppFunctions 实战指南

[versions]
appfunctions = "1.0.0-alpha09"

[libraries]
androidx-appfunctions          = { module = "androidx.appfunctions:appfunctions",          version.ref = "appfunctions" }
androidx-appfunctions-service  = { module = "androidx.appfunctions:appfunctions-service",  version.ref = "appfunctions" }
androidx-appfunctions-compiler = { module = "androidx.appfunctions:appfunctions-compiler", version.ref = "appfunctions" }

ksp {
    arg("appfunctions:aggregateAppFunctions", "true")
}

dependencies {
    implementation(libs.androidx.appfunctions)
    implementation(libs.androidx.appfunctions.service)
    ksp(libs.androidx.appfunctions.compiler)
}

<application ...>
    <property
        android:name="android.app.appfunctions.app_metadata"
        android:resource="___HL_0___/app_metadata" />

    <service
        android:name="androidx.appfunctions.service.PlatformAppFunctionService"
        android:permission="android.permission.BIND_APP_FUNCTION_SERVICE"
        android:exported="true"
        tools:targetApi="36">
        <intent-filter>
            <action android:name="android.app.appfunctions.AppFunctionService" />
        </intent-filter>
    </service>
</application>

<?xml version="1.0" encoding="utf-8"?>
<AppFunctionAppMetadata
    xmlns:appfn="http://schemas.android.com/apk/androidx.appfunctions"
    appfn:description="本应用支持用户查看和管理笑话内容，包括标记收藏和清除收藏列表。" />

<AppFunctionAppMetadata
    xmlns:appfn="http://schemas.android.com/apk/androidx.appfunctions"
    appfn:description="本应用支持用户查看和管理笑话及收藏。
        操作模式：
        - 调用 'getFavorites' 获取有效笑话 ID 后再调用 'setFavorite'
        约束条件：
        - 'clearFavorites' 操作不可逆，调用前需确认用户意图"
    appfn:displayDescription="___HL_0___/app_function_user_description" />

@Query("UPDATE joke SET isFavorite = 0")
suspendfun clearAllFavorites()

interface LocalJokesDataSource {
suspendfun clearAllFavorites()
}

class LocalJokesDataSourceImpl : LocalJokesDataSource {
overridesuspendfun clearAllFavorites() {
        database.clearAllFavorites()
    }
}

interface JokesRepository {
suspendfun clearAllFavorites(): Result<Unit>
}

class JokesRepositoryImpl : JokesRepository {
overridesuspendfun clearAllFavorites(): Result<Unit> {
return safeCall {
            localDataSource.clearAllFavorites()
        }
    }
}

class JokesAppFunctions {

@AppFunction(isDescribedByKDoc = true)
suspendfun clearFavorites(context: AppFunctionContext): String {
val repository = AppModule.jokesRepository
val result = repository.clearAllFavorites()
returnif (result.isSuccess) {
"所有收藏笑话已成功清除"
        } else {
"清除收藏失败：${result.exceptionOrNull()?.message}"
        }
    }
}

@AppFunctionSerializable(isDescribedByKDoc = true)
dataclass AppFunctionJoke(
val id: Int,
val question: String,
val answer: String,
)

fun Joke.toAppFunctionJoke(): AppFunctionJoke = AppFunctionJoke(
    id = id, question = question, answer = answer,
)

@AppFunction(isDescribedByKDoc = true)
suspendfun setFavorite(
    context: AppFunctionContext,
    jokeId: Int,
    isFavorite: Boolean,
): String = withContext(Dispatchers.IO) {
val joke = AppModule.jokesRepository.getJokeById(jokeId).getOrNull()
        ?: throw AppFunctionElementNotFoundException("未找到 ID 为 $jokeId 的笑话")

val result = AppModule.jokesRepository.setFavorite(jokeId, isFavorite)
if (result.isSuccess) {
if (isFavorite) "笑话 ${joke.id} 已添加至收藏"else"笑话 ${joke.id} 已取消收藏"
    } else {
"更新笑话 ${joke.id} 失败：${result.exceptionOrNull()?.message}"
    }
}

class MyApplication : Application(), AppFunctionConfiguration.Provider {

overridefun onCreate() {
super.onCreate()
        AppModule.initialize(applicationContext)
    }

overrideval appFunctionConfiguration: AppFunctionConfiguration
get() = AppFunctionConfiguration.Builder()
            .addEnclosingClassFactory(JokesAppFunctions::class.java) { JokesAppFunctions() }
            .build()
}

<application
    android:name=".MyApplication"
    ...>

features/jokes/
├─ data/          ← 驱动适配器：Room、Ktor、DTO、映射器
├─ domain/        ← 领域模型、仓库接口（无 Android 依赖）
├─ presentation/  ← Compose 界面 + ViewModels（面向人类用户）
└─ appfunctions/  ← AppFunctions、DTO、映射器（面向 AI Agent）

adb shell cmd app_function list-app-functions | grep -A 10"[应用包名]"

adb shell cmd app_function execute-app-function \
  --package [应用包名] \
  --function [完整类名]#[方法名] \
  --parameters '{"参数名":值}'

# 清除收藏
adb shell cmd app_function execute-app-function \
  --package eu.anifantakis.networkapp \
  --function eu.anifantakis.networkapp.jokes.features.jokes.appfunctions.JokesAppFunctions#clearFavorites \
  --parameters '{}'

# 获取收藏列表
adb shell cmd app_function execute-app-function \
  --package eu.anifantakis.networkapp \
  --function eu.anifantakis.networkapp.jokes.features.jokes.appfunctions.JokesAppFunctions#getFavorites \
  --parameters '{}'

# 设置收藏状态
adb shell "cmd app_function execute-app-function \
  --package eu.anifantakis.networkapp \
  --function eu.anifantakis.networkapp.jokes.features.jokes.appfunctions.JokesAppFunctions___HL_5___
  --parameters '{\"jokeId\":179,\"isFavorite\":true}'"

adb shell getprop ro.build.fingerprint
# sdk_gphone... 表示支持 cmd
# sdk_phone.../test-keys 表示不支持 cmd