appfunctions

  
Permite que apps compartilhem funcionalidades e dados com assistentes de IA, possibilitando que eles descubram e executem tarefas diretamente no dispositivo para atender às solicitações dos usuários.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
23 de setembro de 2026 - - - 1.0.0-alpha12

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-alpha12"
    // 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-alpha12"
}

Kotlin

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

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

23 de setembro de 2026

Lançamento de androidx.appfunctions:appfunctions:1.0.0-alpha12, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12 e androidx.appfunctions:appfunctions-testing:1.0.0-alpha12. A versão 1.0.0-alpha12 contém estes commits.

Mudanças na API

  • Exige que o autor da chamada AppFunctionData#serialize forneça metadados. (I61eca).
  • Adiciona getHandleAppFunctionRequestAdapter inline reificado além da sobrecarga baseada em Class. (Ic1b4e).
  • AppFunctionContext e AppFunctionConfiguration foram removidos (I9dd8f).
  • Adição de activityId a ExecuteAppFunctionRequest (I6ac86).
  • Adiciona registerAppFunction, registerAppFunctions, RegisterAppFunctionRequest e CallbackAppFunction como @ExperimentalAppFunctionsApi. (Idb2ca).
  • Adição de scope em AppFunctionMetadata e AppFunctionSearchSpec (I4344c)
  • Adiciona AppFunctionUriValueConstraint como uma API pública. (I75070)
  • Atualização do construtor AppFunctionPackageMetadata (I096f7).

Versão 1.0.0-alpha11

26 de agosto de 2026

Lançamento de androidx.appfunctions:appfunctions:1.0.0-alpha11, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11 e androidx.appfunctions:appfunctions-testing:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estes commits.

Mudanças na API

  • Adição de @AppFunctionSignature como API pública experimental. A API oferece suporte ao registro dinâmico de AppFunction via Jetpack. (I72e23, b/501032667)
  • Adicione AppFunctionState e AppFunctionManager#getAppFunctionStates. Isso substitui AppFunctionMetadata#isEnabled. Os metadados agora estão completamente separados do estado. (I8e490, b/494238383)
  • Add getAppFunctionActivityStates. (I41093, b/542075714)
  • Adicione ExtensionsAppFunctionService para oferecer suporte a apps que funcionam com sidecar. (I7cf10, b/524941402)
  • Atualize a API observeAppFunctions para corresponder à API da plataforma. (Ifa6fb, b/494238381)

Correções de bugs

  • Correção do problema em que metadados de tempo de execução ausentes podiam fazer o app falhar ao chamar setAppFunctionEnabled durante a OOBE. (Ibe229, b/536750020)
  • Desative temporariamente a validação de dados ao usar a API AppFunctionData#serialize até que os metadados venham da mesma fonte de verdade. (I6c95, b/545200019)

Versão 1.0.0-alpha10

1º de julho de 2026

Lançamento de androidx.appfunctions:appfunctions:1.0.0-alpha10, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10 e androidx.appfunctions:appfunctions-testing:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estes commits.

Mudanças na API

  • AppFunctionServiceEntryPoint foi adicionado. Todas as anotações AppFunction precisam ser declaradas no AppFunctionService anotado com AppFunctionServiceEntryPoint (Idc5d5, b/463909015).
  • As APIs AppFunction e AppFunctionConfiguration foram movidas . AppFunctionConfiguration será removido em uma versão futura porque será substituído por AppFunctionServiceEntryPoint (Iaff23, I4cf3e, b/517876475).
  • A API AppFunctionService foi atualizada para oferecer suporte a callbacks (I6e0d7, b/519880977).
  • Adição da API searchAppFunctions (I8c0f9, I1fa27, b/494239238).
  • Adição de functionNames a AppFunctionSearchSpec (I95f53, b/494239238).
  • A anotação AppFunctionInstruction foi adicionada (I21120, b/488994214).
  • Adicionamos a anotação AppFunctionSignature e as constantes acompanhantes para declarar assinaturas de funções de app registradas em tempo de execução. (I82a05, Ie2361, Ib6bb2)

Correções de bugs

  • Omitir enabledByDefault do XML gerado para AppFunctionSignatures (Ie2996, b/501032667).

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

Mudanças na API

  • Aceitar AppInteractionAttribution em ExecuteAppFunctionRequest (I70ad8, b/462092640)

Correções de bugs

  • Correção de um problema de compatibilidade do 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 estes commits.

Novos recursos

  • Foi adicionado suporte a Parcelable (s) além de PendingIntent (I8ab9f).
  • APIs para conversão de/para solicitação e resposta da plataforma (Ifdf20).

Mudanças na API

  • 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).
  • AppFunctionManagerCompat foi renomeado como AppFunctionManager. (Id9a78, b/448372122)
  • Remover APIs get/set para PendingIntent. (Ic7fd6, b/447530985)
  • Adicione suporte a Parcelables e migre PendingIntent para ser representado como um Parcelable. (I8ab9f, b/447530985)

Correções de bugs

  • Move as bibliotecas 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 estes commits.

Mudanças na API

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 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 que fazia com que o uso de List<PendingIntent> com AppFunction falhasse 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 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

  • Corrigir 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

  • Suporte às 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 os próprios esquemas de funções predefinidas.

Correções de bugs

  • Tratamento de erros para o estado ativado do ambiente 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 seu app como AppFunctions.
  • androidx.appfunctions:appfunctions-compiler: o compilador KSP obrigatório para gerar o código necessário na exposição de AppFunctions.