appfunctions

  
TODO
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
5 de novembro de 2025 - - - 1.0.0-alpha06

Declarar dependências

Para adicionar uma dependência a appfunctions, inclua o repositório Maven do Google no 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-alpha07"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha07"
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha07"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha07")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha07")
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha07")
}

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 essa biblioteca. Consulte os problemas conhecidos nessa 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-alpha06

5 de novembro de 2025

Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estes commits.

Novos recursos

  • Compatibilidade com a incorporação de recursos como parte da resposta AppFunction
  • Possibilidade de uso da FLAG_GRANT_PERSISTABLE_URI_PERMISSION em AppFunctionUriGrant

Mudanças em APIs

Correções de bugs

  • Correção do problema que gerava uma falha ao ignorar um campo obrigatório anulável durante a construção de AppFunctionData (I52195).
  • Correção do problema em que o uso de List<PendingIntent> com AppFunction falhava no momento da compilação (Iebde7).
  • Correção do problema em que os metadados de ByteArray eram gerados incorretamente como List<ByteArray> (I2e499).

Versão 1.0.0-alpha05

8 de outubro de 2025

Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estes commits.

Novos recursos

  • Necessidade de fornecer campos obrigatórios ao construir AppFunctionData
  • Validação de AppFunctionData em relação a valores de restrição

Mudanças em APIs

Correções de bugs

  • Inclusão da verificação de AppFunctionsData em relação a campos obrigatórios (I36b16, b/394553462).
  • Correção do problema em que o estado opcional dos parâmetros não era respeitado ao substituir uma interface.
  • Geração de um arquivo XML vazio mesmo quando não houver AppFunctions, já que AppSearch espera o arquivo correspondente especificado no manifesto do app.

Versão 1.0.0-alpha04

10 de setembro de 2025

Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estes commits.

Correções de bugs

  • Correção de problemas do R8 para builds de lançamento.

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 estes commits.

Novos recursos

  • Uso de KDoc(s) como descrições de AppFunction.
  • Restrição de valores para tipos Int e String usando as anotações AppFunctionIntValueConstraint e AppFunctionStringValueConstraint, respectivamente.
  • Especificação de 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.
  • Concessão automática de permissões a URIs retornados de uma função de app usando a classe AppFunctionUriGrant.
  • Criação de testes do Robolectric usando AppFunctionTestRule para testar a configuração das funções de apps.

Mudanças em APIs

  • Adição de AppFunctionStringValueConstraint (I10e3f).
  • Adição de AppFunctionIntValueConstraint (Ifda13).
  • Refatoração de 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).
  • Adição da API resolveAppFunctionAppMetadata (I17408).
  • Adição de isDescribedByKdoc na anotação @AppFunctionSerializable (Ie14e7).
  • Adição de campo de descrição em AppFunctionDataTypeMetadata (I1bcac).
  • Retorno de AppPackageMetadata da API observeAppFunctions (I68c7e).
  • Adição de campo de descrição em AppFunctionMetadata (I060e2).
  • Adição de AppFunctionTestRule (Id5ed0).
  • Adição de isDescribedByKdoc na anotação @AppFunction (Ia84d2).

Correções de bugs

  • O AppFunctionManagerCompat só é compatível com dispositivos U+ (Ifa8d0)
  • Adição de descrições de propriedades de tipos serializáveis compartilhados no XML de metadados de AppFunction (I2aab2)
  • Adição de um elemento de descrição no XML de metadados de 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 estes commits.

Novos recursos

  • Compatibilidade com APIs do Android 16.
  • Mais compatibilidade com a classe AppFunctionSerializable(s) parametrizada no tempo de compilação.

Mudanças em APIs

  • 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 secundária 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 estes commits.

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 obrigatório para gerar o código necessário na exposição de AppFunctions.