A2UI Compose

  
Il renderer Agent-to-UI (A2UI) di Jetpack Compose fornisce un'implementazione del protocollo A2UI, consentendo agli agenti AI di generare interfacce utente interattive e avanzate che eseguono il rendering dei componenti Compose nativi, senza eseguire codice arbitrario.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
23 settembre 2026 - - - 1.0.0-alpha01

Dichiara le dipendenze

Per aggiungere una dipendenza da A2UI Compose, 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:

Alla moda

dependencies {
    implementation "androidx.a2ui.compose:compose-runtime:1.0.0-alpha01"
    implementation "androidx.a2ui.compose:compose-ui:1.0.0-alpha01"
    androidTestImplementation "androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.a2ui.compose:compose-runtime:1.0.0-alpha01")
    implementation("androidx.a2ui.compose:compose-ui:1.0.0-alpha01")
    androidTestImplementation("androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01")
}

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.

Versione 1.0

Versione 1.0.0-alpha01

23 settembre 2026

androidx.a2ui.compose:compose-runtime:1.0.0-alpha01, androidx.a2ui.compose:compose-ui:1.0.0-alpha01 e androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01 sono stati rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

Il renderer Agent-to-UI (A2UI) di Jetpack Compose fornisce un'implementazione del protocollo A2UI, consentendo agli agenti AI di generare interfacce utente interattive e avanzate che eseguono il rendering dei componenti Compose nativi, senza eseguire codice arbitrario. Questa libreria mappa i messaggi del protocollo A2UI alle primitive di Compose, fornendo al contempo una reattività granulare basata sul sistema di stato di Compose Snapshot. La libreria fornisce anche API per la creazione di componenti e cataloghi personalizzati.

