appfunctions

  
Permite que os apps compartilhem funcionalidades e dados com assistentes de IA, permitindo que eles descubram e executem tarefas diretamente no dispositivo para atender às solicitações do usuário.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
6 de maio de 2026 - - - 1.0.0-alpha09

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-alpha09"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha09"
    // 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-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha09")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha09")
    // 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-alpha09")
}

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-alpha09

6 de maio de 2026

Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Mudanças em APIs

  • Aceitação de AppInteractionAttribution em ExecuteAppFunctionRequest (I70ad8, b/462092640)

Correções de bugs

  • Correção do problema de compatibilidade de AppFunctionUriGrant no SDK37 (I21110, b/485613578)

Versão 1.0.0-alpha08

11 de março de 2026

Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Novos recursos

  • Adição de suporte a Parcelable (links em inglês) além de PendingIntent (I8ab9f)
  • APIs para conversão de/para solicitação e resposta da plataforma (Ifdf20)

Mudanças em APIs

  • Conformidade de parâmetros com o guia de estilo. (I69b2d)
  • Adição de APIs para conversão de/para solicitação e resposta da plataforma (Ifdf20, b/476047880)
  • O AppFunctionManagerCompat foi renomeado como AppFunctionManager. (Id9a78, b/448372122)
  • Remoção das APIs get/set para PendingIntent. (Ic7fd6, b/447530985)
  • Adição de suporte a Parcelables e migração de PendingIntent para ser representado como um Parcelable. (I8ab9f, b/447530985)

Correções de bugs

  • As bibliotecas foram movidas para usar o destino Java 11. Isso significa que o bytecode produzido será Java 11 (versão 55 do arquivo de classe) e poderá exigir simplificação para usar a biblioteca (If4c2a, b/457821470)

Versão 1.0.0-alpha07

19 de novembro de 2025

Lançamento de androidx.appfunctions:appfunctions-*:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

Mudanças em APIs

Correções de bugs

  • Correção do problema com parâmetros obrigatórios de nível superior não nulos (Ic60fc, b/456717542)

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 estas confirmações.

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 tempo de 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 estas confirmações.

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 estas confirmações (link em inglês).

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 estas confirmações.

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

  • AppFunctionManagerCompat oferece suporte apenas a 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 estas confirmações.

Novos recursos

  • Suporte a 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ção predefinidos.

Correções de bugs

  • Tratamento de erros para o estado ativado do ambiente de execução ausente de AppFunctions.
  • Correção de bug menor na API observeAppFunctions para observar mudanças em AppFunctionComponentMetadata.
  • Registros de erros adicionais.

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 do Jetpack AppFunctions é criada com base nas APIs da plataforma android.app.appfunctions. Essa biblioteca simplifica a exposição da funcionalidade do app ao Assistente e permite que o Assistente interaja com as funções expostas do app.

  • androidx.appfunctions:appfunctions: APIs principais do cliente para gerenciar (ativar/desativar) e interagir com (pesquisar/executar) 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.