Riquadri di Wear OS

Crea applicazioni per gli smartwatch Wear OS by Google.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
22 ottobre 2025 1.5.0 - - 1.6.0-alpha02

Dichiara le dipendenze

Per aggiungere una dipendenza da Wear, 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 {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0")
}

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

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. 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 ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.6

Versione 1.6.0-alpha02

22 ottobre 2025

androidx.wear.tiles:tiles-*:1.6.0-alpha02 è stato rilasciato. La versione 1.6.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Le anteprime dei riquadri sono state aggiornate per supportare la gestione automatica delle risorse tramite ProtoLayoutScope. Se utilizzi le risorse immagine direttamente nel layout tramite materialScopeWithScope o ProtoLayoutScope, non è più necessario specificare onTileResourcesRequest e le risorse in modo specifico in TilePreviewData, in quanto verranno raccolte automaticamente. (I58516)

Correzioni di bug

  • ProtoLayoutScope creato internamente da TileService ora include VersionInfo di ProtoLayout Renderer. (I6eee2, b/450259727)

Versione 1.6.0-alpha01

24 settembre 2025

androidx.wear.tiles:tiles-*:1.6.0-alpha01 è stato rilasciato. La versione 1.6.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Aggiungi API del fornitore per accettare PendingIntent come azione di clic (I01978, b/433802488)
  • Consenti di specificare l'ID riquadro nella richiesta di aggiornamento. (Ia05c3, b/421346031)
  • Aggiungi il metodo in TileRequest per ottenere l'oggetto ProtoLayoutScope per l'istanza del riquadro corrispondente. (I5b8de, b/428692428)

Modifiche alle API

  • Consenti di non eseguire l'override di onTileResourcesRequest quando vengono utilizzate le API ProtoLayoutScope. (I1773d)

Correzioni di bug

  • Aggiungi l'implementazione per supportare PendingIntent in ProtoTiles. (I38167, b/430610429)
  • Salva le risorse utilizzate da ProtoLayoutScope per essere inviate correttamente in onTileResourcesRequest per i renderer precedenti che non le raggruppano nella risposta del riquadro. (I063a8, b/428692502)
  • Spostamento di minSdk predefinito dall'API 21 all'API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)

Versione 1.5

Versione 1.5.0

4 giugno 2025

androidx.wear.tiles:tiles-*:1.5.0 è stato rilasciato. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • È stata aggiunta una nuova API TileService.onRecentInteractionEvents() per l'elaborazione in batch degli eventi dei riquadri di interazione (Entra / Esci).
    • Le API esistenti in TileService per onEnterEvent e onLeaveEvent sono deprecate e non funzioneranno a partire dall'SDK 36+ per le app che hanno come target l'API 36 o versioni successive
  • Correzione di bug critici per tutti i client che hanno come target SDK superiore a 34 e che richiedono un aggiornamento del riquadro sull'API 34 che causerebbe un SecurityException.
  • A partire da Wear 6 (livello SDK 36+), tutti i riquadri verranno visualizzati in un carattere di sistema definito da ciascun dispositivo.

Versione 1.5.0-rc01

20 maggio 2025

androidx.wear.tiles:tiles-*:1.5.0-rc01 viene rilasciato senza modifiche rispetto alla release precedente. La versione 1.5.0-rc01 contiene questi commit.

Versione 1.5.0-beta02

7 maggio 2025

androidx.wear.tiles:tiles-*:1.5.0-beta02 è stato rilasciato. La versione 1.5.0-beta02 contiene questi commit.

Versione 1.5.0-beta01

9 aprile 2025

androidx.wear.tiles:tiles-*:1.5.0-beta01 è stato rilasciato. La versione 1.5.0-beta01 contiene questi commit.

Nuove funzionalità

La release 1.5.0-beta01 di Wear Tiles indica che questa release della libreria è completa e l'API è bloccata (tranne dove contrassegnata come sperimentale). Wear Tiles 1.5 include le seguenti nuove funzionalità e API:

  • È stata aggiunta una nuova API TileService.onRecentInteractionEvents() per l'elaborazione in batch degli eventi dei riquadri di interazione (Entra / Esci).
    • Le API esistenti in TileService per onEnterEvent e onLeaveEvent sono deprecate e non funzioneranno a partire dall'SDK 36+ per le app che hanno come target l'API 36 o versioni successive
  • Correzione di bug critici per tutti i client che hanno come target SDK superiore a 34 e che richiedono un aggiornamento del riquadro sull'API 34 che causerebbe un SecurityException.
  • A partire da Wear 6 (livello SDK 36+), tutti i riquadri verranno visualizzati in un carattere di sistema definito da ciascun dispositivo.

Versione 1.5.0-alpha10

12 marzo 2025

androidx.wear.tiles:tiles-*:1.5.0-alpha10 è stato rilasciato. La versione 1.5.0-alpha10 contiene questi commit.

Versione 1.5.0-alpha09

26 febbraio 2025

androidx.wear.tiles:tiles-*:1.5.0-alpha09 è stato rilasciato. La versione 1.5.0-alpha09 contiene questi commit.

Versione 1.5.0-alpha08

12 febbraio 2025

androidx.wear.tiles:tiles-*:1.5.0-alpha08 è stato rilasciato. La versione 1.5.0-alpha08 contiene questi commit.

