Wear OS'te Jetpack Compose'u kullanma

Wear OS için Oluştur, mobil için Oluştur'a benzer. Ancak bazı temel 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 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 kullanma konusunda bilginiz yoksa Compose yoluna göz atın. Mobil Compose için geçerli olan geliştirme ilkelerinin çoğu Wear OS için Compose'da da geçerlidir. Beyan temelli kullanıcı arayüzü çerçevesinin genel avantajları hakkında daha fazla bilgi için Why Compose (Why Compose) başlıklı makaleyi inceleyin. Wear OS için Compose hakkında daha fazla bilgi edinmek isterseniz Wear OS için Compose Yolu'na ve GitHub'daki Wear OS örnekleri deposuna göz atın.

Wear OS'te Jetpack Compose'da Materyal Tasarım

Wear OS'teki Jetpack Compose, daha ilgi çekici uygulama deneyimleri tasarlamanıza yardımcı olan Material 2.5 uygulamasını sunar. Wear OS'teki Materyal Tasarım bileşenleri, Wear Material Teması'nın üzerine inşa edilmiştir. Bu temalandırma, Material Design'u özelleştirmenin ve ürününüzün markasını daha iyi yansıtmanın sistematik bir yoludur.

Uyumluluk

Wear OS için Oluştur, Wear OS 3.0'u (API düzeyi 30) destekleyen ve Wear OS 2.0'u (API düzeyi 25 ve üzeri) kullanan kol saatlerinde çalışır. Wear OS için Compose'un 1.4 sürümünü kullanmak için androidx.compose kitaplıklarının 1.7 sürümünü ve Kotlin 1.9.0'ı kullanmanız gerekir. Compose uyumluluğunu kontrol etmek için BOM eşlemesini ve Compose ile Kotlin uyumluluk haritasını kullanabilirsiniz.

Yüzeyler

Wear OS için Derle, Wear OS'te uygulama geliştirmeyi kolaylaştırır. Daha fazla bilgi için Uygulamalar'a 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 yönergelerimizi inceleyin.

Ayarlama

Jetpack Compose'u Wear OS ile kullanmak, diğer Android projelerinde Jetpack Compose'u kullanmaya benzer. Aradaki en önemli fark, Wear için Jetpack Compose'un kol saatlerine özel kitaplıklar ekleyerek kol saatlerine özel kullanıcı arayüzleri oluşturmayı kolaylaştırmasıdır. Bazı durumlarda bu bileşenler, androidx.wear.compose.material.Button ve androidx.compose.material.Button gibi giyilebilir olmayan muadilleriyle aynı ada sahiptir.

Android Studio'da yeni 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 Dosya > Yeni > Sana Özel Örneği İçe Aktar'ı seçin.
  2. Compose for Wear'ı arayın ve Compose for Wear OS Starter'ı seçin.
  3. Projenizi yapılandırın penceresinde aşağıdakileri yapın:
    1. Uygulama adını ayarlayın.
    2. Sana Özel içeriğiniz için 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 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 çevrili üst mimari katmanlarda yer alır.

<img 'foundation',="" 'material',="" 'runtime'.="" 'ui',="" 2="" 4="" a="" alt="" and="" are="" bottom,="" box""="" by="" contain="" from="" rectangles="" rectangles.="" red="" src="/static/wear/images/components/ComposeDependencies.png" surrounded="" the="" to="" top="" />

Yani Jetpack Compose ile zaten kullandığınız bağımlılıkların çoğu, Wear OS'u hedeflediğinizde değişmez. Örneğin, kullanıcı arayüzü, çalışma zamanı, derleyici ve animasyon bağımlılıkları aynı kalır.

Ancak Wear OS'un material, foundation ve navigation kitaplıklarının kendi 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ü teknik olarak kullanmak mümkün olsa da bu sürüm, Wear OS'un benzersiz gereksinimleri için optimize edilmemiştir. Ayrıca, Compose Material'ı Wear OS için Compose Material ile karıştırmak beklenmedik davranışlara neden olabilir. Örneğin, her kitaplığın kendi MaterialTheme sınıfı olduğundan her iki sürüm de kullanılıyorsa renklerin, yazı tiplerinin veya şekillerin tutarsız olması olasıdır.

Aşağıdaki tabloda, Wear OS ile Mobil arasındaki bağımlılık farklılıkları özetlenmiştir:

Wear OS Bağımlılığı

(androidx.wear.*)

Karşılaştırma Mobil Bağımlılık

(androidx.*)

androidx.wear.compose:compose-material yerine androidx.compose.material:material
androidx.wear.compose:compose-navigation yerine androidx.navigation:navigation-compose
androidx.wear.compose:compose-foundation Buna ek olarak androidx.compose.foundation:foundation

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

Kotlin

dependencies {

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

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

Geri bildirim

Wear OS için Oluştur'u deneyin ve öneri ve geri bildirim sağlamak için sorun izleyiciyi kullanın.

Geliştirici topluluğuyla bağlantı kurmak ve deneyiminizi bizimle paylaşmak için Kotlin Slack'teki #compose-wear kanalına katılın.