Wear OS 5.1

Belirli cihazlarda ve Android Studio'daki resmi emülatörde kullanılabilen Wear OS'un en son sürümünü keşfedin. Hedef SDK sürümünüzü güncelledikten sonra uygulamanızın beklendiği gibi çalıştığından emin olun.

Wear OS 5.1, Android 15'i (API düzeyi 35) temel alı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ışabilir:

• Google Pixel Watch 3 (Bluetooth/Kablosuz Ağ)
• Google Pixel Watch 2 (Bluetooth/Kablosuz Ağ)

Cihazınıza kablosuz (OTA) yazılım güncellemesi gönderilir. 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ünü yükleyin. Örneğin, fabrika görüntüsünü veya tam OTA görüntüsünü yükleyebilirsiniz.

Emülatörü teste 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 imajını indirip yükleme

Doğru sistem görüntüsünü indirip yüklemek için aşağıdaki adımları uygulayın:

1. Henüz yapmadıysanız Android Studio Ladybug Yeni Özellikleri'nin en son sürümünü veya daha yeni bir sürümünü indirip yükleyin.
2. Android Studio'da Araçlar > SDK Yöneticisi'ni tıklayın.

3. SDK Platformları sekmesinde Paket Ayrıntılarını Göster'i tıklayın ve API düzeyi 35-ext15 yapılarını 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:

   

4. Tamam'ı tıklayın. Değişikliği Onayla penceresi göründüğünde tekrar Tamam'ı tıklayın.

5. Android Studio'nun sistem görüntüsünü indirip yüklemesini bekleyin ve ardından Son'u tıklayın.

Sanal cihaz oluşturma

Bu sistem imajını resmi emülatörde çalıştıran bir sanal cihaz oluşturmak için aşağıdaki adımları uygulayın:

1. Android Studio'da Araçlar > Cihaz Yöneticisi'ni seçerek Cihaz Yöneticisi'ni açın. Cihaz Yöneticisi bölmesi görünür.
2. Cihaz Yöneticisi bölmesinde bulunan araç çubuğunda Yeni cihaz ekle > Sanal Cihaz Oluştur'u tıklayın.
3. Form Faktörü bölmesinde Wear OS'i ve bir donanım profili seçin. İleri'yi tıklayın.
4. 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.
5. Sonraki'yi ve ardından Son'u 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ı uygulayın:

1. Android Studio araç çubuğuna gidip sanal cihazı seçin.
2. Çalıştır'ı tıklayın.
3. Uygulamanızı sanal cihaza yükleyin ve uygulamanızın kullandığı kullanıcılara yönelik farklı iş akışları arasında gezinin.

Tüm uygulamaları etkileyen değişiklikler

Uygulamanızı Wear OS 5.1'de test ederken, Wear OS 5.1 ile aynı API düzeyini kullanan Android 15'teki tüm uygulamaları etkileyen sistem davranışı değişikliklerini uygulamanızın nasıl ele aldığını kontrol edin.

Wear OS 5.1'de bazı davranış değişiklikleri geçerli olmaz:

• Özel alanlar Wear OS 5.1'de 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çıp Wear OS 5.1'e ait değerlerle 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 sonraki bir sürümü kullanıyorsanız uygulamanızın build.gradle veya 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 veya 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 uygulamalar için değişiklikleri yapın.

Yeni özellikleri keşfedin

Wear OS 5.1, Wear OS uygulama deneyiminizi iyileştirmeye yardımcı olacak çeşitli özellikler sunar.

Not: Bu özellikleri uygulamanıza eklemeden önce uygulamanızı, Wear OS 5.1'de kullanıma sunulan davranış değişikliklerini işlemeye hazırlayın.

Keşfedebileceğiniz önemli özelliklerden bazıları şunlardır:

• Kimlik bilgisi yöneticisi desteği: Kimlik Bilgisi Yöneticisi API'si, şifreler, geçiş anahtarları ve birleşik kimliği (ör. Google ile oturum açma) kullanan oturum açma akışlarını destekleyen birleşik bir kimlik doğrulama çözümü sunar. Kullanıcının kimlik bilgileri, hesap bilgilerini cihazlar arasında senkronize eden bir kimlik bilgisi sağlayıcısında saklanır.
• Kol saati hoparlörü üzerinden oynatma: Uygulamanız Wear Çıkış Değiştirici ile entegreyse kullanıcılar, kol saati hoparlörü üzerinden medya oynatmayı destekleyen cihazlarda bu hoparlörü tercih ettikleri medya çıkışı seçeneği olarak belirleyebilir.

Sürüm notları

Wear OS 5.1 için en son sistem görüntüsü, desteklenen cihazlarda ve emülatörde kullanılabilir. Bu görüntünün özellikleri şunlardır:

Yayınlanma tarihi	4 Mart 2025
Oluşturma	Cihazlarda BP1A.250305.019.W3 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 sonra kurulum akışında kullanıcının her zaman hesap eklemesine izin vermez.
• Bir bildirime dokunulduğunda, bildirimi gönderen uygulama kullanıcı ekranı kaydırana kadar açılmaz.
• Wear Health Services bazen egzersiz başlatmayı başaramaz.
• API düzeyi 35'i hedefleyen bir uygulamada androidx.wear.tiles veya androidx.wear:wear-phone-interactions kitaplıklarına erişirseniz SecurityException oluşabilir. Bu sorunu çözmek için her kitaplığın en son sürümüne geçin.