Modifiche alle API

  • TileService.onRecentInteractionEvents() per restituire ListenableFuture<Void> per consentire attività di lunga durata. (Iaa6c5)

Versione 1.5.0-alpha07

29 gennaio 2025

androidx.wear.tiles:tiles-*:1.5.0-alpha07 è stato rilasciato. La versione 1.5.0-alpha07 contiene questi commit.

Versione 1.5.0-alpha06

15 gennaio 2025

androidx.wear.tiles:tiles-*:1.5.0-alpha06 è stato rilasciato. La versione 1.5.0-alpha06 contiene questi commit.

Modifiche alle API

  • Rinominato in metodo processRecentInteractionEvents in onRecentInteractionEvents. (Iec3d5)

Versione 1.5.0-alpha05

11 dicembre 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha05 è stato rilasciato. La versione 1.5.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Aggiungi l'API per TileService per elaborare gli eventi di interazione in batch. (I04d1b)

Correzioni di bug

  • Questa libreria ora utilizza le annotazioni di nullabilità JSpecify, che sono di tipo use. Gli sviluppatori Kotlin devono utilizzare il seguente argomento del compilatore per imporre l'utilizzo corretto: -Xjspecify-annotations=strict (questo è il valore predefinito a partire dalla versione 2.1.0 del compilatore Kotlin). (I390e9, b/326456246)
  • È stato corretto il bug per cui la richiesta di aggiornamenti dei riquadri sull'API 34 quando l'app targetSdk è superiore a 34 causava un SecurityException (If62a1)
  • È stata corretta una dipendenza da WearSdk nei test Robolectric. (I37796)

Versione 1.5.0-alpha04

13 novembre 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha04 è stato rilasciato. La versione 1.5.0-alpha04 contiene questi commit.

Versione 1.5.0-alpha03

30 ottobre 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha03 è stato rilasciato. La versione 1.5.0-alpha03 contiene questi commit.

Versione 1.5.0-alpha02

16 ottobre 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha02 è stato rilasciato. La versione 1.5.0-alpha02 contiene questi commit.

Correzioni relative alla sicurezza

  • A partire da questa modifica, androidx viene compilato in base a protobuf 4.28.2 per risolvere CVE-2024-7254. Esegui l'upgrade della dipendenza dalla versione 1.5.0-alpha01 di androidx.wear.tiles:tiles-proto alla versione 1.5.0-alpha02 per risolvere il rischio di vulnerabilità.

Versione 1.5.0-alpha01

2 ottobre 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha01 è stato rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Versione 1.4

Versione 1.4.1

16 ottobre 2024

androidx.wear.tiles:tiles-*:1.4.1 è stato rilasciato. La versione 1.4.1 contiene questi commit.

Correzioni relative alla sicurezza

  • A partire da questa modifica, androidx viene compilato in base a protobuf 4.28.2 per risolvere CVE-2024-7254. Esegui l'upgrade della dipendenza dalla versione 1.4.0 di androidx.wear.tiles:tiles-proto alla versione 1.4.1 per risolvere il rischio di vulnerabilità.

Versione 1.4.0

7 agosto 2024

androidx.wear.tiles:tiles-*:1.4.0 è stato rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

  • Supporto degli strumenti per specificare dati della piattaforma personalizzati per le anteprime dei riquadri in Android Studio.

Versione 1.4.0-rc01

24 luglio 2024

androidx.wear.tiles:tiles-*:1.4.0-rc01 viene rilasciato senza modifiche rispetto alla release precedente. La versione 1.4.0-rc01 contiene questi commit.

Versione 1.4.0-beta01

10 luglio 2024

androidx.wear.tiles:tiles-*:1.4.0-beta01 è stato rilasciato. La versione 1.4.0-beta01 contiene questi commit.

Nuove funzionalità

La release 1.4.0-beta01 di Wear Tiles indica che questa release della libreria è completa e l'API è bloccata (tranne dove contrassegnata come sperimentale). Wear Tiles 1.4 include le seguenti nuove funzionalità e API:

  • Supporto degli strumenti per specificare dati della piattaforma personalizzati per le anteprime dei riquadri in Android Studio.

Versione 1.4.0-alpha05

26 giugno 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha05 è stato rilasciato. La versione 1.4.0-alpha05 contiene questi commit.

Versione 1.4.0-alpha04

29 maggio 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha04 è stato rilasciato. La versione 1.4.0-alpha04 contiene questi commit.

Versione 1.4.0-alpha03

14 maggio 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha03 è stato rilasciato. La versione 1.4.0-alpha03 contiene questi commit.

Correzioni di bug

  • TileService#getActiveTilesAsync ora utilizza l'API WearSdk (se disponibile) per fornire un risultato più preciso. (I57bd8)

Versione 1.4.0-alpha02

1° maggio 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha02 è stato rilasciato. La versione 1.4.0-alpha02 contiene questi commit.