Modifiche alle API

  • A2uiBasicCatalogV1.CatalogId è stato aggiornato da .../v0_9_1/... a .../v0_9/... in linea con la specifica del protocollo A2UI canonico. (Idcc20)
  • Aggiorna l'ordine dei componenti in A2uiBasicCatalogV in modo che corrisponda esattamente alla specifica del catalogo di base. (I23093, b/547851648)
  • È stato aggiunto ChecksProperty a tutte le interfacce dei componenti pertinenti in A2uiBasicCatalogV1 e il valore della proprietà è stato reso disponibile tramite un parametro passato a TypedContent di ogni componente. (I9f393, b/547851648)
  • A2uiBasicCatalogV1.ChoicePicker e MaterialA2uiBasicCatalogV1Defaults.choicePicker aggiunti. (I875a6, b/547851648)
  • A2uiBasicCatalogV1.Modal e MaterialA2uiBasicCatalogV1Defaults.modal aggiunti. (Icd553, b/547851648)
  • Proprietà rinominate in A2uiBasicCatalogV1 per seguire lo stile di denominazione PascalCase. (I91512, b/547851648)
  • È stato aggiunto AccessibilityProperty a tutte le interfacce dei componenti in A2uiBasicCatalogV1 e il valore della proprietà è stato reso disponibile tramite un parametro passato a TypedContent di ogni componente. (I76b80, b/547851648)
  • A2uiBasicCatalogV1.TextField e MaterialA2uiBasicCatalogV1Defaults.textField aggiunti. (Ifdaec, b/547851648)
  • A2uiBasicCatalogV1.Video e MaterialA2uiBasicCatalogV1Defaults.video aggiunti. (I8595c, b/547851648)
  • A2uiBasicCatalogV1.AudioPlayer e MaterialA2uiBasicCatalogV1Defaults.audioPlayer aggiunti. (Ida509, b/547851648)
  • È stato aggiunto il supporto per le parole chiave dello schema format e if-then condizionale in a2ui-model e a2ui-engine e sono stati aggiornati gli schemi delle proprietà minime e massime A2uiBasicCatalogV1.DateTimeInput. (I556d5, b/553193771)
  • A2uiBasicCatalogV1.Slider e MaterialA2uiBasicCatalogV1Defaults.slider aggiunti. (Ieb72d, b/547851648)
  • A2uiBasicCatalogV1.CheckBox e MaterialA2uiBasicCatalogV1Defaults.checkBox aggiunti. (I84525, b/547851648)
  • A2uiBasicCatalogV1.Divider e MaterialA2uiBasicCatalogV1Defaults.divider aggiunti. (I91208, b/547851648)
  • A2uiBasicCatalogV1.Tabs e MaterialA2uiBasicCatalogV1Defaults.tabs aggiunti. (Ic33d3, b/547851648)
  • A2uiBasicCatalogV1.List e MaterialA2uiBasicCatalogV1Defaults.list aggiunti. (I89f73, b/547851648)
  • A2uiBasicCatalogV1.Icon e MaterialA2uiBasicCatalogV1Defaults.icon aggiunti. (I65524, b/547851648)
  • Aggiunto ProvideActionInterceptor per intercettare le azioni dei componenti secondari. (I6ae69, b/552486965)
  • È stato aggiunto il supporto per gli schemi del catalogo in linea di pubblicità in A2uiClientCapabilities e A2uiCoreCatalog. (I973cf, b/537714970)
  • A2uiBasicCatalogV1.Image e MaterialA2uiBasicCatalogV1Defaults.image aggiunti. (I673b3, b/547851648)
  • A2uiBasicCatalogV1.Button e MaterialA2uiBasicCatalogV1Defaults.button aggiunti. (I5215f, b/547851648)
  • Sono stati aggiunti A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.Column e MaterialA2uiBasicCatalogV1Defaults.row/ MaterialA2uiBasicCatalogV1Defaults.column. (Ibcbe7, b/547851648)
  • Sono stati aggiunti parametri default ai tipi enum, number e boolean A2uiProperty. (Id509e, b/547851648)
  • A2uiBasicCatalogV1.Card e MaterialA2uiBasicCatalogV1Defaults.card aggiunti. (Icf604, b/547851648)
  • Sono stati aggiunti i parametri isAdditionalPropertiesAllowed e additionalPropertiesSchema a A2uiProperty.nested e A2uiProperty.nestedList. (I72836, b/547815898)
  • Sono stati aggiunti i parametri minItems e maxItems all'elenco dei tipi A2uiProperty. (I716d3, b/547798330)
  • Sono stati aggiunti i tipi di proprietà A2uiProperty.enum, A2uiProperty.custom e A2uiProperty.dynamicCustom. (I0647d, b/545522395)
  • Sostituisci A2uiCoreSurfaceModel con A2uiSurfaceModel in observeA2uiComponentState per assicurarti che le API pubbliche in androidx.a2ui.compose.runtime non espongano tipi da androidx.a2ui.engine. (Ic45e2, b/544705890)
  • È stato aggiunto il composable A2uiTestSurface per montare e testare le superfici e i componenti A2UI in modo isolato. (I03c8a, b/527415570)
  • A2uiSchema ora supporta le parole chiave all'interno di ogni sottoclasse anziché sottoclassi dedicate per oneOf, allOf, anyOf, not, const, default e enum. (I6a6f8)
  • Sono state aggiunte API di test per il renderer A2UI di Compose. (I59c9f, b/527415570)
  • Aggiunte A2uiReadinessEvaluator e API correlate. (Ib37d3, b/527415547, b/524122705)
  • Sono stati aggiunti A2uiComponentCollection, A2uiFunctionCollection e A2uiCoreComponentDefinitionCollection e le API del catalogo sono state aggiornate per utilizzare le nuove raccolte. (I96438, b/527415547)
  • È stata aggiunta una funzione di fabbrica A2uiMessageParser. (I8596a, b/524122705)
  • Aggiunta dell'interfaccia marker A2uiRuntimeCatalog e delle API in androidx.a2ui.compose.ui per definire componenti e cataloghi. (Ibea7a, b/527415547, b/524122705)
  • androidx.compose.runtime:runtime-a2ui spostato in androidx.a2ui.compose:compose-runtime. (Ifc7cf, b/524122705)

Correzioni di bug

  • La dipendenza androidx.lifecycle:lifecycle-runtime è stata aggiornata alla versione 2.10.0. Questa versione è necessaria per l'esecuzione dei controlli lint del runtime del ciclo di vita in bundle con AGP versione 9.5.0-alpha04 o successive. (Id18ea, b/556807521)
  • compileSdk per le librerie Compose aggiornato alla versione 37.1. Ciò richiederà l'aggiornamento transitivo di compileSdk per tutte le app e le librerie che utilizzano Compose. (I05b0f)
  • Allineamento orizzontale predefinito Column aggiornato a Alignment.Start in A2UI Basic Catalog V1. Ia1c6db
  • Aggiornamento dell'allineamento verticale predefinito Row a Alignment.Top in A2UI Basic Catalog V1. If0bca4