O Compose para Wear OS é semelhante ao Compose para dispositivos móveis. No entanto, existem algumas diferenças importantes. Este guia explica as semelhanças e diferenças.
O Compose para Wear OS faz parte do Android Jetpack e, assim como as outras bibliotecas Wear Jetpack usadas, ele ajuda a programar códigos melhores com mais rapidez. O Compose é nossa abordagem recomendada para criar interfaces do usuário para apps Wear OS.
Se você não sabe usar o kit de ferramentas do Jetpack Compose, confira o Programa de treinamentos do Compose. Muitos dos princípios de desenvolvimento do Compose para dispositivos móveis se aplicam ao Compose para Wear OS. Consulte Por que usar o Compose para ter mais informações sobre as vantagens gerais de usar um framework de IU declarativa. Para saber mais sobre o Compose para Wear OS, consulte o Programa de treinamentos do Compose para Wear OS e o Repositório de exemplos do Wear OS (link em inglês) no GitHub.
Compatibilidade
O Compose para Wear OS funciona em smartwatches com suporte ao Wear OS 3.0 (nível 30 da API) e que usam o 2.0 (nível 25 da API e versões mais recentes). Para usar a versão 1.0 do Compose para Wear OS, é necessário utilizar a versão 1.2 das bibliotecas androidx.compose e o Kotlin 1.7.0.
Plataformas
Com o Compose para Wear OS, fica mais fácil criar apps no Wear OS. Para mais informações, consulte Apps. Os apps são perfeitos para executar interações complexas em um smartwatch.
Como configurar
O uso do Jetpack Compose com o Wear OS é semelhante ao uso do Jetpack Compose para
qualquer outro projeto Android. A principal diferença é que o Jetpack Compose para Wear
adiciona bibliotecas específicas do Wear que facilitam a criação de interfaces do usuário
personalizadas para smartwatches. Em alguns casos, esses componentes compartilham o mesmo nome que
os não relacionados ao Wear, como androidx.wear.compose.material.Button
e androidx.compose.material.Button
.
Criar um novo app no Android Studio
Para criar um novo projeto que inclua o Jetpack Compose, faça o seguinte:
- Se estiver na janela Welcome to Android Studio, clique em Start a new Android Studio project. Caso você já tenha um projeto aberto no Android Studio, selecione File > New > Import Sample na barra de menus.
- Pesquise Compose para Wear e selecione Compose for Wear OS Starter.
- Na janela Configure your project, faça o seguinte:
- Defina o Application name.
- Escolha a Project location para o exemplo.
- Clique em Finish.
- Verifique se o arquivo
build.gradle
do projeto está configurado corretamente, conforme descrito em Arquivos de propriedade do Gradle.
Agora está tudo pronto para você começar a desenvolver um app usando o Compose para Wear OS.
Dependências do kit de ferramentas do Jetpack Compose
Para usar o Jetpack Compose com o Wear OS, você precisa incluir dependências do kit de ferramentas
do Jetpack Compose no arquivo build.gradle
do app, conforme mostrado no
snippet abaixo:
Kotlin
dependencies { // General compose dependencies implementation("androidx.activity:activity-compose:1.6.1") implementation("androidx.compose.ui:ui-tooling-preview:1.3.3") // Other compose dependencies // Compose for Wear OS Dependencies implementation("androidx.wear.compose:compose-material:1.1.1") // Foundation is additive, so you can use the mobile version in your Wear OS app. implementation("androidx.wear.compose:compose-foundation:1.1.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.1.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") }
Diferenças
Use a versão
WearComposeMaterial
das APIs sempre que possível. Embora seja tecnicamente possível usar a
versão para dispositivos móveis do Compose Material, ela não é otimizada para os requisitos
exclusivos do Wear OS. Além disso, misturar o Compose Material com o Compose
Material para Wear OS pode resultar em um comportamento inesperado. Por exemplo, como
cada biblioteca tem a própria classe MaterialTheme
, é possível que
cores, tipografias ou formas sejam inconsistentes se as duas versões forem usadas.
A tabela abaixo descreve as diferenças de dependência entre o Wear OS e o dispositivo móvel:
Dependência do Wear OS
(androidx.wear.*) |
Comparação | Dependência de dispositivos móveis
(androidx.*) |
androidx.wear.compose:compose-material | em vez de | androidx.compose.material:material |
androidx.wear.compose:compose-navigation | em vez de | androidx.navigation:navigation-compose |
androidx.wear.compose:compose-foundation | além de | androidx.compose.foundation:foundation |
Confira este exemplo do arquivo 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
Teste o Compose para Wear OS e use o Issue Tracker para dar sugestões e feedback.
Participe do canal #compose-wear (link em inglês) no Kotlin Slack para se conectar à comunidade de desenvolvedores e compartilhar sua experiência.