Modifiche alle API

  • Sposta tileId nel parametro del costruttore di Builder come campo obbligatorio e documenta il valore del timestamp predefinito nel getter. (I98c2b)
  • Aggiungi i messaggi proto TileInteractionEvent, TileEnter e TileLeave e i wrapper Java necessari per il batching degli eventi di entrata/uscita dei riquadri. (I112b0)
  • Esegui il refactoring di TileRenderer per utilizzare un builder anziché un oggetto TileRenderer.Config. (Ib66f9)
  • Aggiungi un attributo platformDataProviders a TileRenderer.Config. (I6030d)
  • Aggiungi un nuovo costruttore a TileRenderer che supporti una nuova classe TileRenderer.Config. Gli altri costruttori sono ritirati. (Iae7ff)
  • Aggiungi un campo platformDataValues a TilePreviewData per consentire l'override dei valori dei dati della piattaforma. (If437a)

Correzioni di bug

  • Documenta che il valore predefinito di TileRenderer.Config.Builder#setTilesTheme è zero. (Iced18)

Versione 1.4.0-alpha01

6 marzo 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha01 è stato rilasciato. La versione 1.4.0-alpha01 contiene questi commit.

Versione 1.3

Versione 1.3.0

7 febbraio 2024

androidx.wear.tiles:tiles-*:1.3.0 è stato rilasciato. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

  • Strumenti aggiornati per il supporto dell'anteprima delle tessere.
  • Supporto per l'interrogazione delle tessere attive appartenenti all'app.

Ulteriori modifiche

  • Per un insieme più completo delle modifiche introdotte nella versione 1.3.0, consulta le note di rilascio beta01.

Versione 1.3.0-rc01

24 gennaio 2024

androidx.wear.tiles:tiles-*:1.3.0-rc01 è stato rilasciato. La versione 1.3.0-rc01 contiene questi commit.

Modifiche alle API

  • TileService#getActiveTilesSnapshotAsync rinominato in getActiveTilesAsync. (If6b87)

Versione 1.3.0-beta01

10 gennaio 2024

androidx.wear.tiles:tiles-*:1.3.0-beta01 è stato rilasciato. La versione 1.3.0-beta01 contiene questi commit.

La release 1.3.0-beta01 di Wear Tiles indica che questa release della libreria è completa e l'API è bloccata (tranne dove contrassegnata come sperimentale). Wear Tiles 1.3 include le seguenti nuove funzionalità e API:

  • Il modulo per gli strumenti dei riquadri di Wear è stato aggiornato per supportare l'anteprima dei riquadri ed è pronto per la pubblicazione.
  • Supporto per l'interrogazione delle schede attive dell'app con TileService.getActiveTilesSnapshotAsync.

Versione 1.3.0-alpha04

13 dicembre 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha04 è stato rilasciato. La versione 1.3.0-alpha04 contiene questi commit.

Versione 1.3.0-alpha03

29 novembre 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha03 è stato rilasciato. La versione 1.3.0-alpha03 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta una nuova API TileService#getActiveTilesSnapshotAsync per eseguire query sui riquadri attivi dell'app. (I6850e)

Modifiche alle API

  • Rinomina @TilePreview in @Preview (Ifc08a)

Versione 1.3.0-alpha02

15 novembre 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha02 è stato rilasciato. La versione 1.3.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Abbiamo aggiunto un'API sperimentale per scalare automaticamente la dimensione del testo in base allo spazio disponibile all'interno dell'elemento principale. (Ibbe63)

Versione 1.3.0-alpha01

18 ottobre 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha01 è stato rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Fornisci il contesto come parametro del metodo di anteprima anziché come parametri di callback TilePreviewData. (I5e97d)
  • Il modulo per gli strumenti dei riquadri di Wear è stato aggiornato per supportare l'anteprima dei riquadri ed è pronto per la pubblicazione. (I63d0f)

Versione 1.2

Versione 1.2.0

9 agosto 2023

androidx.wear.tiles:tiles-*:1.2.0 è stato rilasciato. La versione 1.2.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

  • Release stabile di Wear Tiles 1.2.0 (scopri di più)
  • Le schede 1.2 aggiungono il supporto per l'associazione degli elementi di layout ai dati della piattaforma (per aggiornamenti più rapidi) e all'animazione. Per le istruzioni per la migrazione, consulta le note di rilascio per (1.2.0-rc01)

Versione 1.2.0-rc01

26 luglio 2023

androidx.wear.tiles:tiles-*:1.2.0-rc01 è stato rilasciato. La versione 1.2.0-rc01 contiene questi commit.

  • Con la release v1.2, la libreria Tiles è stata sottoposta a refactoring e la maggior parte delle funzionalità e delle API è stata spostata nella nuova libreria ProtoLayout (pacchetto androidx.wear.protolayout), mentre un piccolo sottoinsieme è rimasto in Tiles (androidx.wear.tiles):

    • Tutti i nomi delle classi sono rimasti invariati, sono state aggiunte solo alcune classi alla v1.1
    • La maggior parte delle API è rimasta invariata e l'unica modifica riguarda il nome del pacchetto.
    • Alcuni dei metodi in TileService/TileBuilder sono stati ritirati e ora hanno versioni rinominate che accettano nuovi tipi di ProtoLayout anziché quelli ritirati.

  • Per semplificare questa migrazione, abbiamo creato un piccolo insieme di istruzioni e uno script che esegue questa ridenominazione. Consulta questa pagina.

Modifiche alle API

  • Abbiamo limitato la profondità massima di un layout a 30 elementi nidificati nel riquadro. Se questa profondità viene superata, il renderer dei riquadri mostrerà un layout precedentemente espanso. (I8a74b)

