Belirli cihazlarda ve Android Studio'daki resmi emülatörde kullanılabilen Wear OS'in en yeni sürümünü keşfedin. Hedef SDK sürümünüzü güncelledikten sonra uygulamanızın beklendiği gibi çalıştığını kontrol edin.
Wear OS 5.1, Android 15'e (API düzeyi 35) dayanır. Bu nedenle, Wear OS 5 için API düzeyi 34'ü hedefleyen uygulamalarınızı test etmeniz gerekir.
Test için desteklenen bir cihaz hazırlama
Wear OS 5.1 aşağıdaki cihazlarda çalıştırılabilir:
- Google Pixel Watch 3
- Google Pixel Watch 2
- Google Pixel Watch
Cihazınız kablosuz (OTA) yazılım güncellemesi almalıdır. Ayrıca, aşağıdakilerden birini yaparak cihazınızı manuel olarak da güncelleyebilirsiniz:
- Ayarlar uygulamasında Sistem > Sistem güncellemeleri'ne gidin.
- Geliştirici seçeneklerini etkinleştirdikten sonra, USB (kablolu) veri bağlantısını destekleyen cihazlara belirli bir yazılım görüntüsü yükleyin. Örneğin, fabrika görüntüsü veya tam OTA görüntüsü yükleyebilirsiniz.
Emülatörü test için hazırlama
Wear OS 5.1'i resmi emülatörde çalıştırmak için öncelikle emülatörde çalışan sistem görüntüsünü indirip yüklemeniz gerekir. Ardından, bu sistem görüntüsünü çalıştıran bir sanal cihaz oluşturmanız gerekir.
Sistem görüntüsünü indirip yükleme
Doğru sistem görüntüsünü indirip yüklemek için aşağıdaki adımları tamamlayın:
- Henüz yapmadıysanız Android Studio Ladybug Feature Drop'un en son sürümünü veya daha yeni bir sürümü indirip yükleyin.
- Android Studio'da Tools > SDK Manager'a (Araçlar > SDK Yöneticisi) gidin.
SDK Platformları sekmesinde Paket Ayrıntılarını Göster'i seçin ve API düzeyi 35-ext15 için yapay nesneler içeren Android 15.0 ("VanillaIceCream") bölümünü genişletin. Ardından, Wear OS 5.1 ARM 64 v8a Sistem Görüntüsü veya Wear OS 5.1 Intel x86_64 Atom Sistem Görüntüsü'nü seçin:
Tamam'ı tıklayın. Değişikliği Onayla penceresi göründüğünde tekrar Tamam'ı tıklayın.
Android Studio'nun sistem görüntüsünü indirip yüklemesini bekleyin ve ardından Finish'i (Son) tıklayın.
Sanal cihaz oluşturma
Bu sistem görüntüsünü resmi emülatörde çalıştıran bir sanal cihaz oluşturmak için aşağıdaki adımları tamamlayın:
- Android Studio'da Tools > Device Manager'ı (Araçlar > Cihaz Yöneticisi) seçerek Cihaz Yöneticisi'ni açın. Cihaz Yöneticisi bölmesi gösterilir.
- Cihaz Yöneticisi bölmesindeki araç çubuğunda Yeni cihaz ekle
> Sanal Cihaz Oluştur'a dokunun.
- Form Faktörü bölmesinde Wear OS'i seçin ve bir donanım profili belirleyin. İleri'yi tıklayın.
- Kullanılacak Wear OS 5.1 sistem görüntüsünü seçin. Sistem görüntüsünün API düzeyi 35 olmalıdır.
- Next'i (Sonraki) ve ardından Finish'i (Son) tıklayın.
Uygulamanızı emülatörde test etme
Uygulamanızı oluşturduğunuz bu sanal cihazda test etmek için aşağıdaki adımları tamamlayın:
- Android Studio araç çubuğuna gidip sanal cihazı seçin.
- Çalıştır'a dokunun
.
- Uygulamanızı sanal cihaza yükleyin ve uygulamanızın kullandığı farklı kullanıcıya yönelik iş akışlarında gezinin.
Tüm uygulamaları etkileyen değişiklikler
Uygulamanızı Wear OS 5.1'de test ederken uygulamanızın, Wear OS 5.1 ile aynı API düzeyini kullanan Android 15'teki tüm uygulamaları etkileyen sistem davranış değişikliklerini nasıl ele aldığını kontrol edin.
Wear OS 5.1'de geçerli olmayan birkaç davranış değişikliği vardır:
- Wear OS 5.1'de özel alanlar desteklenmez.
- Tahmine dayalı geri hareketi animasyonları görünmeyebilir.
Uygulamanızın hedef SDK sürümünü güncelleme
Uygulamanızın hedef SDK sürümünü API düzeyi 35'e güncelleyerek uygulamanızın Wear OS 5.1 ile uyumluluğunu artırabilirsiniz. (Bu, Android 15'in kullandığı API düzeyiyle aynıdır.)
Bunu yapmak için modül düzeyindeki build.gradle
veya build.gradle.kts
dosyanızı açın ve Wear OS 5.1 değerleriyle güncelleyin.
Derleme dosyanızdaki değerleri nasıl biçimlendireceğiniz, kullandığınız Android Gradle eklentisinin (AGP) sürümüne bağlıdır.
AGP 7.0.0 veya sonraki sürümler
AGP 7.0.0 veya daha yeni bir sürümü kullanıyorsanız uygulamanızın build.gradle
ya da build.gradle.kts
dosyasını Wear OS 5.1 için aşağıdaki değerlerle güncelleyin:
Groovy
android { compileSdk 35 ... defaultConfig { targetSdk 35 } }
Kotlin
android { compileSdk = 35 ... defaultConfig { targetSdk = 35 } }
AGP 4.2.0 veya daha eski sürümler
AGP 4.2.0 veya daha eski bir sürümü kullanıyorsanız uygulamanızın build.gradle
ya da build.gradle.kts
dosyasını Wear OS 5.1 için aşağıdaki değerlerle güncelleyin:
Groovy
android { compileSdkVersion "35" ... defaultConfig { targetSdkVersion "35" } }
Kotlin
android { compileSdkVersion = "35" ... defaultConfig { targetSdkVersion = "35" } }
Yalnızca API düzeyi 35'i hedefleyen uygulamaları etkileyen değişiklikler
Hedef SDK sürümünüzü API düzeyi 35'e güncelledikten sonra, Wear OS 5.1 ile aynı API düzeyini kullanan Android 15'i hedefleyen uygulamalardaki değişiklikleri ele alın.
Yeni özellikleri keşfedin
Wear OS 5.1, Wear OS uygulama deneyiminizi geliştirmeye yardımcı olacak çeşitli özellikler sunar.
İnceleyebileceğiniz önemli özellikler arasında şunlar yer alır:
- Kimlik bilgisi yöneticisi desteği: Kimlik Bilgisi Yöneticisi API'si, şifreler, geçiş anahtarları ve birleştirilmiş kimlik (ör. Google ile oturum açma) kullanılarak oturum açma akışlarını destekleyen birleşik bir kimlik doğrulama çözümü sunar. Kullanıcı kimlik bilgileri, hesap bilgilerini cihazlar arasında senkronize eden bir kimlik bilgisi sağlayıcısında saklanır.
- Kol saati hoparlöründe oynatma: Medya oynatmayı kol saati hoparlörü üzerinden destekleyen cihazlarda kullanıcılar, uygulamanız Wear Output Switcher ile entegre edilmişse bu hoparlörü tercih ettikleri medya çıkışı seçeneği olarak belirleyebilir.
Sürüm notları
Desteklenen cihazlarda ve emülatörde kullanılabilen Wear OS 5.1'in en yeni sistem görüntüsü aşağıdaki özelliklere sahiptir:
Yayınlanma tarihi | Google Pixel Watch 3 LTE, Google Pixel Watch 2 LTE ve Google Pixel Watch (hem Bluetooth/Wi-Fi hem de LTE) için 18 Mart 2025 Google Pixel Watch 3 Bluetooth/Kablosuz ve Google Pixel Watch 2 Bluetooth/Kablosuz için 4 Mart 2025 |
Derleme |
Google Pixel Watch 3 ve Google Pixel Watch 2'de BP1A.250305.019.W3 Google Pixel Watch'ta BP1A.250305.019.W2 Emülatörde AP4A.241205.004.F4 |
Emülatör desteği | x86 (64 bit), ARM (v8-A) |
Bilinen sorunlar
Wear OS 5.1'i içeren sistem görüntüsünde aşağıdaki bilinen sorunlar vardır:
- Emülatör, cihaz sıfırlandıktan sonraki kurulum akışı sırasında kullanıcının hesap eklemesine her zaman izin vermez.
- Bir bildirime dokunulduğunda, kullanıcı ekranı kaydırana kadar bildirimi gönderen uygulama açılmaz.
- Wear Health Services bazen egzersizi başlatamaz.
- API düzeyi 35'i hedefleyen bir uygulamada
androidx.wear.tiles
veyaandroidx.wear:wear-phone-interactions
kitaplıklarına erişirsenizSecurityException
hatası oluşabilir. Bu sorunu çözmek içinandroidx.wear.tiles
1.5.0-alpha05 veya sonraki bir sürüme ya daandroidx.wear:wear-phone-interactions
1.1.0 veya sonraki bir sürüme yükseltin.