Uygulamanızın davranış değişikliklerini nasıl ele aldığını test etme

Wear OS 5 Geliştirici Önizlemesi, Android 14'e (API düzeyi 34) dayanır. Bu sürüm, Wear OS 4'ün bulunduğu sürüme (Android 13 veya API düzeyi 33) kıyasla daha yeni bir sürümdür. Bu nedenle, Wear OS uygulamanızı Wear OS 5 Geliştirici Önizlemesi'nde kullanıma hazırlarken Android 14'teki tüm uygulamaları etkileyen sistem davranış değişikliklerini ve Android 14'ü hedefleyen uygulamalarla ilgili değişiklikleri dikkate almanız gerekir.

Tüm uygulamaları etkileyen Wear OS 5 değişiklikleri

Aşağıdaki davranış değişiklikleri, Wear OS'e özgü kullanım alanlarını ve kitaplıkları etkiler. Bu değişiklikler, hedef SDK sürümünden bağımsız olarak Wear OS 5'te çalışan tüm uygulamaları etkiler.

Gizlilik kontrol paneli

Wear OS 5 Geliştirici Önizlemesi, ilk olarak Android 12 sürümünde mobil cihazlarda kullanıma sunulan gizlilik kontrol paneli için destek ekler.

Gizlilik kontrol paneli, kullanıcılara her uygulamanın veri kullanımını gösteren merkezi bir görünüm sunar. Bu görünümde aşağıdaki bilgiler bulunur:

  • Erişilmekte olan veri türleri (ör. konum ve mikrofon).
  • Bu veri türlerine ne kadar süre önce erişildiği.

Kullanıcılar bu bilgilere erişerek kişisel verilerine hangi uygulamaların erişmeye devam etmesi gerektiği konusunda daha bilinçli kararlar verebilirler. Kullanıcıların güvenini korumak için verileri sorumlu bir şekilde kullanın ve kullanıcı verilerini toplayıp kullanırken şeffaf olun.

Çoğu komplikasyon veri kaynağı, Saat Kadranı Formatı kullanılmasını gerektirir

Wear OS'in Wear OS 5 Geliştirici Önizlemesi de dahil olmak üzere yeni sürümlerinde, kullanıcı verileri içeren özellikleri desteklemek için kadranların Saat Kadranı Formatı'nı kullanması gerekecektir. Saat Kadranı Formatı'nı kullanmak için kadranınızı güncellemenizi öneririz. Özelliklerdeki bu değişiklikler hakkında daha fazla bilgi edinin.

Test amacıyla değişikliği geçici olarak devre dışı bırakın

Bu özellik, varsayılan olarak etkindir. Bu değişikliğe karşılık gelen özellik bayrağını test amacıyla devre dışı bırakmak için aşağıdaki komutu kullanın:

adb shell device_config put wear_services \
  com.google.wear.services.infra.flags.restrict_complications_flag false && \
  adb reboot

Android 14'ü hedefleyen uygulamaları etkileyen Wear OS 5 değişiklikleri

Aşağıdaki değişiklikler uygulamanızı yalnızca hedef SDK'nızı, Wear OS 5 Geliştirici Önizlemesi'nin temel aldığı sürüm olan Android 14'e güncellediğinizde etkiler.

Her zaman açık uygulamalar arka plana geçebilir

Sistem, Wear OS 5 Geliştirici Önizlemesi'nden başlayarak her zaman açık uygulamaları belirli bir süre boyunca ambiyans modunda göründükten sonra arka plana taşır. Kullanıcılar, zaman aşımını sistem ayarlarından yapılandırabilir.

Her zaman açık uygulamanız, müzik çalma veya antrenman oturumu gibi devam eden bir kullanıcı görevi hakkında bilgi gösteriyorsa görev sona erene kadar devam eden etkinliği görünür durumda tutmak isteyebilirsiniz. Bunu yapmak için OnResume Activity API'yi kullanarak her zaman açık etkinliğinizle bağlantılı devam eden bir bildirim yayınlayın.

Sistemin devam eden etkinliği tanıması için devam eden bildirimin dokunma amacı, aşağıdaki kod snippet'inde gösterildiği gibi her zaman açık olan etkinliğinize işaret etmelidir:

// Create a pending intent that point to your always-on activity
val touchIntent =
    PendingIntent.getActivity(
        context,
        0,
        Intent(context, MyAlwaysOnActivity::class.java),
        PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )

val notificationBuilder =
    NotificationCompat.Builder(this, CHANNEL_ID)
    // ...
    .setOngoing(true)

val ongoingActivity =
    OngoingActivity.Builder(
        applicationContext, NOTIFICATION_ID, notificationBuilder
    )
    // ...
    .setTouchIntent(touchIntent)
    .build()

ongoingActivity.apply(applicationContext)

notificationManager.notify(
    NOTIFICATION_ID,
    notificationBuilder.build()
)

Test amacıyla değişikliği geçici olarak devre dışı bırakın

