Riquadri Wear

Creare applicazioni per smartwatch Wear OS by Google.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
11 dicembre 2024 1.4.1 - - 1.5.0-alpha05

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da Wear, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

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

Groovy

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

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

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

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

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

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

Kotlin

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

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

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

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

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

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

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, 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.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Versione 1.5

Versione 1.5.0-alpha05

11 dicembre 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha05 viene 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 nullità JSpecify, che sono di tipo di utilizzo. Gli sviluppatori Kotlin devono utilizzare i seguenti argomenti del compilatore per applicare l'utilizzo corretto: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I390e9, b/326456246)
  • È stato corretto il bug per cui la richiesta di aggiornamenti dei riquadri nell'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 viene 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 viene 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 viene 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 il problema 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 viene 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 viene 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 il problema 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 viene rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

  • Supporto degli strumenti per la specifica di 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 viene 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 di funzionalità e che l'API è bloccata (tranne dove contrassegnata come sperimentale). Wear Tiles 1.4 include le seguenti nuove funzionalità e API:

  • Supporto degli strumenti per la specifica di 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 viene 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 viene 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 viene 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 viene rilasciato. La versione 1.4.0-alpha02 contiene questi commit.

Modifiche all'API

  • Sposta tileId nel parametro del costruttore del generatore come campo obbligatorio e documenta il valore predefinito del timestamp nel getter. (I98c2b)
  • Aggiungi i messaggi proto TileInteractionEvent, TileEnter e TileLeave e i wrapper Java necessari per raggruppare gli eventi di entrata/uscita dei riquadri. (I112b0)
  • Esegui il refactoring di TileRenderer in modo da utilizzare un generatore 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 deprecati. (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 per TileRenderer.Config.Builder#setTilesTheme è zero. (Iced18)

Versione 1.4.0-alpha01

6 marzo 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha01 viene 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 viene rilasciato. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

  • Strumenti aggiornati per il supporto dell'anteprima dei riquadri.
  • Supporto per la query delle schede attive appartenenti all'app.

Modifiche aggiuntive

Versione 1.3.0-rc01

24 gennaio 2024

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

Modifiche all'API

  • TileService#getActiveTilesSnapshotAsync rinominato in getActiveTilesAsync. (If6b87)

Versione 1.3.0-beta01

10 gennaio 2024

androidx.wear.tiles:tiles-*:1.3.0-beta01 viene 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 di funzionalità e che 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 Wear è aggiornato per il supporto dell'anteprima dei riquadri ed è impostato per la pubblicazione.
  • Supporto per la query sulle schede appartenenti all'app attive con TileService.getActiveTilesSnapshotAsync.

Versione 1.3.0-alpha04

13 dicembre 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha04 viene 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 viene rilasciato. La versione 1.3.0-alpha03 contiene questi commit.

Nuove funzionalità

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

Modifiche all'API

  • Rinomina @TilePreview in @Preview (Ifc08a)

Versione 1.3.0-alpha02

15 novembre 2023

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

Nuove funzionalità

  • Abbiamo aggiunto un'API sperimentale per ridimensionare automaticamente il 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 viene 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 Wear è aggiornato per il supporto dell'anteprima dei riquadri ed è impostato per la pubblicazione. (I63d0f)

Versione 1.2

Versione 1.2.0

9 agosto 2023

androidx.wear.tiles:tiles-*:1.2.0 viene 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ù)
  • Tiles 1.2 aggiunge il supporto per l'associazione di elementi di layout ai dati della piattaforma (per aggiornamenti più rapidi) e all'animazione. Per le istruzioni sulla migrazione, consulta le note di rilascio della versione (1.2.0-rc01)

Versione 1.2.0-rc01

26 luglio 2023

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

  • Con la release 1.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 rimane in Tiles (androidx.wear.tiles):

    • Tutti i nomi dei corsi sono rimasti invariati, sono state apportate solo aggiunte alla versione 1.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 di riquadri ritirati.
  • Per semplificare questa migrazione, abbiamo creato alcune istruzioni e uno script che eseguono questa ridenominazione. Visita questa pagina.

