Compose per TV è l'approccio moderno per creare interfacce utente di Android TV. Compose per TV sblocca tutti i vantaggi di Jetpack Compose di Android per le tue app per TV, semplificando notevolmente la creazione di UI belle e funzionali per la tua app.
Ecco alcuni vantaggi specifici dell'utilizzo di Compose per la TV:
- Flessibilità: Compose può essere utilizzato per creare qualsiasi tipo di interfaccia utente, da layout semplici ad animazioni complesse. I componenti funzionano subito, ma possono anche essere personalizzati e impostati in base alle esigenze della tua app.
- Sviluppo semplificato e accelerato: Compose è compatibile con il codice esistente e consente agli sviluppatori di creare app in modo più efficiente con meno codice.
- Intuitivo: Compose utilizza una sintassi dichiarativa che ti consente di apportare modifiche all'interfaccia utente, eseguire il debug, comprendere e rivedere il codice.
Se non hai dimestichezza con l'utilizzo del toolkit di Jetpack Compose, consulta il percorso di Compose. Molti dei principi di sviluppo per Compose per dispositivi mobili si applicano anche alla TV. Per ulteriori informazioni sui vantaggi generali di un framework di UI dichiarativo, consulta Perché scrivere. Per scoprire di più, consulta anche il repository di esempi di Compose per TV su GitHub.
Compatibilità
Compose for TV funziona su Android TV con Android 5.0 (livello API 21) o versioni successive. L'utilizzo della versione 1.0 di Compose per TV richiede la versione 1.3.0 delle librerie androidx.compose e Kotlin 1.7.10.
Configura
L'utilizzo di Jetpack Compose su Android TV è simile a quello di qualsiasi altro progetto Android. La differenza principale è che Compose per TV aggiunge librerie che offrono componenti ottimizzati per la TV e semplificano la creazione di interfacce utente personalizzate per la TV. In alcuni casi, questi componenti condividono lo stesso nome delle controparti non TV, ad esempio androidx.tv.material3.Button e androidx.compose.material3.Button.
Dipendenze del toolkit Jetpack Compose
Per utilizzare Compose per TV, includi le dipendenze del toolkit Jetpack Compose nel file build.gradle dell'app come segue:
Kotlin
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.10.01") implementation(composeBom) // General compose dependencies. implementation("androidx.activity:activity-compose:1.9.2") implementation("androidx.compose.ui:ui-tooling-preview") debugImplementation("androidx.compose.ui:ui-tooling") // Compose for TV dependencies. implementation("androidx.tv:tv-material:1.0.0") }
Alla moda
dependencies { def composeBom = platform('androidx.compose:compose-bom:2024.10.01') implementation composeBom // General compose dependencies. implementation 'androidx.activity:activity-compose:1.9.2' implementation 'androidx.compose.ui:ui-tooling-preview' debugImplementation 'androidx.compose.ui:ui-tooling' // Compose for TV dependencies. implementation 'androidx.tv:tv-material:1.0.0' }
Differenze
I componenti del materiale della TV sono progettati per il salotto, con indicatori di messa a fuoco chiari e comportamento di input adatto al telecomando. Per informazioni dettagliate su come utilizzare questi componenti specifici, consulta le guide di progettazione dell'interfaccia utente della TV.
Se possibile, utilizza la versione TV delle API per trarre vantaggio da queste funzionalità.
Sebbene sia tecnicamente possibile utilizzare la versione mobile di Compose Material,
non è ottimizzata per lo stile unico delle interazioni su Android TV. Inoltre, la combinazione di Compose Material con Compose Material di Compose per TV può comportare un comportamento imprevisto. Ad esempio,
poiché ogni libreria ha il proprio oggetto MaterialTheme, se vengono utilizzate entrambe le versioni, esiste la possibilità che
colori, forme o elementi tipografici non siano coerenti.
La seguente tabella illustra le differenze di dipendenza tra TV e dispositivo mobile:
| Dipendenza TV (androidx.tv.*) |
Confronto | Dipendenza mobile (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | anziché | androidx.compose.material3:material3 |
Risorse aggiuntive
Linee guida per la progettazione di TV
Una panoramica dei componenti TV dedicati per la creazione di interfacce utente con link alle risorse per gli sviluppatori pertinenti.Esempio di TV Material Catalog
Un'app di catalogo che dimostra come implementare i principi di Material Design utilizzando Compose per la TV.Esempio di JetStream
Un'app di streaming multimediale che dimostra l'utilizzo di TV Compose con un'app Materiale tipica e un'architettura reale.Introduzione a Compose per TV
Questo codelab illustra la procedura per creare un'app di riproduzione video con una schermata di browser del catalogo e una schermata dei dettagli.
Continua a leggere
Esplora queste guide per scoprire come creare esperienze ottimizzate per la TV in modo da: