Compose per Wear OS è simile a Compose per i dispositivi mobili. Tuttavia, ci sono alcune differenze fondamentali. Questa guida ti illustrerà somiglianze e differenze.
Compose per Wear OS fa parte di Android Jetpack e, come le altre librerie Wear Jetpack che utilizzi, ti aiuta a scrivere codice migliore più velocemente. Questo è l'approccio consigliato per creare interfacce utente per le app Wear OS.
Se non hai dimestichezza con l'utilizzo del toolkit di Jetpack Compose, consulta il percorso di Compose. Molti dei principi di sviluppo di Compose per dispositivi mobili si applicano anche a Compose per Wear OS. Consulta Why Compose per saperne di più sui vantaggi generali di un framework di UI dichiarativo. Per scoprire di più su Compose per Wear OS, consulta il percorso Compose per Wear OS e il repository esempi di Wear OS su GitHub.
Compatibilità
Compose per Wear OS funziona su orologi che supportano Wear OS 3.0 (livello API 30) e smartwatch che utilizzano Wear OS 2.0 (livello API 25 e versioni successive). L'utilizzo della versione 1.0 di Compose per Wear OS richiede l'utilizzo della versione 1.2 delle librerie androidx.compose e di Kotlin 1.7.0.
Piattaforme
Compose per Wear OS semplifica la creazione di app su Wear OS. Per ulteriori informazioni, vedi App. Usa i nostri componenti integrati per creare esperienze utente conformi alle linee guida di Wear OS. Per ulteriori informazioni sui componenti, consulta le nostre linee guida sulla progettazione.
Configurazione…
L'utilizzo di Jetpack Compose con Wear OS è simile all'utilizzo di Jetpack Compose per
qualsiasi altro progetto Android. La differenza principale è che Jetpack Compose per Wear
aggiunge librerie specifiche per Wear che semplificano la creazione di interfacce utente
su misura per gli orologi. In alcuni casi, questi componenti condividono lo stesso nome delle controparti non indossabili, ad esempio androidx.wear.compose.material.Button
e androidx.compose.material.Button
.
Creare una nuova app in Android Studio
Per creare un nuovo progetto che includa Jetpack Compose, procedi come segue:
- Se ti trovi nella finestra Ti diamo il benvenuto in Android Studio, fai clic su Avvia un nuovo progetto Android Studio. Se hai già aperto un progetto Android Studio, seleziona File > Nuovo > Importa esempio dalla barra dei menu.
- Cerca Scrivi per Wear OS e seleziona Scrivi per Wear OS Starter.
- Nella finestra Configura il tuo progetto, segui questi passaggi:
- Imposta il Nome applicazione.
- Scegli la Località del progetto per l'esempio.
- Fai clic su Fine.
- Verifica che il file
build.gradle
del progetto sia configurato correttamente, come descritto in File delle proprietà Gradle.
Ora puoi iniziare a sviluppare un'app utilizzando Compose per Wear OS.
Dipendenze del toolkit Jetpack Compose
Per utilizzare Jetpack Compose con Wear OS, devi includere le dipendenze del toolkit di Jetpack Compose nel file build.gradle
dell'app, come mostrato nel
seguente snippet:
Kotlin
dependencies { // General compose dependencies implementation("androidx.activity:activity-compose:1.9.0") implementation("androidx.compose.ui:ui-tooling-preview:1.6.7") // Other compose dependencies // Compose for Wear OS Dependencies implementation("androidx.wear.compose:compose-material:1.3.1") // Foundation is additive, so you can use the mobile version in your Wear OS app. implementation("androidx.wear.compose:compose-foundation:1.3.1") // Wear OS preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.3.1") // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION). // Uncomment the line below and update the version number. // implementation("androidx.wear.compose:compose-navigation:1.3.1") // Testing testImplementation("junit:junit:4.13.2") androidTestImplementation("androidx.test.ext:junit:1.1.3") androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0") androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.0.3") debugImplementation("androidx.compose.ui:ui-tooling:1.0.3") }
Differenze
Se possibile, utilizza la versione WearComposeMaterial
delle API. Sebbene sia tecnicamente possibile utilizzare la versione mobile di Compose Material, non è ottimizzata per i requisiti specifici di Wear OS. Inoltre, la combinazione di Compose Material e Compose Material per Wear OS può comportare comportamenti imprevisti. Ad esempio, poiché ogni libreria ha la propria classe MaterialTheme
, esiste la possibilità che colori, tipografia o forme siano incoerenti se vengono utilizzate entrambe le versioni.
La seguente tabella illustra le differenze di dipendenze tra Wear OS e dispositivi mobili:
Dipendenza Wear OS
(androidx.wear.*) |
Confronto | Dipendenza da dispositivi mobili
(androidx.*) |
androidx.wear.compose:compose-materiale | invece di | androidx.compose.material:materiale |
androidx.wear.compose:compose-navigation | invece di | androidx.navigation:navigation-compose |
androidx.wear.compose:compose-foundation | oltre a | androidx.compose.foundation:foundation |
Ecco un esempio di file build.gradle
:
// Example project in app/build.gradle file
dependencies {
// Standard Compose dependencies...
// Wear specific Compose Dependencies
implementation "androidx.wear.compose:compose-material:$rootProject.wearVersion"
implementation "androidx.wear.compose:compose-foundation:$rootProject.wearVersion"
// For navigation within your app...
implementation "androidx.wear.compose:compose-navigation:$rootProject.wearVersion"
// Other dependencies...
}
Feedback
Prova Compose per Wear OS e utilizza l'Issue Tracker per fornire suggerimenti e feedback.
Entra nel canale#compose-wear su Kotlin Slack per entrare in contatto con la community di sviluppatori e farci conoscere la tua esperienza.
Consigliato per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Aggiungere una schermata iniziale
- Attività in corso
- Guida introduttiva alle schede