appfunctions

  
Consente alle app di condividere funzionalità e dati con gli assistenti AI, consentendo loro di scoprire ed eseguire attività direttamente sul dispositivo per soddisfare le richieste degli utenti.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
6 maggio 2026 - - - 1.0.0-alpha09

Dichiara le dipendenze

Per aggiungere una dipendenza da appfunctions, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

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")
}

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Non sono disponibili note di rilascio per questo artefatto.

Versione 1.0

Versione 1.0.0-alpha09

6 maggio 2026

androidx.appfunctions:appfunctions-*:1.0.0-alpha09 è stato rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

  • Accetta AppInteractionAttribution in ExecuteAppFunctionRequest (I70ad8, b/462092640)

Correzioni di bug

  • Correzione del problema di compatibilità di AppFunctionUriGrant su SDK37 (I21110, b/485613578)

Versione 1.0.0-alpha08

11 marzo 2026

androidx.appfunctions:appfunctions-*:1.0.0-alpha08 è stato rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Aggiunto il supporto per Parcelable oltre a PendingIntent (I8ab9f)
  • API per la conversione da/a richiesta e risposta della piattaforma (Ifdf20),

Modifiche alle API

  • Conformità dei parametri alla guida di stile. (I69b2d)
  • Aggiungi API per la conversione da/a richiesta e risposta della piattaforma (Ifdf20, b/476047880)
  • Rinomina AppFunctionManagerCompat in AppFunctionManager. (Id9a78, b/448372122)
  • Rimuovi le API get/set per PendingIntent. (Ic7fd6, b/447530985)
  • Aggiungi il supporto per Parcelable e migra PendingIntent in modo che venga rappresentato come Parcelable. (I8ab9f, b/447530985)

Correzioni di bug

  • Sposta le librerie per utilizzare la destinazione Java 11. Ciò significa che il bytecode prodotto sarà Java 11 (versione 55 del file di classe) e potrebbe richiedere la desugarizzazione per utilizzare la libreria (If4c2a, b/457821470)

Versione 1.0.0-alpha07

19 novembre 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha07 è stato rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche alle API

Correzioni di bug

  • È stato risolto un problema relativo ai parametri di primo livello obbligatori non nulli (Ic60fc, b/456717542).

Versione 1.0.0-alpha06

5 novembre 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Supportare l'incorporamento della risorsa come parte della risposta di AppFunction
  • Consenti l'utilizzo di FLAG_GRANT_PERSISTABLE_URI_PERMISSION in AppFunctionUriGrant

Modifiche alle API

Correzioni di bug

  • Risolvi il problema per cui l'ignoranza del campo obbligatorio nullable non riusciva durante la costruzione di AppFunctionData (I52195)
  • Correzione del problema che causava l'errore di compilazione durante l'utilizzo di List<PendingIntent> con AppFunction (Iebde7)
  • Risolvi il problema per cui i metadati di ByteArray sono stati generati in modo errato come List<ByteArray> (I2e499)

Versione 1.0.0-alpha05

8 ottobre 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Imponi la compilazione dei campi obbligatori durante la creazione di AppFunctionData
  • Convalida di AppFunctionData rispetto ai valori di vincolo

Modifiche alle API

Correzioni di bug

  • Aggiungi il controllo del campo obbligatorio AppFunctionsData. (I36b16, b/394553462)
  • Risolvi il problema per cui lo stato facoltativo del parametro non veniva rispettato durante l'override di un'interfaccia.
  • Genera un file XML vuoto anche quando non sono presenti AppFunctions, poiché AppSearch prevede il file corrispondente specificato nel manifest dell'app.

Versione 1.0.0-alpha04

10 settembre 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Correzioni di bug

  • Risolvi i problemi di R8 per le build di rilascio.

Versione 1.0.0-alpha03

