Wear OS'te Jetpack Compose'u kullanma

Wear OS için oluşturma, Mobil için Oluşturma'ya benzer. Ancak bazı önemli farklılıklar 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 hızlı bir şekilde daha iyi kod yazmanıza yardımcı olur. Wear OS uygulamaları için kullanıcı arayüzleri oluştururken önerdiğimiz yaklaşım budur.

Jetpack Compose araç setini kullanmaya aşina değilseniz Compose yolu'na göz atın. Mobil ileti yazma ile ilgili geliştirme ilkelerinin çoğu Wear OS için Compose için de geçerlidir. Bildirim temelli kullanıcı arayüzü çerçevesinin genel avantajları hakkında daha fazla bilgi için Neden Oluşturmaya? bölümüne bakın. Wear OS için Compose hakkında daha fazla bilgi edinmek için Compose for Wear OS Pathway'e ve GitHub'daki Wear OS örnek 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 sonraki sürümleri) kullanan saatlerde çalışır. Wear OS için Compose'un 1.0 sürümünü kullanmak için androidx.compose kitaplıklarının 1.2 sürümünün ve Kotlin 1.7.0'ın kullanılması gerekir.

Yüzeyler

Wear OS için ileti oluşturma özelliği, Wear OS'te uygulama oluşturmayı 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 rehberimize bakın.

Ayarlama

Jetpack Compose'u Wear OS ile kullanmak diğer Android projelerinde Jetpack Compose'a benzer. Başlıca fark, Wear için Jetpack Compose'un saate göre uyarlanmış kullanıcı arayüzleri oluşturmayı kolaylaştıran Wear'a özel kitaplıklar eklemesidir. Bazı durumlarda bu bileşenler, androidx.wear.compose.material.Button ve androidx.compose.material.Button gibi aşınma olmayan eşdeğerleriyle aynı adı paylaşır.

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. Zaten açık bir Android Studio projeniz varsa menü çubuğundan Dosya > Yeni > Örneği İçe Aktar'ı seçin.
  2. Wear için Oluştur'u arayıp 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ğiniz için Proje konumu'nu seçin.
  4. Son'u tıklayın.
  5. Projenin build.gradle dosyasının, Gradle özellikleri 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 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 Jetpack Compose araç kiti bağımlılıklarını uygulamanızın build.gradle dosyasına eklemeniz gerekir:

Kotlin

dependencies {
    // General compose dependencies
    implementation("androidx.activity:activity-compose:1.8.2")
    implementation("androidx.compose.ui:ui-tooling-preview:1.6.1")
    // Other compose dependencies

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

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

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

Farklı olan

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 Wear OS'in 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ıldığında renkler, tipografi veya şekillerin tutarsız olması mümkündür.

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

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:malzeme
androidx.wear.compose:compose-navigation yerine androidx.navigation:navigation-compose
androidx.wear.compose:compose-foundation buna ek olarak androidx.compose.foundation:temel

Örnek bir build.gradle dosyası:

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

Geri bildirim

Wear OS için Compose'u deneyin ve öneride bulunmak ve geri bildirimde bulunmak için sorun izleyiciyi kullanın.

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