Versione 1.2.0-beta01

21 giu 2023

androidx.wear.tiles:tiles-*:1.2.0-beta01 viene rilasciato senza modifiche. La versione 1.2.0-beta01 contiene questi commit.

Versione 1.2.0-alpha07

7 giugno 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha07 è stato rilasciato. La versione 1.2.0-alpha07 contiene questi commit.

Nuove funzionalità

  • TileRenderer.setState consente di impostare lo stato della sessione di rendering. Questo stato verrà applicato al layout attuale e a quelli futuri (fino all'impostazione di un nuovo stato) (Iaaf35)
  • I tipi di protolayout sono ora completamente supportati in tutte le API di rendering dei riquadri. (I428b0)

Correzioni di bug

  • Ora è possibile impostare un tema personalizzato in ProtoLayoutViewInstance. (Iae8c0)

Versione 1.2.0-alpha06

24 maggio 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha06 è stato rilasciato. La versione 1.2.0-alpha06 contiene questi commit.

Modifiche alle API

  • Rinomina StateEntryValue in DynamicDataValue e aggiorna le API di stato in modo che utilizzino DynamicDataKey (If1c01)
  • Stiamo limitando il numero di voci consentite in StateStore per garantire che l'utilizzo della memoria e il tempo di aggiornamento dello stato siano ben contenuti e controllati per ogni istanza di StateStore. Di conseguenza, lo sviluppatore deve assicurarsi di non avere più di MAX_STATE_ENTRY_COUNT voci nella mappa, altrimenti riceverà un errore IllegalStateException durante la creazione o l'aggiornamento di StateStore. (Ibadb3)

Versione 1.2.0-alpha05

10 maggio 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha05 è stato rilasciato. La versione 1.2.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Abbiamo aggiunto l'ID riquadro agli eventi e alle richieste dei riquadri. Questo ID può essere utilizzato per associare alcuni dati a un'istanza di riquadro nel carosello. (Ic4f83)

Modifiche alle API

  • TileRenderer.inflateAsync ora restituisce un ListenableFuture. (I2f2b9)
  • I generatori di riquadri che hanno una sostituzione nella libreria protolayout sono ora contrassegnati come ritirati. (Ie2029)

Correzioni di bug

  • La documentazione Javadoc per TileService.onTileResourcesRequest ora chiarisce quando il metodo potrebbe essere chiamato dal sistema. (Iee037)

Versione 1.2.0-alpha04

19 aprile 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha04 è stato rilasciato. La versione 1.2.0-alpha04 contiene questi commit.

Correzioni di bug

  • Le dipendenze di Gradle ora sono impostate correttamente su api anziché su implementation, se necessario. (I40503)

Versione 1.2.0-alpha03

5 aprile 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha03 è stato rilasciato. La versione 1.2.0-alpha03 contiene questi commit.

Modifiche alle API

  • Abbiamo aggiunto il supporto per i tipi androidx.wear.protolayout a TileRenderer (I4ac7f)
  • ObservableStateStore è stato rinominato in StateStore. (Ieb0e2)
  • Aggiungi overload per i tipi di protolayout a TileRenderer (I4ac7f)
  • Attivare le animazioni in TileRenderer (I07dcf)

Versione 1.2.0-alpha02

22 marzo 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha02 è stato rilasciato. La versione 1.2.0-alpha02 contiene questi commit.

Modifiche alle API

  • La raccolta di materiali Tiles è stata ritirata. Utilizza la nuova libreria ProtoLayout Material con le stesse funzionalità. (If242b)

Correzioni di bug

  • TileRenderer è stato aggiornato per utilizzare le nuove funzionalità della libreria Protolayout. (I832f9)

Versione 1.2.0-alpha01

8 marzo 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha01 è stato rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Abbiamo aggiunto onTileResourceRequest a TileService per fornire risorse dalla raccolta protolayout. (983d9c5)
  • Abbiamo aggiornato ResourcesRequest e TileRequest per supportare i tipi State e DeviceParameters della libreria protolayout. (88fa01d)
  • Abbiamo aggiornato TileBuilders.Tile per supportare i tipi State e Timeline della libreria protolayout. (168619c)

Correzioni di bug

  • Miglioramenti alla documentazione Javadoc. (I3ed73)
  • I colori predefiniti per onPrimary e la superficie sono stati modificati. (I0b039)

Versione 1.1

Versione 1.1.0

24 agosto 2022

androidx.wear.tiles:tiles-*:1.1.0 è stato rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

  • Questa è la prima release stabile che contiene la libreria Material Tiles (scopri di più sul nostro blog).
  • Questa libreria contiene componenti e layout in linea con le linee guida di Material e facili da usare. I componenti inclusi sono Button, Chip, CompactChip, TitleChip, CircularProgressIndicator, Text.Tutti questi componenti hanno un proprio oggetto colori che può essere creato con la classe principale Colors per applicare facilmente lo stesso tema a tutti i componenti. Oltre ai colori, esiste una classe Typography per ottenere facilmente oggetti FontStyle utilizzando il nome della tipografia.
  • Oltre ai componenti, sono disponibili layout dei riquadri consigliati: PrimaryLayout, EdgeContentLayout, MultiButtonLayout, MultiSlotLayout. Tutti i layout hanno stili e spaziatura interna consigliati applicati che rientrano nelle linee guida di Material.
  • Per un elenco dei componenti e dei layout nella libreria Material di Piastrelle, consulta le note di rilascio per Piastrelle.

Versione 1.1.0-rc01

10 agosto 2022

androidx.wear.tiles:tiles-*:1.1.0-rc01 è stato rilasciato. La versione 1.1.0-rc01 contiene questi commit.

  • Non sono state apportate nuove modifiche tra la release beta e la release candidata.

Versione 1.1.0-beta01

27 luglio 2022

androidx.wear.tiles:tiles-*:1.1.0-beta01 è stato rilasciato. La versione 1.1.0-beta01 contiene questi commit.

La release 1.0.0-beta01 della libreria Tiles Material contiene componenti e layout in linea con le linee guida di Material e facili da creare.

I componenti inclusi sono:

  • Button - oggetto cliccabile a forma circolare, con icona, testo o immagine di tre dimensioni predefinite.
  • Chip: oggetto cliccabile a forma di stadio che può contenere un'icona, etichette primaria e secondaria e ha un'altezza fissa e una larghezza personalizzabile.
  • CompactChip e TitleChip: due varianti del chip standard con altezze rispettivamente più piccole e più grandi e che possono contenere una riga di testo.
  • CircularProgressIndicator: arco colorato intorno al bordo dello schermo con gli angoli di inizio e fine indicati, che può descrivere un cerchio completo o parziale con l'arco di avanzamento completo dietro.
  • Text: testo formattato che utilizza gli stili tipografici Material Wear consigliati

Tutti questi componenti hanno il proprio oggetto colori che può essere creato con la classe Colors principale per applicare facilmente lo stesso tema a tutti i componenti. Oltre ai colori, esiste una classe Typography per ottenere facilmente oggetti FontStyle utilizzando il nome della tipografia.

Oltre ai componenti, esistono layout di riquadri consigliati:

  • PrimaryLayout: un layout personalizzabile aggiungendo etichette principali o secondarie, contenuti al centro e un chip principale in basso. I contenuti principali all'interno di questo layout possono essere aggiunti come oggetto MultiSlotLayout o MultiButtonLayout.
  • EdgeContentLayout: un layout per ospitare CircularProgressIndicator intorno al bordo con i contenuti principali all'interno e l'etichetta principale o secondaria intorno.
  • MultiButtonLayout: un layout che può contenere da 1 a 7 pulsanti, disposti in linea con le linee guida di Material a seconda del loro numero.
  • MultiSlotLayout: un layout in stile riga con slot allineati e spaziati orizzontalmente (per icone o altri piccoli contenuti).

Tutti i layout hanno stili e spaziatura interna consigliati applicati che rientrano nelle linee guida di Material.

Modifiche alle API

  • È stato eseguito un refactoring importante dei componenti Chip, che include la separazione dei setter in Builder in modo che ogni parte del contenuto venga passata separatamente con la ridenominazione in base alle linee guida (etichetta principale, etichetta secondaria, ID risorsa immagine). Inoltre, la descrizione dei contenuti verrà generata automaticamente se non è impostata. (I57622)
  • ProgressIndicatorLayout è stato rinominato in EdgeContentLayout. (Ic1aa6)
  • I contenuti delle dimensioni dei pulsanti sono stati rinominati in nomi con suffisso without _BUTTON e sono state aggiunte ulteriori chiarimenti Javadoc in Button. (I1dfe2)

Correzioni di bug

  • I margini, la spaziatura interna e la disposizione generale nei layout Material sono stati aggiornati per adattarsi a tutti i tipi di layout, dimensioni e forme dello schermo consigliati.
  • Miglioramenti ai layout Material. Gli slot MultiSlotLayout ora hanno una larghezza flessibile, quindi il contenuto viene adattato anziché avere una dimensione fissa.(I52919),(If18b4)
  • L'area su cui è possibile toccare CompactChip è stata aumentata per rispettare le linee guida per l'accessibilità. (Ie8264)

Versione 1.1.0-alpha09

29 giugno 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha09 è stato rilasciato. La versione 1.1.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Abbiamo aggiunto il supporto per l'aggiunta di etichette facoltative in ProgressIndicatorLayout. (I30788)

Modifiche alle API

  • I metodi helper per ElementMetadata ora accettano ElementMetadata anziché Modificatori. (I5a70f)

Correzioni di bug

  • La limitazione di 9 caratteri su CompactChip è stata rimossa. Se il testo è troppo grande per essere visualizzato sullo schermo in PrimaryLayout, verrà troncato. (Id56ec)
  • I getter in Chip ora hanno il suffisso Content. (Iba437)
  • Chiarimento della documentazione Javadoc nelle classi Tiles Material. (I56e41), (I80f31), (Iba437)

Versione 1.1.0-alpha08

1° giugno 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha08 è stato rilasciato. La versione 1.1.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Il tag di metadati è stato aggiunto a Modifiers per essere utilizzato per monitorare i metadati del componente con metodi helper aggiunti alla classe Helper. (I70db2),(I30c3d)
  • Il metodo statico fromLayoutElement è stato aggiunto a tutti i componenti e i layout all'interno di Tiles Material. Deve essere utilizzato per i test, per eseguire il cast di un LayoutElement ottenuto dall'accesso ai contenuti di un contenitore al suo tipo originale. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

Versione 1.1.0-alpha07

18 maggio 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha07 è stato rilasciato. La versione 1.1.0-alpha07 contiene questi commit.

Modifiche alle API

  • I getter correlati a setter diversi per i contenuti sono stati aggiunti a ProgressIndicatorLayout e PrimaryLayout. Ora tutti i setter di queste classi hanno getter corrispondenti.(Iddbe5) (Iabe4e)
  • Il getter per la descrizione dei contenuti nei componenti Material può restituire un valore null poiché il setter non è obbligatorio.
  • Il tentativo di creare un pulsante senza contenuti restituisce IllegalArgumentException. (I7fc0c)
  • I campi correlati al colore dell'icona in ChipColors sono stati rinominati da iconTintColor a iconColor. (Ic053b)

Correzioni di bug

  • Aggiunta di androidTests per i layout in Tiles Material. (I96404)

Versione 1.1.0-alpha06

11 maggio 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha06 è stato rilasciato. La versione 1.1.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Il nuovo layout è stato aggiunto alla sottoraccolta Layout Material - MultiButtonLayout. Rappresenta un layout che può contenere da 1 a 7 pulsanti disposti in linea con le linee guida di Material. Nella maggior parte dei casi, questo layout deve essere passato come contenuto a PrimaryLayout. (Ib727f)

Modifiche alle API

  • MultiSlotLayout è stato refattorizzato in modo da contenere solo slot. Questo layout deve essere passato come contenuto al PrimaryLayout principale. (I1870f)
  • I colori predefiniti definiti per CircularProgressIndicator sono stati aggiornati in modo da essere un unico valore anziché primario e secondario. (I64a51)
  • Aggiunto getter per lo spaziatore orizzontale in MultiSlotLayout. (I11e1e)

Correzioni di bug

  • Sono stati aggiunti test Android per i componenti a Material Tiles. (I20041)

Versione 1.1.0-alpha05

6 aprile 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha05 è stato rilasciato. La versione 1.1.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti metodi helper per convertire LayoutElement in Layout, Timeline e TimelineEntry in queste classi per semplificare la creazione di riquadri. (I2f6d1)
  • L'oggetto Colors è stato aggiunto alla libreria Material per essere passato nei colori dei componenti come tema. (I0792c)

Modifiche alle API

  • Il componente Material Text richiede il testo passato nel costruttore. Ora questo componente può essere personalizzato impostando il peso. (I25dbd)
  • Sono state rimosse le costanti da ChipDefaults che non vengono utilizzate nei setter pubblici. (I7baed)
  • Sono stati rimossi i getter da CompactChip e TitleChip che non hanno setter corrispondenti. (I99e85)
  • DEFAULT_PADDING rimosso da ProgressIndicatorDefaults. (Idabcd)
  • I componenti Material ora accettano CharSequence per la descrizione dei contenuti anziché String. (I5b21a)

Correzioni di bug

  • Implementazione dei setter refattorizzati dei parametri facoltativi in Button. (Ib7135)
  • È stata aggiunta una variante di stile del carattere ai caratteri in Tipografia. (I8dbc6)

Versione 1.1.0-alpha04

23 marzo 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha04 è stato rilasciato. La versione 1.1.0-alpha04 contiene questi commit.

Nuove funzionalità

  • A PrimaryLayout è possibile aggiungere un'etichetta principale o secondaria facoltativa. (Ib9916)
  • Il componente di testo può essere personalizzato impostando overflow, corsivo, sottolineatura e così via. (I703f7)

Modifiche alle API

  • Le costanti di colore predefinite sono state rimosse dall'API Tiles Material. (I0ab55)
  • Tutti i componenti selezionabili in Tiles Material richiedono l'oggetto Clickable nel costruttore di Builder anziché un'azione. (I2f101)

Correzioni di bug

  • Ora il testo disegnerà i puntini di sospensione in caso di overflow nei componenti Chip e Testo. (I8a2f8)
  • Miglioramento dell'aspetto dei componenti quando la scala del carattere dell'utente è impostata su Grande. (Ib63b1)
  • Chiarisci i Javadoc di setPrimaryChipContent in PrimaryLayout. (Ie6296)

Versione 1.1.0-alpha03

23 febbraio 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha03 è stato rilasciato. La versione 1.1.0-alpha03 contiene questi commit.

Modifiche alle API

  • Il componente Text con gli stili tipografici consigliati è stato aggiunto a Material Tiles. (Iec0ae)

Versione 1.1.0-alpha02

9 febbraio 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha02 è stato rilasciato. La versione 1.1.0-alpha02 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta una nuova sottoraccolta layouts in Materiale delle tessere. Contiene layout di riquadri basati su opinioni con spaziatura interna e margini consigliati applicati per rendere lo sviluppo dei riquadri più rapido e l'implementazione più semplice. I layout iniziali sono:
    • PrimaryLayout (I7ba91) che rappresenta il layout con un chip principale in basso e i contenuti al centro.
    • MultiSlotLayout (I32104) che rappresenta un layout con etichette nelle righe 1 e 3, slot allineati e distanziati orizzontalmente nella riga 2 e il tutto seguito da una quarta riga che contiene un chip principale.
    • ProgressIndicatorLayout (I9fec6) che rappresenta un layout con l'indicatore di avanzamento circolare intorno al bordo dello schermo e i contenuti specificati all'interno.
  • CircularProgressIndicator (Ic4b88) è stato aggiunto ai componenti Material delle tessere.

Modifiche alle API

  • Sono state rinominate le costanti rimanenti utilizzate da TitleChip in modo da includere il titolo nel nome. (I14f4c)
  • Il metodo setHorizontalAlignment è stato aggiunto a Chip. (Ie6e0b)

Versione 1.1.0-alpha01

26 gennaio 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha01 è stato rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto il nuovo materiale delle tessere della raccolta. Contiene componenti per creare layout dei riquadri più rapidamente e facilmente con Material Design. I componenti iniziali sono:
    • Button
    • Chip
    • CompactChip
    • TitleChip

Correzioni di bug

  • È stato corretto un bug in TileUiClient che causava l'eliminazione delle risorse memorizzate nella cache. (I60e0b)

Versione 1.0

Versione 1.0.1

26 gennaio 2022

androidx.wear.tiles:tiles-*:1.0.1 è stato rilasciato. La versione 1.0.1 contiene questi commit.

Correzioni di bug

  • È stato corretto un bug in TileUiClient che causava l'eliminazione delle risorse memorizzate nella cache. (I60e0b)

Versione 1.0.0

3 novembre 2021

androidx.wear.tiles:tiles-*:1.0.0 è stato rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

  • La libreria Wear Tiles fornisce funzionalità per creare riquadri personalizzati per i dispositivi Wear OS, insieme alle classi che consentono al sistema di recuperare il riquadro e visualizzarlo accanto al quadrante.
  • tiles-renderer ti consente di mostrare un riquadro come parte di un'attività Android, facilitando il test rapido dei layout dei riquadri.

Versione 1.0.0-rc01

27 ottobre 2021

androidx.wear.tiles:tiles-*:1.0.0-rc01 è stato rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Versione 1.0.0-beta01

13 ottobre 2021

androidx.wear.tiles:tiles-*:1.0.0-beta01 è stato rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Correzioni di bug

  • È stato corretto NullPointerException in TileUiClient quando è stata fornita una versione della risorsa vuota. (I0586e)

Versione 1.0.0-alpha12

29 settembre 2021

androidx.wear.tiles:tiles-*:1.0.0-alpha12 è stato rilasciato. La versione 1.0.0-alpha12 contiene questi commit.

Correzioni di bug

  • UpdateScheduler non utilizza più un riferimento debole, risolvendo i problemi per cui TileUiClient non veniva aggiornato(I1120d, b/199061124)

  • Dichiara che SysUiTileUpdateRequester esegue query su PackageManager, correggendo un bug per cui gli aggiornamenti dei riquadri non funzionavano sui dispositivi R+. (I1120d)

Versione 1.0.0-alpha11

1° settembre 2021

androidx.wear.tiles:tiles-*:1.0.0-alpha11 è stato rilasciato. La versione 1.0.0-alpha11 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta e rilasciata una libreria di test, androidx.wear.tiles:tiles-testing, per consentire agli sviluppatori di testare più facilmente i propri riquadri. (Iedb6b)

Modifiche alle API

  • È stato rinominato TileProviderService in TileService. (I1ad2c)
  • Generatori di riquadri aggiornati; i metodi statici .builder() sono stati deprecati a favore della chiamata di new Foo.Builder() e gli overload del setter che accettavano un'istanza Builder sono stati rimossi. (Ia9606)
  • TileRenderer ora dovrebbe utilizzare un contesto UI anziché il contesto dell'applicazione. (I84b61)

Correzioni di bug

  • È stato corretto un bug che causava l'applicazione di più sottolineature in determinate situazioni. (Ib6712)

Versione 1.0.0-alpha10

18 agosto 2021

androidx.wear.tiles:tiles:1.0.0-alpha10, androidx.wear.tiles:tiles-proto:1.0.0-alpha10 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 sono stati rilasciati. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche alle API

  • Sono stati rimossi i controlli del layout dall'API pubblica. Questi controlli saranno sempre attivati, anche se verrà visualizzato un avviso solo se un controllo non va a buon fine. (Ie9f29)
  • TileRenderer ora accetta un contesto UI anziché il contesto dell'applicazione.

Correzioni di bug

  • È stato corretto un bug che impediva di fare clic sugli elementi cliccabili in uno Spannable.

Versione 1.0.0-alpha09

21 luglio 2021

androidx.wear.tiles:tiles:1.0.0-alpha09, androidx.wear.tiles:tiles-proto:1.0.0-alpha09 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 sono stati rilasciati. La versione 1.0.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Aggiunti controlli del layout al renderer dei riquadri di Wear. (I3a869)
    • Vengono utilizzati per convalidare le best practice nel riquadro. Per iniziare, questi genereranno un avviso se il riquadro non contiene elementi con un modificatore Semantics.
  • È stata aggiunta la documentazione per DefaultTileProviderClient e TestingTileProviderClient constructors. (I9f4b9)

Modifiche alle API

  • Ridenominazione in TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Aggiunti controlli del layout al renderer dei riquadri di Wear. (I3a869)

Correzioni di bug

  • Assicurati che una destinazione LaunchAction non disponga di autorizzazioni speciali. (I39136)

Versione 1.0.0-alpha08

30 giugno 2021

androidx.wear.tiles:tiles:1.0.0-alpha08, androidx.wear.tiles:tiles-proto:1.0.0-alpha08 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 sono stati rilasciati. La versione 1.0.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Gli spannable ora supportano line_height anziché line_spacing.

Modifiche alle API

  • Aggiungi il supporto per line_height in Spannables, rimuovi line_spacing. (Ibeb54)
    • Il codice che utilizza line_spacing deve essere convertito per utilizzare line_height.

Correzioni di bug

  • È stato corretto un bug durante l'utilizzo di dimensioni proporzionali. (I37ace)
  • Correzione del bug che impedisce agli elementi di testo di avere descrizioni dei contenuti. (Id2c7d)

Versione 1.0.0-alpha07

16 giugno 2021

androidx.wear.tiles:tiles:1.0.0-alpha07, androidx.wear.tiles:tiles-proto:1.0.0-alpha07 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 sono stati rilasciati. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche alle API

  • Aggiungi l'interfaccia TileProviderClient ed esponi DefaultTileProviderClient, consentendo alle implementazioni di eseguire il binding a un'interfaccia TileProviderService. (I69165)

Versione 1.0.0-alpha06

2 giugno 2021

androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 sono stati rilasciati. La versione 1.0.0-alpha06 contiene questi commit.

Modifiche alle API

  • Tutte le classi Builder ora contengono getter per tutte le proprietà. Tieni presente che questi sono destinati solo a scopi di test (I9d155)
  • Modifica del pacchetto: i corsi in androidx.wear.tiles.builders sono stati spostati in androidx.wear.tiles.
  • Aggiungere il supporto della tinta sperimentale ai riquadri. (I38929)
  • LayoutElementBuilders.HALIGN_* rinominato in LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • LayoutElementBuilders.VALIGN_* rinominato in LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • LayoutElementBuilders.SPAN_VALIGN_* rinominato in LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58)
  • Sono state aggiunte classi di builder per richieste ed eventi. (Ib5cf4)
  • È stata eseguita la migrazione di TileProviderService per utilizzare le classi di richieste ed eventi di RequestBuilders e EventBuilders, anziché RequestReaders/EventReaders (ad es. onTileRequest ora fornisce un RequestBuilders.TileRequest, anziché RequestReaders.TileRequest). (I46ea1)

