Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
appfunctions
TODO
Atualização mais recente |
Versão estável |
Versão candidata a lançamento |
Versão Beta |
Versão Alfa |
13 de agosto de 2025 |
- |
- |
- |
1.0.0-alpha03 |
Declarar dependências
Para adicionar uma dependência a appfunctions, adicione o repositório Maven do Google ao seu
projeto. Leia Repositório Maven do Google para ver mais informações.
Adicione as dependências dos artefatos necessários ao arquivo build.gradle
do
seu app ou módulo:
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")
}
Para mais informações sobre dependências, consulte Adicionar dependências de build.
Feedback
Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver
ideias para melhorar esta biblioteca. Consulte os
problemas conhecidos
nesta biblioteca antes de criar um novo. Adicione seu voto a um problema
clicando no botão de estrela.
Criar novo problema
Consulte a documentação do Issue Tracker
para saber mais.
Não há notas de versão para este artefato.
Versão 1.0
Versão 1.0.0-alpha03
13 de agosto de 2025
Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha03
. A versão 1.0.0-alpha03 contém estas confirmações.
Novos recursos
- Usar KDoc(s) como descrições de
AppFunction
- Restrinja valores para tipos Int e String usando as anotações
AppFunctionIntValueConstraint
e AppFunctionStringValueConstraint
, respectivamente.
- Especifique uma descrição em linguagem natural para modelos de linguagem grandes e uma descrição visível para o usuário exibida nos apps de agente.
- Conceder automaticamente permissões a URIs retornados de uma função de app usando a classe
AppFunctionUriGrant
.
- Escreva testes do Robolectric usando
AppFunctionTestRule
para testar a configuração da função do app.
Mudanças na API
- Adição de
AppFunctionStringValueConstraint
(I10e3f).
- Adicionar
AppFunctionIntValueConstraint
(Ifda13)
- Refatore
AppFunctionPrimitiveTypeMetadata
para classes de tipo de dados específicas. (I1a3b2)
- Adição do campo de descrição em
AppFunctionResponseMetadata
(I2332b)
- Remoção do requisito de permissão da API
setAppFunctionEnabled
(I1b92a)
- Adição do campo de descrição em
AppFunctionParameterMetadata
(I40a67)
- Adição de
AppFunctionUriGrant
(I67ca9).
- Adicione a API
resolveAppFunctionAppMetadata
. (I17408)
- Adição de
isDescribedByKdoc
na anotação @AppFunctionSerializable
(Ie14e7).
- Adicionar campo de descrição em
AppFunctionDataTypeMetadata
(I1bcac)
- Retorna
AppPackageMetadata
da API observeAppFunctions
. (I68c7e)
- Adicionar campo de descrição em
AppFunctionMetadata
(I060e2)
AppFunctionTestRule
foi adicionado (Id5ed0).
- Adição de
isDescribedByKdoc
na anotação @AppFunction
(Ia84d2).
Correções de bugs
- O
AppFunctionManagerCompat
só é compatível com dispositivos U+ (Ifa8d0)
- Adicione descrições de propriedades de tipos serializáveis compartilhados no XML de metadados de
AppFunction
(I2aab2)
- Adicione um elemento de descrição no XML de metadados
AppFunction
gerado (Ie5bf6)
Versão 1.0.0-alpha02
4 de junho de 2025
Lançamento de androidx.appfunctions:appfunctions:1.0.0-alpha02
, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02
e androidx.appfunctions:appfunctions-service:1.0.0-alpha02
. A versão 1.0.0-alpha02 contém estas confirmações.
Novos recursos
- Compatibilidade com APIs do Android 16.
- Melhor suporte para
AppFunctionSerializable(s)
parametrizado no tempo de compilação.
Mudanças na API
- Introdução da API
AppFunctionSchemaDefinition
, permitindo que os agentes definam seus próprios esquemas de funções predefinidas.
Correções de bugs
- Tratamento de erros para o estado de tempo de execução ausente de
AppFunctions
.
- Correção de bug menor na API
observeAppFunctions
para observar mudanças em AppFunctionComponentMetadata
.
- Outros registros de erros.
Versão 1.0.0-alpha01
7 de maio de 2025
Lançamento de androidx.appfunctions:appfunctions:1.0.0-alpha01
, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01
e androidx.appfunctions:appfunctions-service:1.0.0-alpha01
. A versão 1.0.0-alpha01 contém estas confirmações.
Novos recursos
A biblioteca AppFunctions
do Jetpack é criada com base nas APIs da plataforma android.app.appfunctions
. Essa biblioteca simplifica a exposição da funcionalidade do app ao Google Assistente e permite que ele interaja com as funções expostas do app.
androidx.appfunctions:appfunctions
: APIs de cliente principais para gerenciar (ativar/desativar) e interagir (pesquisar/executar) com AppFunctions
.
androidx.appfunctions:appfunctions-service
: APIs do lado do serviço para expor facilmente as funcionalidades do app como AppFunctions
.
androidx.appfunctions:appfunctions-compiler
: o compilador KSP necessário para gerar o código necessário para expor AppFunctions
.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-13 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-13 UTC."],[],[],null,["# appfunctions\n============\n\nAPI Reference \n[androidx.appfunctions](/reference/kotlin/androidx/appfunctions/package-summary) \nTODO \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|-----------------|----------------|-------------------|--------------|------------------------------------------------------------------------|\n| August 13, 2025 | - | - | - | [1.0.0-alpha03](/jetpack/androidx/releases/appfunctions#1.0.0-alpha03) |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on appfunctions, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n implementation \"androidx.appfunctions:appfunctions:1.0.0-alpha03\"\n implementation \"androidx.appfunctions:appfunctions-service:1.0.0-alpha03\"\n implementation \"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03\"\n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n implementation(\"androidx.appfunctions:appfunctions:1.0.0-alpha03\")\n implementation(\"androidx.appfunctions:appfunctions-service:1.0.0-alpha03\")\n implementation(\"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1709065%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1709065&template=2081773)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nThere are no release notes for this artifact.\n\nVersion 1.0\n-----------\n\n### Version 1.0.0-alpha03\n\nAugust 13, 2025\n\n`androidx.appfunctions:appfunctions-*:1.0.0-alpha03` is released. Version 1.0.0-alpha03 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/0fc7aad34811cf94484effd29bc2696bb001758f/appfunctions).\n\n**New Features**\n\n- Use KDoc(s) as `AppFunction` descriptions\n- Restrict values for Int and String types using `AppFunctionIntValueConstraint` and `AppFunctionStringValueConstraint` annotations, respectively.\n- Specify a natural language description for large language models and a user visible description displayed within agent apps.\n- Automatically grant permissions to URI(s) returned from an app function using `AppFunctionUriGrant` class.\n- Write Robolectric tests using `AppFunctionTestRule` for testing your app function setup.\n\n**API Changes**\n\n- Add `AppFunctionStringValueConstraint` ([I10e3f](https://android-review.googlesource.com/#/q/I10e3fdff4693e4bf2088d170c0ac654457e8411c))\n- Add `AppFunctionIntValueConstraint` ([Ifda13](https://android-review.googlesource.com/#/q/Ifda13b0c50b2caa57de6bd7844b987ce72e70379))\n- Refactor `AppFunctionPrimitiveTypeMetadata` to specific data type classes. ([I1a3b2](https://android-review.googlesource.com/#/q/I1a3b2e308411bf070c485d90fbe70e399a92642e))\n- Add description field in `AppFunctionResponseMetadata` ([I2332b](https://android-review.googlesource.com/#/q/I2332bb9f5cd75c6269c3b1d671a38e0cb3b20d3d))\n- Remove permission requirement from `setAppFunctionEnabled` API ([I1b92a](https://android-review.googlesource.com/#/q/I1b92a6627801c98aa5fd0e49445092467b9120b9))\n- Add description field in `AppFunctionParameterMetadata` ([I40a67](https://android-review.googlesource.com/#/q/I40a67b95d3f6616e0d747f1be317bb758e1697e6))\n- Add `AppFunctionUriGrant` ([I67ca9](https://android-review.googlesource.com/#/q/I67ca988737fbe065ce8874f5b9b233c218a2f85b))\n- Add `resolveAppFunctionAppMetadata` API. ([I17408](https://android-review.googlesource.com/#/q/I174089a944187498e16190cb931197cf1b763fc4))\n- Add `isDescribedByKdoc` in `@AppFunctionSerializable` annotation ([Ie14e7](https://android-review.googlesource.com/#/q/Ie14e74525a708d7d775c1c0ef579f2349b06e5e8))\n- Add description field in `AppFunctionDataTypeMetadata` ([I1bcac](https://android-review.googlesource.com/#/q/I1bcacafddd42cd5190655d3d6b343c5058384e5e))\n- Return `AppPackageMetadata` from `observeAppFunctions` API. ([I68c7e](https://android-review.googlesource.com/#/q/I68c7e47ea7f2dfc7094ae5c19978fbb3263a6868))\n- Add description field in `AppFunctionMetadata` ([I060e2](https://android-review.googlesource.com/#/q/I060e22469b217a09008ca291d6d76b9d76cf268a))\n- Add `AppFunctionTestRule` ([Id5ed0](https://android-review.googlesource.com/#/q/Id5ed0992d87e1587fb9e3c4a96a6d9f6b3c33724))\n- Add `isDescribedByKdoc` in `@AppFunction` annotation ([Ia84d2](https://android-review.googlesource.com/#/q/Ia84d2a381fce668eec266c3555779be61b419315))\n\n**Bug Fixes**\n\n- `AppFunctionManagerCompat` only supports U+ devices ([Ifa8d0](https://android-review.googlesource.com/#/q/Ifa8d06581a37fabcd8f68b1ab6c89ae889ed57ae))\n- Add property descriptions of shared serializable types in `AppFunction`'s metadata xml ([I2aab2](https://android-review.googlesource.com/#/q/I2aab2c3148393e6177c20963dd5a274d38defce2))\n- Add a description element in generated `AppFunction`'s metadata xml ([Ie5bf6](https://android-review.googlesource.com/#/q/Ie5bf6e021da58c3779a8e463a1e3366637e27c08))\n\n### Version 1.0.0-alpha02\n\nJune 4, 2025\n\n`androidx.appfunctions:appfunctions:1.0.0-alpha02`, `androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02`, and `androidx.appfunctions:appfunctions-service:1.0.0-alpha02` are released. Version 1.0.0-alpha02 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/b6c541571b9fb5471f965fc52612cb280713e5e4..786176dc2284c87a0e620477608e0aca9adeff15/appfunctions).\n\n**New Features**\n\n- Support Android 16 API(s).\n- Better support for parameterized `AppFunctionSerializable(s)` at compile time.\n\n**API Changes**\n\n- Introduced `AppFunctionSchemaDefinition` API, enabling agents to define their own predefined function schemas.\n\n**Bug Fixes**\n\n- Error handling for missing runtime enabled state of `AppFunctions`.\n- Minor bugfix in `observeAppFunctions` API to observe changes in `AppFunctionComponentMetadata`.\n- Additional error logs.\n\n### Version 1.0.0-alpha01\n\nMay 7, 2025\n\n`androidx.appfunctions:appfunctions:1.0.0-alpha01`, `androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01`, and `androidx.appfunctions:appfunctions-service:1.0.0-alpha01` are released. Version 1.0.0-alpha01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/b6c541571b9fb5471f965fc52612cb280713e5e4/appfunctions).\n\n**New Features**\n\nThe `AppFunctions` Jetpack library is built on top of `android.app.appfunctions` platform APIs. This library simplifies exposing your app's functionality to the Assistant and allows the Assistant to interact with the app's exposed functions.\n\n- **`androidx.appfunctions:appfunctions`** : Core client APIs for managing (enable/disable) and interacting with (search/execute) `AppFunctions`.\n- **`androidx.appfunctions:appfunctions-service`** : Service-side APIs to easily expose your app's functionalities as `AppFunctions`.\n- **`androidx.appfunctions:appfunctions-compiler`** : Required KSP compiler to generate necessary code for exposing `AppFunctions`."]]