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:
- 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.
- Wear için Oluştur'u arayıp Wear OS Starter için oluştur'u seçin.
- Projenizi yapılandırın penceresinde aşağıdakileri yapın:
- Uygulama adı'nı ayarlayın.
- Örneğiniz için Proje konumu'nu seçin.
- Son'u tıklayın.
- 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.9.0") implementation("androidx.compose.ui:ui-tooling-preview:1.6.7") // 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") }
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.
Sizin için önerilenler
- Not: Bağlantı metni JavaScript kapalıyken görüntülenir
- Başlangıç ekranı ekleme
- Devam Eden Etkinlik
- Kartları kullanmaya başlama