Correzioni di bug

  • Correzione del bug nel caricamento asincrono delle immagini per il renderer dei riquadri. (Iad9b0)
  • Bug del layout fisso quando si inserisce un'immagine con larghezza o altezza impostata su expand() in un Box con larghezza o altezza impostata su wrap(). (I33770)

Versione 1.0.0-alpha05

18 maggio 2021

androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 sono stati rilasciati. La versione 1.0.0-alpha05 contiene questi commit.

Modifiche alle API

  • Rimozione di getTileId dagli eventi delle tessere in entrata (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest). (Ifbba2)
  • ImageResource#setAndroidResourceByResid rinominato in setAndroidResourceByResId (I4ba6e)
  • È stato rinominato TimelineManager#deInit in chiudi ed è stato implementato AutoCloseable. (I5dff2)

Versione 1.0.0-alpha04

5 maggio 2021

androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 sono stati rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Modifiche alle API

  • Classi TileProviderService concrete nascoste.
    • TileUpdateRequester ora accetta un Class<? extends TileProviderService>. (Ib7cca)
  • È stata aggiunta la possibilità di aggiungere extra ad AndroidActivity. (I748f4)

Schede versione 1.0.0-alpha03

21 aprile 2021

androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 sono stati rilasciati. La versione 1.0.0-alpha03 contiene questi commit.

