过去十年里手机软件一直在争夺「搜索」与「链接」的黄金入口。如今AI Yi经悄然把聊天气泡推到了前台，AppFunctions 成为连接传统 UI 与智Neng体的关键桥梁。本文将以一个极简笔记应用为蓝本，手把手拆解从依赖引入到功Neng调用的全过程，并聊聊在国内碎片化生态中可Neng碰到的坑。

用户不再主动打开某个 APP，而是向语音助理或聊天机器人抛出需求：「帮我查下今天的会议记录」或「给我点一份Zui划算的外卖」。要实现这种「说了就NengZuo」的体验，应用必须把自己的核心业务以结构化方式暴露出来让 AI Neng够发现并安全调用。

Google 为此推出了 ：一种基于注解处理器的轻量级协议，把函数签名、参数类型和返回模型写进 Manifest，系统层面负责进程间通信与权限校验。

下面这段 Gradle 配置几乎是所有示例的起点：

dependencies {
    val appFunVersion = "1.0.0-alpha08"
    implementation
    implementation
    ksp
}
// KSP 参数
ksp {
    arg
    arg
}

确保你的项目使用的是 Android Gradle Plugin 8.x 以上，并且编译 SDK 至少是 API 34，否则注解处理器会报错。

核心思想hen简单：每个想让 AI 使用的函数，dou要打上 @AppFunction 标记；第一个参数固定为 AppFunctionContext，它携带调用者信息与权限校验结果。

class NoteApi(
    private val repo: NoteRepository
) {
    @AppFunction
    suspend fun listNotes: List =
        repo.getAll
    @AppFunction
    suspend fun createNote(
        context: AppFunctionContext,
        title: String,
        content: String
    ): NoteDto = repo.insert
    @AppFunction
    suspend fun editNote(
        context: AppFunctionContext,
        noteId: String,
        title: String?,
        content: String?
    ): NoteDto? = repo.update
    @AppFunction
    suspend fun deleteNote(
        context: AppFunctionContext,
        noteId: String
    ): Boolean = repo.remove
}

小贴士：函数返回值Zui好是普通 POJO，这样生成的 schema 才Neng被 LLM 正确解析。

@AppFunctionSerializable
data class NoteDto(
    /** 笔记唯一标识 */
    val id: String,
    /** 标题文字 */
    val title: String,
    /** 正文内容 */
    val content: String
)

在自定义 Application 中实现 AppFunctionConfiguration.Provider 接口，把刚才写好的类交给系统：

class DemoApplication : Application,
                         AppFunctionConfiguration.Provider {
    private val noteRepo by lazy { NoteRepository }
    private val api by lazy { NoteApi }
    override val appFunctionConfiguration: AppFunctionConfiguration
        get = AppFunctionConfiguration.Builder
            .addEnclosingClassFactory { api }
            .build
}

别忘了在 AndroidManifest.xml 中声明你的 Application：

AOSP Yi经提供了两条实用命令：

列出所有Yi注册函数：

adb shell cmd app_function list-app-functions

执行具体函数：

adb shell cmd app_function execute-app-function \
   --package com.example.notes \
   --function com.example.notes.NoteApi#createNote \
   --parameters '{"title":"随手记","content":"第一次尝试"}'

adb shell cmd app_function execute-app-function \
   --package com.example.notes \
   --function com.example.notes.NoteApi#listNotes \
   --parameters '{}'

成功后终端会输出类似：

{
  "result": 
}

想象用户对 Gemini 或者千问说：「帮我把上周写的会议纪要整理成 PPT」——背后其实是 LLM 把需求映射为两步函数调用：

listNotes: 拉取符合关键词的笔记；

CreateSlideDeck: 将返回内容喂给第三方 PPT 服务。

AOSP Yi经预留了统一入口，让系统级 Agent Neng够自动查询Yi安装应用公开的 schema，然后通过自然语言生成对应参数，再发起调用。换句话说你只要Zuo好上述注解和 Manifest，就有机会站上「AI Nengkan到」的位置。

    Android 原生框架Yi经准备好，却因为各大厂封闭的数据墙而受阻。即便 Samsung S26 Ultra 或 Pixel 系列Yi经原生支持，这些设备占比仍不足百分之十五。没有统一标准，各家自研助手往往只Neng在内部生态里调度功Neng——这正是我们当前Zui大的痛点。

KDoc + 注解双保险：KDoc 中写明业务描述后会自动同步进 schema，使得搜索爬虫Neng够读取元信息；同时也方便团队内部文档生成。

Sitemap for Functions：Sitemap 不再只包含页面 URL，还Ke以加入类似 /appfunction/com.example.notes#createNote?schema=1 的节点，让 Google Bot 在索引时了解可执行操作。