Wear OS'te Jetpack Compose'u kullanma

Wear OS için oluşturma işlemi, mobil cihazlar için Compose'a benzer. 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 bu uygulama da daha hızlı bir şekilde daha iyi kodlar yazmanıza yardımcı olur. Bu, Wear OS uygulamalarına için kullanıcı arayüzleri oluştururken önerdiğimiz yaklaşımdır.

Jetpack Compose araç setini kullanmaya aşina değilseniz Compose yolunu inceleyin. Mobil cihazlarda Compose'a yönelik geliştirme ilkelerinin birçoğu Wear OS için Compose'da da geçerlidir. Bildirim temelli kullanıcı arayüzü çerçevesinin genel avantajları hakkında daha fazla bilgi için Neden Oluşturma? bölümüne bakın. Wear OS için Compose hakkında daha fazla bilgi edinmek isterseniz GitHub'daki Compose for Wear OS Pathway'e ve Wear OS örnekleri deposuna göz atın.

Uyumluluk

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

Yüzeyler

Wear OS için Yazma, Wear OS'te uygulama oluşturmayı kolaylaştırır. Daha fazla bilgi için Uygulamalar bölümüne bakın. Wear OS yönergelerine uygun kullanıcı deneyimleri oluşturmak için yerleşik bileşenlerimizi kullanın. Bileşenler hakkında daha fazla bilgi için tasarım kılavuzumuza bakın.

Ayarlama

Jetpack Compose'u Wear OS ile kullanmak, diğer Android projeleri için Jetpack Compose'u kullanmaya benzer. Aradaki temel fark, Wear için Jetpack Compose'un saatlere göre uyarlanmış kullanıcı arayüzleri oluşturmayı kolaylaştıran Wear'a özel kitaplıklar eklemesi. Bazı durumlarda bu bileşenler, Wear haricindeki benzerleriyle aynı ada sahiptir (ö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 Android Studio projesi başlat'ı tıklayın. Açık bir Android Studio projeniz zaten varsa menü çubuğundan Dosya > Yeni > Örneği İçe Aktar'ı seçin.
2. Wear için Oluştur ifadesini arayı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 özellikleri dosyalarında açıklandığı gibi doğru şekilde yapılandırıldığını doğrulayın.

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 aşağıdaki snippet'te gösterildiği gibi uygulamanızın build.gradle dosyasına Jetpack Compose araç seti bağımlılıklarını eklemeniz gerekir:

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2024.06.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")
}

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