Modifiche all'API

  • Abbiamo limitato la profondità massima di un layout a 30 elementi nidificati nel riquadro. Se questa profondità viene superata, il visualizzatore delle riquadri mostrerà un layout gonfiato in precedenza. (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 viene 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 corrente e a qualsiasi layout futuro (fino a quando non verrà impostato un nuovo stato) (Iaaf35)
  • I tipi di protolayout sono ora completamente supportati in tutte le API di visualizzazione 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 viene rilasciato. La versione 1.2.0-alpha06 contiene questi commit.

Modifiche all'API

  • Rinomina StateEntryValue in DynamicDataValue e aggiorna le API di stato per utilizzare 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 IllegalStateException durante la creazione o l'aggiornamento del StateStore. (Ibadb3)

Versione 1.2.0-alpha05

10 maggio 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha05 viene 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 all'API

  • TileRenderer.inflateAsync ora restituisce un ListenableFuture. (I2f2b9)
  • I generatori di riquadri che hanno un'alternativa 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 viene rilasciato. La versione 1.2.0-alpha04 contiene questi commit.

Correzioni di bug

  • Le dipendenze di Gradle sono ora 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 viene rilasciato. La versione 1.2.0-alpha03 contiene questi commit.

Modifiche all'API

  • Abbiamo aggiunto il supporto dei tipi androidx.wear.protolayout a TileRenderer (I4ac7f)
  • ObservableStateStore è stato rinominato in StateStore. (Ieb0e2)
  • Aggiungere sovraccarichi 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 viene rilasciato. La versione 1.2.0-alpha02 contiene questi commit.

Modifiche all'API

  • La raccolta di materiali riquadri è 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 viene 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 ai 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 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

  • Questa è la prima release stabile che contiene la raccolta Material Tiles (scopri di più nel nostro blog).
  • Questa raccolta contiene componenti e layout conformi alle 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 Colori 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. A tutti i layout sono stati applicati spaziatura e stili consigliati che rispettano le linee guida di Material.
  • Per un elenco dei componenti e dei layout nella libreria di materiali di riquadri, consulta le note di rilascio di Riquadri.

Versione 1.1.0-rc01

10 agosto 2022

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

  • Non sono state apportate nuove modifiche tra la versione beta e la versione RC.

Versione 1.1.0-beta01

27 luglio 2022

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

La release 1.0.0-beta01 della libreria Material Tiles contiene componenti e layout conformi alle linee guida di Material e facili da creare.

I componenti inclusi sono:

  • Button: oggetto di forma circolare cliccabile, con icona, testo o immagine con tre dimensioni predefinite.
  • Chip: oggetto a forma di stadio cliccabile che può contenere un'icona, etichette principali e secondarie e ha altezza fissa e 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 attorno al bordo dello schermo con gli angoli di inizio e di fine specificati, che può descrivere un cerchio intero o parziale con l'arco di avanzamento completo alle spalle.
  • Text: testo stilizzato che utilizza gli stili di tipografia Wear Material consigliati

Tutti questi componenti hanno un proprio oggetto colors 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 i seguenti layout consigliati per i riquadri:

  • PrimaryLayout: un layout che può essere personalizzato 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 l'hosting di CircularProgressIndicator lungo il 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 Material, a seconda del numero.
  • MultiSlotLayout: un layout in stile riga con spazi e spaziature allineati orizzontalmente (per icone o altri contenuti di piccole dimensioni).

A tutti i layout sono stati applicati spaziatura e stili consigliati che rispettano le linee guida di Material.

Modifiche all'API

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

Correzioni di bug

  • I margini, la spaziatura interna e la disposizione generale in Material Layouts sono stati aggiornati per adattarsi a tutti i tipi di layout consigliati e alle dimensioni e alle forme degli schermi.
  • Miglioramenti ai layout di Material. In MultiSlotLayout le dimensioni degli slot sono ora flessibili e i contenuti vengono a capo anziché avere dimensioni fisse.(I52919),(If18b4)
  • L'area su cui è possibile toccare CompactChip è stata aumentata per rispettare le linee guida sull'accessibilità. (Ie8264)

Versione 1.1.0-alpha09

29 giugno 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha09 viene 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 all'API

  • I metodi di assistenza per ElementMetadata ora accettano ElementMetadata anziché Modifiers. (I5a70f)

Correzioni di bug

  • Il limite di 9 caratteri per CompactChip è stato rimosso. Se il testo è troppo grande per adattarsi allo schermo in PrimaryLayout, verrà visualizzato in forma ellittica. (Id56ec)
  • I getter in Chip ora hanno il suffisso Content. (Iba437)
  • Chiarimento del Javadoc per le classi Materiale riquadri. (I56e41), (I80f31), (Iba437)

Versione 1.1.0-alpha08

1° giugno 2022

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

Nuove funzionalità

  • Il tag dei metadati è stato aggiunto ai modificatori per essere utilizzato per monitorare i metadati del componente con i metodi di assistenza aggiunti alla classe Helper. (I70db2),(I30c3d)
  • Il metodo statico fromLayoutElement è stato aggiunto a tutti i componenti e i layout all'interno di Materiale riquadri. Deve essere utilizzato per i test, per eseguire il casting 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 viene rilasciato. La versione 1.1.0-alpha07 contiene questi commit.

Modifiche all'API

  • I getter relativi a diversi setter per i contenuti sono stati aggiunti a ProgressIndicatorLayout e PrimaryLayout. Ora tutti i setters di queste classi hanno getter corrispondenti.(Iddbe5) (Iabe4e)
  • Il getter per la descrizione dei contenuti in Material Components può restituire null poiché il relativo setter non è obbligatorio.
  • Il tentativo di creare un pulsante senza contenuti passati comporterà IllegalArgumentException. (I7fc0c)
  • I campi relativi al colore delle icone in ChipColors sono stati rinominati da iconTintColor a iconColor. (Ic053b)

Correzioni di bug

  • È stato aggiunto androidTests per i layout nel materiale Schede. (I96404)

Versione 1.1.0-alpha06

11 maggio 2022

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

Nuove funzionalità

  • Il nuovo layout è stato aggiunto alla sottolibreria Material Layouts (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 all'API

  • MultiSlotLayout è stato sottoposto a refactoring in modo da contenere solo slot. Questo layout deve essere passato come contenuto all'PrimaryLayout principale. (I1870f)
  • Aggiornamento dei colori predefiniti definiti per CircularProgressIndicator in modo che siano un valore anziché primario e secondario. (I64a51)
  • È stato aggiunto un getter per lo spazio orizzontale in MultiSlotLayout. (I11e1e)

Correzioni di bug

  • I test Android per i componenti sono stati aggiunti a Materiale riquadri. (I20041)

Versione 1.1.0-alpha05

6 aprile 2022

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

Nuove funzionalità

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

Modifiche all'API

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

Correzioni di bug

  • Implementazione di setter ristrutturati dei parametri facoltativi in Button. (Ib7135)
  • La variante dello stile del carattere è stata aggiunta ai caratteri in Tipografia. (I8dbc6)

Versione 1.1.0-alpha04

23 marzo 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha04 viene 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 il testo a capo, il corsivo, l'evidenziazione e così via (I703f7)

Modifiche all'API

  • Le costanti di colore predefinite sono state rimosse dall'API Materiale riquadri. (I0ab55)
  • Tutti i componenti selezionabili nel materiale richiedono l'oggetto Clickable nel costruttore del relativo builder anziché un'azione. (I2f101)

Correzioni di bug

  • Ora il testo viene visualizzato con tre puntini di sospensione in caso di overflow nel componente Chip e testo. (I8a2f8)
  • Aspetto dei componenti migliorato quando la scala dei caratteri dell'utente è impostata su grande. (Ib63b1)
  • Chiarisci le Javadoc di setPrimaryChipContent in PrimaryLayout. (Ie6296)

Versione 1.1.0-alpha03

23 febbraio 2022

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

Modifiche all'API

  • Il componente Text con gli stili di tipografia consigliati è stato aggiunto al materiale di Tiles. (Iec0ae)

Versione 1.1.0-alpha02

9 febbraio 2022

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

Nuove funzionalità

  • È stata aggiunta una nuova raccolta secondaria layouts nel materiale riquadri. Contiene layout di riquadri con spaziatura e margini consigliati applicati per velocizzare e semplificare lo sviluppo dei riquadri. 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, spaziature e allineamento orizzontale delle caselle nella riga 2, il tutto seguito da una quarta riga contenente un chip principale.
    • ProgressIndicatorLayout (I9fec6) che rappresenta un layout con l'indicatore di avanzamento circolare attorno al bordo dello schermo e i contenuti specificati all'interno.
  • CircularProgressIndicator (Ic4b88) è stato aggiunto ai componenti Material dei riquadri.

Modifiche all'API

  • Le costanti rimanenti utilizzate da TitleChip sono state rinominate 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 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta la nuova raccolta Materiale riquadri. Contiene componenti per creare layout di riquadri più velocemente 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 viene 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 viene rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

  • La libreria Wear Tiles fornisce la funzionalità per creare riquadri personalizzati per i dispositivi Wear OS, oltre alle classi che consentono al sistema di recuperare il riquadro e visualizzarlo accanto al quadrante.
  • tiles-renderer ti consente di mostrare un riquadro all'interno 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 viene 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 viene 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 viene rilasciato. La versione 1.0.0-alpha12 contiene questi commit.

Correzioni di bug

  • UpdateScheduler non utilizza più un riferimento debole, risolvendo i problemi relativi all'aggiornamento di TileUiClient(I1120d, b/199061124)

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

Versione 1.0.0-alpha11

1° settembre 2021

androidx.wear.tiles:tiles-*:1.0.0-alpha11 viene 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 all'API

  • Il servizio TileProviderService è stato rinominato in TileService. (I1ad2c)
  • Generatori di riquadri aggiornati; i metodi .builder() statici sono stati ritirati in favore della chiamata a new Foo.Builder() e gli oneri aggiuntivi dei setter che accettavano un'istanza di Builder sono stati rimossi. (Ia9606)
  • Ora TileRenderer 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 vengono rilasciati. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche all'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 un elemento espandibile.

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 vengono rilasciati. La versione 1.0.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti controlli del layout al renderer di Wear Tiles. (I3a869)
    • Vengono utilizzati per convalidare le best practice nel riquadro. Per iniziare, verrà visualizzato un avviso se il riquadro non contiene elementi con un modificatore Semantics.
  • È stata aggiunta la documentazione per DefaultTileProviderClient e TestingTileProviderClient constructors. (I9f4b9)

Modifiche all'API

  • Rinomina in TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Sono stati aggiunti controlli del layout al renderer di Wear Tiles. (I3a869)

Correzioni di bug

  • Assicurati che una destinazione LaunchAction non abbia 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 vengono rilasciati. La versione 1.0.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Gli elementi espandibili ora supportano line_height anziché line_spacing.

Modifiche all'API

  • Aggiunta del supporto per line_height in Spannables, rimozione di line_spacing. (Ibeb54)
    • Il codice che utilizza line_spacing deve essere portato a utilizzare line_height.

Correzioni di bug

  • È stato corretto un bug relativo all'utilizzo delle dimensioni proporzionali. (I37ace)
  • Correzione di un bug che impediva 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 vengono rilasciati. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche all'API

  • Aggiungi l'interfaccia TileProviderClient ed esponi DefaultTileProviderClient, consentendo alle implementazioni di associarsi 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 vengono rilasciati. La versione 1.0.0-alpha06 contiene questi commit.

Modifiche all'API

  • Tutte le classi Builder ora contengono getter per tutte le proprietà. Tieni presente che sono destinati esclusivamente a scopo di test (I9d155)
  • Modifica del pacchetto: i corsi in androidx.wear.tiles.builders sono stati spostati in androidx.wear.tiles.
  • Aggiunta del supporto sperimentale della tinta a 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 generatori per richieste ed eventi. (Ib5cf4)
  • È stata eseguita la migrazione di TileProviderService per utilizzare le classi di richiesta ed evento di RequestBuilders e EventBuilders anziché RequestReaders/EventReaders (ad es. ora onTileRequest fornisce un RequestBuilders.TileRequest anziché un RequestReaders.TileRequest). (I46ea1)

Correzioni di bug

  • Correzione di un bug nel caricamento asincrono delle immagini per il visualizzatore di riquadri. (Iad9b0)
  • È stato corretto un bug del layout 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 vengono rilasciati. La versione 1.0.0-alpha05 contiene questi commit.

Modifiche all'API

  • È stato rimosso getTileId dagli eventi delle schede in arrivo (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest). (Ifbba2)
  • ImageResource#setAndroidResourceByResid rinominato in setAndroidResourceByResId (I4ba6e)
  • È stata rinominata TimelineManager#deInit in close ed è stata implementata 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 vengono rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Modifiche all'API

  • Classi TileProviderService concrete nascoste.
    • Ho fatto in modo che TileUpdateRequester riceva 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 vengono rilasciati. La versione 1.0.0-alpha03 contiene questi commit.

Modifiche all'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 vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche all'API

  • androidx.wear:wear-tiles ha spostato i gruppi e ora deve essere indicato come androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer ha spostato i gruppi e ora deve essere indicato come 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 riquadro 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 vengono 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, oltre alle classi che consentono al sistema di recuperare il riquadro e visualizzarlo accanto al quadrante.