13 agosto 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Utilizzare KDoc come descrizioni di AppFunction
  • Limita i valori per i tipi Int e String utilizzando rispettivamente le annotazioni AppFunctionIntValueConstraint e AppFunctionStringValueConstraint.
  • Specifica una descrizione in linguaggio naturale per i modelli linguistici di grandi dimensioni e una descrizione visibile all'utente visualizzata all'interno delle app di agenti.
  • Concedi automaticamente le autorizzazioni agli URI restituiti da una funzione dell'app utilizzando la classe AppFunctionUriGrant.
  • Scrivi test Robolectric utilizzando AppFunctionTestRule per testare la configurazione della funzione dell'app.

Modifiche alle API

  • Aggiungi AppFunctionStringValueConstraint (I10e3f)
  • Aggiungi AppFunctionIntValueConstraint (Ifda13)
  • Esegui il refactoring di AppFunctionPrimitiveTypeMetadata in classi di tipi di dati specifici. (I1a3b2)
  • Aggiungi campo Descrizione in AppFunctionResponseMetadata (I2332b)
  • Rimozione del requisito di autorizzazione dall'API setAppFunctionEnabled (I1b92a)
  • Aggiungi il campo Descrizione in AppFunctionParameterMetadata (I40a67)
  • Aggiungi AppFunctionUriGrant (I67ca9)
  • Aggiungi l'API resolveAppFunctionAppMetadata. (I17408)
  • Aggiungi l'annotazione isDescribedByKdoc in @AppFunctionSerializable (Ie14e7)
  • Aggiungi il campo Descrizione in AppFunctionDataTypeMetadata (I1bcac)
  • Restituisci AppPackageMetadata dall'API observeAppFunctions. (I68c7e)
  • Aggiungi il campo Descrizione in AppFunctionMetadata (I060e2)
  • Aggiungi AppFunctionTestRule (Id5ed0)
  • Aggiungi l'annotazione isDescribedByKdoc in @AppFunction (Ia84d2)

Correzioni di bug

  • AppFunctionManagerCompat supporta solo i dispositivi U+ (Ifa8d0)
  • Aggiungi le descrizioni delle proprietà dei tipi serializzabili condivisi nel file XML dei metadati di AppFunction (I2aab2)
  • Aggiungi un elemento di descrizione nel file XML dei metadati AppFunction generato (Ie5bf6)

Versione 1.0.0-alpha02

4 giugno 2025

androidx.appfunctions:appfunctions:1.0.0-alpha02, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02 e androidx.appfunctions:appfunctions-service:1.0.0-alpha02 sono stati rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Supporta le API Android 16.
  • Supporto migliore per AppFunctionSerializable(s) parametrizzati in fase di compilazione.

Modifiche alle API

  • È stata introdotta l'API AppFunctionSchemaDefinition, che consente agli agenti di definire i propri schemi di funzioni predefinite.

Correzioni di bug

  • Gestione degli errori per lo stato di abilitazione del runtime mancante di AppFunctions.
  • Correzione di bug minore nell'API observeAppFunctions per osservare le modifiche in AppFunctionComponentMetadata.
  • Log degli errori aggiuntivi.

Versione 1.0.0-alpha01

7 maggio 2025

androidx.appfunctions:appfunctions:1.0.0-alpha01, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01 e androidx.appfunctions:appfunctions-service:1.0.0-alpha01 sono stati rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

La libreria Jetpack AppFunctions è basata sulle API della piattaforma android.app.appfunctions. Questa libreria semplifica l'esposizione delle funzionalità della tua app all'assistente e consente all'assistente di interagire con le funzioni esposte dell'app.

  • androidx.appfunctions:appfunctions: API client principali per la gestione (attivazione/disattivazione) e l'interazione (ricerca/esecuzione) di AppFunctions.
  • androidx.appfunctions:appfunctions-service: API lato server per esporre facilmente le funzionalità della tua app come AppFunctions.
  • androidx.appfunctions:appfunctions-compiler: compilatore KSP obbligatorio per generare il codice necessario per esporre AppFunctions.