Wear OS'te Jetpack Compose'u kullanma

Wear OS için Compose, mobil için Compose'a benzer. Ancak bazı önemli farklar vardır. Bu kılavuzda, benzerlikler ve farklılıklar açıklanmaktadır.

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 hızlı bir şekilde daha iyi kod yazmanıza yardımcı olur. Wear OS uygulamaları için kullanıcı arayüzleri oluştururken bu yaklaşımı kullanmanızı öneririz.

Jetpack Compose araç setini kullanma konusunda deneyimli değilseniz Compose yoluna göz atın. Mobil cihazlar için Compose'un geliştirme ilkelerinin ç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 Compose? başlıklı makaleyi inceleyin. Wear OS için Oluştur hakkında daha fazla bilgi edinmek istiyorsanız Wear OS için Oluştur yolu ve GitHub'daki Wear OS örnekleri deposuna göz atın.

android skills add wear-compose-m3

Wear OS'te Jetpack Compose ile Materyal Tasarım

Wear OS'te Jetpack Compose, daha ilgi çekici uygulama deneyimleri tasarlamanıza yardımcı olan Material 3'ün bir uygulamasını sunar. Wear OS'teki Materyal Tasarım bileşenleri, Wear Materyal Teması Oluşturma üzerine kuruludur. Bu tema, Materyal Tasarım'ı özelleştirmenin ve ürününüzün markasını daha iyi yansıtmanın sistematik bir yoludur.

Uyumluluk

Yüzeyler

Wear OS için Compose, Wear OS'te uygulama geliştirmeyi 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ılavuzumuzu inceleyin.

Ayarlama

Wear OS ile Jetpack Compose'u kullanmak, diğer Android projelerinde Jetpack Compose'u kullanmaya benzer. Temel fark, Wear için Jetpack Compose'un, saatlere özel kullanıcı arayüzleri oluşturmayı kolaylaştıran Wear'a özgü kitaplıklar eklemesidir. Bazı durumlarda bu bileşenler, Wear olmayan muadilleriyle aynı adı paylaşır. Örneğin, androidx.wear.compose.material3.Button ve androidx.compose.material3.Button.

Android Studio'da yeni bir uygulama oluşturma

Jetpack Compose 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 varsa menü çubuğundan File > New > Import Sample'ı (Dosya > Yeni > Örneği İçe Aktar) seçin.
2. Compose for Wear'i arayın ve Compose for Wear OS Starter'ı seçin.
3. Configure your project (Projenizi yapılandırın) penceresinde aşağıdakileri yapın:
   1. Uygulama adı'nı ayarlayın.
   2. Örneğinize ait proje konumunu seçin.
4. Son'u tıklayın.
5. Projenin build.gradle dosyasının, Gradle özellik dosyaları bölümünde 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 başlayabilirsiniz.

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

Jetpack Compose'u Wear OS ile kullanmak için Jetpack Compose araç seti bağımlılıklarını uygulamanızın build.gradle dosyasına eklemeniz gerekir. Wear OS ile ilgili bağımlılık değişikliklerinin çoğu, aşağıdaki resimde kırmızı kutuyla gösterilen üst mimari katmanlarda yer alır.

Bu, Jetpack Compose ile kullandığınız bağımlılıkların çoğunun Wear OS'i hedeflerken değişmediği anlamına gelir. Örneğin, kullanıcı arayüzü, çalışma zamanı, derleyici ve animasyon bağımlılıkları aynı kalır.

Ancak Wear OS'in kendi material ve material3, foundation ve navigation kitaplık sürümleri vardır. Bu nedenle, doğru kitaplıkları kullandığınızdan emin olun.

Mümkün olduğunda API'lerin WearComposeMaterial sürümünü kullanın. Compose Material'ın mobil sürümünü kullanmak teknik olarak mümkün olsa da bu sürüm, Wear OS'in benzersiz gereksinimleri için optimize edilmemiştir. Ayrıca, Compose Material ile Wear OS için Compose Material'ı karıştırmak beklenmedik davranışlara yol açabilir. Örneğin, her kitaplığın kendi MaterialTheme sınıfı olduğundan her iki sürüm de kullanıldığında renkler, tipografi veya şekiller tutarsız olabilir.

Aşağıdaki tabloda Wear OS ile mobil cihazlar arasındaki bağımlılık farklılıkları gösterilmektedir:

Aşağıdaki snippet'te, bu bağımlılıkları içeren örnek bir build.gradle dosyası gösterilmektedir:

dependencies {

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

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

    // Compose for Wear OS dependencies
    implementation("androidx.wear.compose:compose-material3:1.7.1")

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

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.7.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.7.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.4.1")

}