Funkcja Tworzenie na Wear OS jest podobna do funkcji Tworzenie wiadomości na urządzeniu mobilnym. Istnieją jednak pewne kluczowe różnice. W tym przewodniku omówimy podobieństwa i różnice.
Tworzenie wiadomości na Wear OS jest częścią Androida Jetpack. Umożliwia szybsze pisanie lepszego kodu, podobnie jak inne biblioteki na Wear Jetpack. To zalecane przez nas podejście do tworzenia interfejsów aplikacji na Wear OS.
Jeśli nie znasz jeszcze narzędzi Jetpack Compose, przeczytaj ścieżkę tworzenia wiadomości. Wiele zasad tworzenia wiadomości na urządzenia mobilne dotyczy też tworzenia wiadomości na Wear OS. Więcej informacji o ogólnych zaletach deklaratywnej platformy interfejsu znajdziesz w artykule Dlaczego warto tworzyć. Więcej informacji o tworzeniu wiadomości na Wear OS znajdziesz w artykule o ścieżce tworzenia wiadomości na Wear OS i repozytorium przykładów z Wear OS na GitHubie.
Zgodność
Funkcja tworzenia wiadomości w Wear OS działa na zegarkach obsługujących Wear OS 3.0 (poziom API 30) i zegarki z Wear OS 2.0 (poziom API 25 lub nowszy). Korzystanie z komponentów w wersji 1.0 na Wear OS wymaga używania bibliotek androidx.compose w wersji 1.2 i Kotlin 1.7.0.
Platformy
Tworzenie aplikacji na Wear OS ułatwia tworzenie aplikacji na tym urządzeniu. Więcej informacji znajdziesz w sekcji Aplikacje. Wykorzystaj nasze wbudowane komponenty, aby tworzyć wrażenia użytkownika zgodne z wytycznymi dotyczącymi Wear OS. Więcej informacji o komponentach znajdziesz w naszych wskazówkach dotyczących projektowania.
Konfiguracja
Korzystanie z Jetpack Compose na Wear OS przypomina używanie Jetpack Compose w każdym innym projekcie na Androida. Główna różnica polega na tym, że Jetpack Compose na Wear dodaje biblioteki przeznaczone specjalnie na Wear, które ułatwiają tworzenie interfejsów dostosowanych do zegarków. W niektórych przypadkach komponenty mają taką samą nazwę jak komponenty, które nie są zużyte, np. androidx.wear.compose.material.Button
i androidx.compose.material.Button
.
Tworzenie nowej aplikacji w Android Studio
Aby utworzyć nowy projekt zawierający Jetpack Compose, wykonaj te czynności:
- Jeśli jesteś w oknie Witamy w Android Studio, kliknij Rozpocznij nowy projekt Android Studio. Jeśli masz już otwarty projekt Android Studio, na pasku menu wybierz Plik > Nowy > Importuj próbkę.
- Wyszukaj Utwórz na Wear OS i wybierz Utwórz na Wear OS Starter.
- W oknie Skonfiguruj projekt wykonaj te czynności:
- Ustaw Nazwę aplikacji.
- Wybierz lokalizację projektu na potrzeby próbki.
- Kliknij Zakończ.
- Sprawdź, czy plik
build.gradle
projektu jest prawidłowo skonfigurowany zgodnie z opisem w sekcji Pliki właściwości Gradle.
Możesz teraz zacząć tworzyć aplikacje korzystające z funkcji Utwórz na Wear OS.
Zależności pakietu narzędzi Jetpack Compose
Aby korzystać z Jetpack Compose w Wear OS, musisz umieścić zależności Jetpack Compose w pliku build.gradle
aplikacji, jak pokazujemy w tym fragmencie:
Kotlin
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.05.00") // General compose dependencies implementation(composeBom) implementation("androidx.activity:activity-compose:1.9.0") implementation("androidx.compose.ui:ui-tooling-preview:1.6.8") // 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") }
Co się zmieniło
Gdy to możliwe, używaj wersji interfejsów API WearComposeMaterial
. Chociaż jest technicznie możliwe używanie mobilnej wersji Compose Material, nie jest ona zoptymalizowana pod kątem unikalnych wymagań Wear OS. Poza tym w przypadku Wear OS połączenie opcji Material Material i Composer może spowodować nieoczekiwane działanie. Na przykład każda biblioteka ma własną klasę MaterialTheme
, więc kolory, typografia lub kształty mogą być niespójne, jeśli używane są obie wersje.
W tej tabeli podano różnice między Wear OS i urządzeniami mobilnymi:
Zależność z Wear OS
(androidx.wear.*) |
Porównanie | Zależność od urządzeń mobilnych
(androidx*). |
androidx.wear.compose:compose-material, | zamiast | androidx.compose.material:material |
androidx.wear.compose:compose-navigation | zamiast | androidx.navigation:nawigacja-tworzenie |
androidx.wear.compose:compose-foundation | oprócz | androidx.compose.foundation:foundation |
Oto przykładowy plik 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...
}
Opinia
Wypróbuj aplikację Utwórz na Wear OS i korzystaj z narzędzia do śledzenia problemów, aby przekazywać sugestie i przekazywać opinie.
Dołącz do #compose-wear kanału w Kotlin Slack, aby nawiązać kontakt ze społecznością programistów i podzielić się swoimi doświadczeniami.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
- Dodawanie ekranu powitalnego
- Bieżące działania
- Pierwsze kroki z kafelkami