Wear OS'te Jetpack Compose'u kullanma

Wear OS için oluşturma şuna benzer: Mobil cihazlar için ileti oluşturun. Ancak bazı önemli farklar vardır. Bu kılavuz benzerlikler ve farklılıklar konusunda size yol gösterir.

Wear OS için Compose, Android Jetpack'in bir parçasıdır ve kullandığınız diğer Wear Jetpack kitaplıkları gibi daha iyi kodları daha hızlı yazmanıza yardımcı olur. Wear OS uygulamaları için kullanıcı arayüzleri oluşturmaya yönelik önerilen yaklaşımımız budur.

Jetpack Compose araç setini kullanmayı bilmiyorsanız şu makaleye göz atın: Yol yolu oluşturun. Mobil Cihazlar için oluşturulan ileti yazma ilkelerinin çoğu Wear OS için Compose'a uygulayın. bildirim temelli kullanıcı arayüzü çerçevesinin genel avantajları. Oluşturma hakkında daha fazla bilgi edinmek için Wear OS için Wear OS İçin Oluşturma ve Wear OS örneklerine bakın repository'yi kullanabilirsiniz.

Uyumluluk

Wear OS için Compose, Wear OS 3.0'ı (API Düzeyi 30) destekleyen saatlerde çalışır ve Wear OS 2.0 (API düzeyi 25 ve üstü) kullanan kol saatleri. Kullanım Wear OS için Compose'un 1.0 sürümü için 1.2 sürümünün kullanılması gerekir androidx.compose kitaplıkları ve Kotlin 1.7.0 sürümü.

Yüzeyler

Wear OS için Yazma, Wear OS'te uygulama oluşturmayı kolaylaştırır. Okuyucu Gelirleri Yöneticisi'ni Uygulamalar'ı inceleyin. Yerleşik Wear OS yönergelerine uygun kullanıcı deneyimleri oluşturmak için kullanılan bileşenler. Bileşenler hakkında daha fazla bilgi için tasarım kılavuzundan yararlanabilirsiniz.

Ayarlama

Wear OS ile Jetpack Compose'u kullanmak, tüm Android projelerinde kullanılabilir. Temel fark, Wear için Jetpack Compose'un Kullanıcı arayüzü oluşturmayı kolaylaştıran Wear'a özel kitaplıklar ekler özel olarak tasarlanan yeni bir model. Bazı durumlarda bu bileşenler giysi olmayan benzerleri (ör. androidx.wear.compose.material.Button ve androidx.compose.material.Button.

Android Studio'da yeni uygulama oluşturma

Jetpack Compose'u içeren yeni bir proje oluşturmak için aşağıdaki adımları uygulayın:

1. Android Studio'ya Hoş Geldiniz penceresindeyseniz Yeni bir uygulama başlat Android Studio projesi. Açık bir Android Studio projeniz varsa Dosya > Yeni > Menü çubuğundan Örneği İçe Aktar'ı seçin.
2. Wear için Oluştur aramasını yapın ve Wear OS Starter için oluştur'u seçin.
3. Projenizi yapılandırın penceresinde aşağıdakileri yapın:
   1. Uygulama adı'nı ayarlayın.
   2. Örneğinizin Proje konumu'nu seçin.
4. Son'u tıklayın.
5. Projenin build.gradle dosyasının, Gradle özellik dosyalarında açıklandığı gibi doğru şekilde yapılandırıldığından emin olun.

Artık Wear OS için Compose'u kullanarak uygulama geliştirmeye hazırsınız.

Jetpack Compose araç seti bağımlılıkları

Jetpack Compose'u Wear OS ile kullanmak için Jetpack Compose'u eklemeniz gerekir uygulamanızın build.gradle dosyasındaki araç seti bağımlılıklarını aşağıdaki snippet:

dependencies {

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

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

    // Compose for Wear OS Dependencies
    implementation("androidx.wear.compose:compose-material:1.4.0")

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

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

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

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