Modifiche alle API

  • Rinomina TileManager -> TileClient
    • Rinomina TileManager#create -> TileClient#connect (I91839)

Correzioni di bug

  • Sono state aggiunte regole Proguard per garantire il corretto funzionamento di tiles e tiles-renderer con Proguard abilitato (Ie3d85)

Versione 1.0.0-alpha02

7 aprile 2021

androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 sono stati rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

  • androidx.wear:wear-tiles ha spostato i gruppi e ora deve essere chiamato androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer ha spostato i gruppi e ora deve essere chiamato androidx.wear.tiles:tiles-renderer
  • TileRenderer.LoadActionListener ora utilizza un'istanza di androidx.wear.tiles.builders.StateBuilders.State anziché androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer ora accetta risorse Tile da androidx.wear.tiles.builders.ResourceBuilders.Resources anziché un'istanza di androidx.wear.tiles.renderer.ResourceAccessors.

Correzioni di bug

  • È stata corretta l'impossibilità di utilizzare LoadActionListener, in quanto esponeva una classe interna.

Versione 1.0.0-alpha01

10 marzo 2021

androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01 e androidx.wear:wear-tiles-renderer:1.0.0-alpha01 sono stati rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria Wear Tiles Renderer fornisce funzionalità per creare riquadri personalizzati per i dispositivi Wear OS, insieme alle classi che consentono al sistema di recuperare il riquadro e visualizzarlo accanto al quadrante.