Utilizzare Jetpack Compose su Wear OS

Compose for Wear OS è simile a Compose per dispositivi mobili. Tuttavia, ci sono alcune differenze fondamentali. Questa guida illustra le similitudini e le differenze.

Compose for Wear OS fa parte di Android Jetpack e, come le altre librerie Wear Jetpack che utilizzi, ti aiuta a scrivere un codice migliore più velocemente. Questo è l'approccio consigliato per la creazione di interfacce utente per le app Wear OS.

Se non hai familiarità con l'utilizzo del toolkit Jetpack Compose, consulta il percorso di apprendimento di Compose. Molti dei principi di sviluppo di Compose per dispositivi mobili si applicano a Compose per Wear OS. Per ulteriori informazioni sui vantaggi generali di un framework UI dichiarativo, consulta Perché Compose. Per scoprire di più su Compose per Wear OS, consulta il percorso di apprendimento di Compose per Wear OS e il repository di esempi di Wear OS su GitHub.

Material Design in Jetpack Compose su Wear OS

Jetpack Compose su Wear OS offre un'implementazione di Material 3, che ti aiuta a progettare app più coinvolgenti esperienze. I componenti Material Design su Wear OS sono basati su Wear Material Theming. Questo tema è un modo sistematico per personalizzare Material Design e riflettere meglio il brand del tuo prodotto.

Compatibilità

Piattaforme

Compose for Wear OS semplifica la creazione di app su Wear OS. Per ulteriori informazioni, vedi App. Utilizza i nostri componenti integrati per creare esperienze utente conformi alle linee guida di Wear OS. Per saperne di più sui componenti, consulta la nostra guida alla progettazione.

Impostazione

L'utilizzo di Jetpack Compose con Wear OS è simile a quello 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 personalizzate per gli smartwatch. In alcuni casi, questi componenti condividono lo stesso nome delle loro controparti non indossabili, ad esempio androidx.wear.compose.material3.Button e androidx.compose.material3.Button.

Crea una nuova app in Android Studio

Per creare un nuovo progetto che includa Jetpack Compose:

1. Se ti trovi nella finestra Welcome to Android Studio (Benvenuto in Android Studio), fai clic su Start a new Android Studio project (Avvia un nuovo progetto Android Studio). Se hai già aperto un progetto Android Studio, seleziona File > Nuovo > Importa esempio dalla barra dei menu.
2. Cerca Compose for Wear e seleziona Compose for Wear OS Starter.
3. Nella finestra Configura il progetto:
   1. Imposta il nome dell'applicazione.
   2. Scegli la posizione del progetto per il campione.
4. Fai clic su Fine.
5. Verifica che il file build.gradle del progetto sia configurato correttamente, come descritto in File delle proprietà di Gradle.

Ora puoi iniziare a sviluppare un'app utilizzando Compose for Wear OS.

Dipendenze del toolkit Jetpack Compose

Per utilizzare Jetpack Compose con Wear OS, devi includere le dipendenze del toolkit Jetpack Compose nel file build.gradle della tua app. La maggior parte delle modifiche alle dipendenze relative a Wear OS si trova nei livelli architettonici superiori, circondati da un riquadro rosso nell'immagine seguente.

<img 'foundation',="" 'material',="" 'runtime'.="" 'ui',="" 2="" 4="" a="" alt="" and="" are="" bottom,="" box""="" by="" contain="" from="" rectangles="" rectangles.="" red="" src="/static/wear/images/components/ComposeDependencies.png" surrounded="" the="" to="" top="" />

Ciò significa che molte delle dipendenze che utilizzi già con Jetpack Compose non cambiano quando scegli come target Wear OS. Ad esempio, le dipendenze di UI, runtime, compilatore e animazione rimangono invariate.

Tuttavia, Wear OS ha le proprie versioni delle librerie material e material3, foundation e navigation, quindi verifica di utilizzare le librerie corrette.

Se possibile, utilizza la versione WearComposeMaterial delle API. Sebbene sia tecnicamente possibile utilizzare la versione mobile di Compose Material, non è ottimizzata per i requisiti unici di Wear OS. Inoltre, la combinazione di Compose Material con Compose Material per Wear OS può causare un comportamento imprevisto. Ad esempio, poiché ogni libreria ha la propria classe MaterialTheme, è possibile che i colori, la tipografia o le forme non siano coerenti se vengono utilizzate entrambe le versioni.

La seguente tabella illustra le differenze di dipendenza tra Wear OS e Mobile:

Il seguente snippet mostra un file build.gradle di esempio che include queste dipendenze:

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2025.05.00")

    // General compose dependencies
    implementation(composeBom)
    implementation("androidx.activity:activity-compose:1.10.1")
    implementation("androidx.compose.ui:ui-tooling-preview:1.8.3")
    // Other compose dependencies

    // Compose for Wear OS dependencies
    implementation("androidx.wear.compose:compose-material3:1.5.0-beta05")

    // Foundation is additive, so you can use the mobile version in your Wear OS app.
    implementation("androidx.wear.compose:compose-foundation:1.5.0-beta05")

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta05")

    // 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.5.0-beta05")

    // 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.4.1")
    
}