Bu özellik, varsayılan olarak etkindir. Bu değişikliğe karşılık gelen özellik bayrağını test amacıyla devre dışı bırakmak için aşağıdaki komutu kullanın:

adb shell device_config put wear_frameworks \
  com.google.android.clockwork.systemui.flags.ambiactive_components_expirable \
  false && adb reboot

Egzersiz kaydı uygulamaları bir ön plan hizmet türü beyan etmelidir

Uygulamanız bir kullanıcının antrenman oturumunun parçası olarak egzersiz kaydediyorsa ön plan hizmetinde ExerciseClient çağrısı yapan health ön plan hizmeti türünü belirtmeniz gerekir. Ayrıca, uygulamanız antrenman oturumu sırasında konum bilgilerini izleyebiliyorsa location ön plan hizmeti türünü de belirtmeniz gerekir:

<manifest ...>
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <application ...>
      <!-- If your app can also monitor location information, use
           android:foregroundServiceType="health|location" instead. -->
      <service
          android:name=".MyExerciseSessionRecorder"
          android:foregroundServiceType="health">
      </service>
    </application>
</manifest>

Bileğe takılı olmayan bazı cihazların kilidi daha uzun süre açık kalır

Wear OS 5 Geliştirici Önizlemesi'ni çalıştıran desteklenen cihazlarda sistem, kullanıcının cihazı bileğine takıp takmadığını tespit eder. Kullanıcı bilek algılama özelliğini kapatır ve daha sonra cihazı bileğinden çıkarırsa sistem, cihazın kilidinin açık kalmasını, normalde sağlayacağından daha uzun bir süre boyunca sürdürür.

Uygulamanız daha yüksek bir güvenlik düzeyi gerektiriyorsa (örneğin, hassas veya gizli olabilecek verileri gösterirken) önce bilek algılama özelliğinin etkin olup olmadığını kontrol edin:

val wristDetectionEnabled =
        isWristDetectionAutoLockingEnabled(applicationContext)

Bu yöntemin döndürülen değeri false ise kullanıcıya özel içeriği görüntülemeden önce kullanıcıdan uygulamanızda bir hesapta oturum açmasını isteyin.

Sürüklenebilir içerik, sistem hareketi etkinleştirme noktalarıyla çakışabilir

Sistem, Wear OS 5 Geliştirici Önizlemesi'nden başlayarak hareket etkinliği hareketlerini, sistemin kullanıcı arayüzünde kullanılan hareketle gezinmeden ayrı olarak ele alır.

Uygulamanızın kullanıcı arayüzünde, sistem hareketi alanlarıyla çakışan büyük sürüklenebilir alanlar varsa bu görünümler için sistem hareketi hariç tutma dikdörtgenleri eklemeniz gerekebilir. Bunu yapmak için sistem kullanıcı arayüzüne, belirtilen alanlardaki gezinme hareketlerini yoksayması talimatını setSystemGestureExclusionRects() çağrısında bulunun. Bu, uçtan uca bir kullanıcı arayüzü deneyimi sunmak için mobil uygulamanızda çakışan uygulama hareketlerini işleme şeklinize benzer.

Sistem kullanıcı arayüzünün hareket isteklerine farklı şekilde yanıt vermesi için setSystemGestureExclusionRects() API'yi kullanabilirsiniz. Örneğin, sistem kullanıcı arayüzü, kullanıcının amacını doğrulamak için yatay çubuk gibi ek kullanıcı arayüzü ipuçları gösterebilir.

Doğrusal olmayan yazı tipi ölçeklendirme

Sistem, Wear OS 5 Geliştirici Önizlemesi'nden itibaren özellikle kullanıcıların görünüme dayalı kullanıcı arayüzü bileşenlerinde daha büyük yazı tipi boyutları seçtiği durumlarda daha sorunsuz yazı tipi ölçeklendirmeyi destekler.

Dolaylı ve beklemedeki niyetlerle ilgili kısıtlamalar

Uygulamanızda kartlar kullanıyorsanız amaçlarınızın dolaylı ve beklemedeki amaçlara yönelik kısıtlamalardan etkilenip etkilenmediğini kontrol edin.

Bazı bildirimler hâlâ kapatılamıyor

Android 14 (API düzeyi 34) veya sonraki sürümleri çalıştıran bir cihazda uygulamanızın avuç içi sürümünü kullanırken kullanıcılar, önceki sürümlerde kapatılamayan bildirimleri kapatabilir.

Ancak bu bildirimler Wear OS 5 Geliştirici Önizlemesi'nde yine de kapatılamaz.

Android 14'teki diğer değişiklikler

Android 14'te yapılan aşağıdaki değişiklikler, Wear OS uygulamanızı büyük olasılıkla etkiler.

Tüm uygulamaları etkileyen Android 14 değişiklikleri

API düzeyi 34'ü hedefleyen uygulamaları etkileyen Android 14 değişiklikleri