Korzystanie z Jetpack Compose na Wear OS

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:

1. 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ę.
2. Wyszukaj Utwórz na Wear OS i wybierz Utwórz na Wear OS Starter.
3. W oknie Skonfiguruj projekt wykonaj te czynności:
   1. Ustaw Nazwę aplikacji.
   2. Wybierz lokalizację projektu na potrzeby próbki.
4. Kliknij Zakończ.
5. 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:

dependencies {
    // General compose dependencies
    implementation("androidx.activity:activity-compose:1.9.0")
    implementation("androidx.compose.ui:ui-tooling-preview:1.6.6")
    // 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")
}

// 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...
}