appfunctions

  
待办事项
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2025 年 8 月 13 日 - - - 1.0.0-alpha03

声明依赖项

如需添加 appfunctions 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha03"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha03"
    implementation "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha03")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha03")
    implementation("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

版本 1.0

版本 1.0.0-alpha03

2025 年 8 月 13 日

发布了 androidx.appfunctions:appfunctions-*:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

  • 使用 KDoc 作为 AppFunction 说明
  • 分别使用 AppFunctionIntValueConstraint 和 AppFunctionStringValueConstraint 注释来限制 Int 和 String 类型的值。
  • 为大语言模型指定自然语言说明，并为代理应用中显示的用户可见说明指定自然语言说明。
  • 使用 AppFunctionUriGrant 类自动向从应用函数返回的 URI 授予权限。
  • 使用 AppFunctionTestRule 编写 Robolectric 测试，以测试应用功能设置。

API 变更

  • 添加了 AppFunctionStringValueConstraint (I10e3f)
  • 添加了 AppFunctionIntValueConstraint (Ifda13)
  • 将 AppFunctionPrimitiveTypeMetadata 重构为特定的数据类型类。(I1a3b2)
  • 在 AppFunctionResponseMetadata 中添加了说明字段 (I2332b)
  • 移除了 setAppFunctionEnabled API 的权限要求 (I1b92a)
  • 在 AppFunctionParameterMetadata 中添加了说明字段 (I40a67)
  • 添加了 AppFunctionUriGrant (I67ca9)
  • 添加了 resolveAppFunctionAppMetadata API。(I17408)
  • 在 @AppFunctionSerializable 注解中添加了 isDescribedByKdoc (Ie14e7)
  • 在 AppFunctionDataTypeMetadata (I1bcac) 中添加说明字段
  • 从 observeAppFunctions API 返回 AppPackageMetadata。(I68c7e)
  • 在 AppFunctionMetadata (I060e2) 中添加说明字段
  • 添加了 AppFunctionTestRule (Id5ed0)
  • 在 @AppFunction 注释中添加了 isDescribedByKdoc (Ia84d2)

bug 修复

  • AppFunctionManagerCompat 仅支持 U+ 设备 (Ifa8d0)
  • 在 AppFunction 的元数据 XML (I2aab2) 中添加了共享可序列化类型的属性说明
  • 在生成的 AppFunction 的元数据 XML (Ie5bf6) 中添加说明元素

版本 1.0.0-alpha02

2025 年 6 月 4 日

发布了 androidx.appfunctions:appfunctions:1.0.0-alpha02、androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02 和 androidx.appfunctions:appfunctions-service:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

  • 支持 Android 16 API。
  • 在编译时更好地支持参数化 AppFunctionSerializable(s)。

API 变更

  • 引入了 AppFunctionSchemaDefinition API，使代理能够定义自己的预定义函数架构。

bug 修复

  • 针对 AppFunctions 的运行时启用状态缺失的错误处理。
  • 对 observeAppFunctions API 进行了小幅 bug 修复，以观察 AppFunctionComponentMetadata 中的变化。
  • 其他错误日志。

版本 1.0.0-alpha01

2025 年 5 月 7 日

发布了 androidx.appfunctions:appfunctions:1.0.0-alpha01、androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01 和 androidx.appfunctions:appfunctions-service:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

AppFunctions Jetpack 库基于 android.app.appfunctions 平台 API 构建。此库可简化向 Google 助理公开应用功能的过程，并允许 Google 助理与应用公开的功能进行交互。

  • androidx.appfunctions:appfunctions：用于管理（启用/停用）和与（搜索/执行）AppFunctions 交互的核心客户端 API。
  • androidx.appfunctions:appfunctions-service：用于轻松将应用的功能公开为 AppFunctions 的服务侧 API。
  • androidx.appfunctions:appfunctions-compiler：必需的 KSP 编译器，用于生成公开 AppFunctions 所需的代码。