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:

Kotlin

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")
}

Farklı olan nedir?

Şunu kullanın: WearComposeMaterial API sürümünü kullanıyorsunuz. Her ne kadar mobil sürümünde benzersiz özelliklere sahip değildir. Wear OS gereksinimleri. Ayrıca, Compose Material'ı Wear OS için Compose Material ile karıştırmak beklenmedik davranışlara neden olabilir. Örneğin, her kütüphanenin kendi MaterialTheme sınıfı vardır. her iki sürüm de kullanılıyorsa renklerin, tipografinin veya şekillerin tutarsız olması.

Aşağıdaki tabloda, Wear OS ve Google Ads'in Mobil:

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

Aşağıda örnek bir build.gradle dosyası verilmiştir:

// 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 sorun izleyici aracını kullanabilirsiniz.

Katıl #compose-wear kanalı Kotlin Slack'teki geliştirici topluluğuyla bağlantı kurabilir ve sunmaktır.

ziyaret edin.