Wear için uygulamanızın hedef SDK sürümünü güncelleyin ↗4

Uygulamanızı Wear OS 4'e hazırlamak için güncelledikten sonra, Android 13'ü (API düzeyi 33) hedefleyerek uygulamanızın Wear OS'in bu sürümüyle uyumluluğunu daha da iyileştirebilirsiniz.

Hedef SDK sürümünüzü güncellerseniz Android 12 veya sonraki sürümleri hedefleyen uygulamalar ile Android 13 veya sonraki sürümleri hedefleyen uygulamalar için geçerli olan sistem davranışı değişikliklerini işleyin. Özellikle bu kılavuzun ilerleyen bölümlerinde açıklanan izinlerde ve uygulama bileşenleri ve gezinme davranışında açıklanan değişiklikleri göz önünde bulundurun.

Derleme dosyanızı güncelleme

Hedef SDK sürümünüzü güncellemek için modül düzeyindeki build.gradle veya build.gradle.kts dosyanızı açıp Android 13 değerlerini girerek 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ünü kullanıyorsanız uygulamanızın build.gradle veya build.gradle.kts dosyasını Android 13 için aşağıdaki değerlerle güncelleyin:

Modern

android {
    compileSdk 33
    ...
    defaultConfig {
        targetSdk 33
    }
}

Kotlin

android {
    compileSdk = 33
    ...
    defaultConfig {
        targetSdk = 33
    }
}

AGP 4.2.0 veya altı

AGP 4.2.0 veya önceki bir sürümü kullanıyorsanız uygulamanızın build.gradle veya build.gradle.kts dosyasını Android 13 için aşağıdaki değerlerle güncelleyin:

Modern

android {
    compileSdkVersion "33"
    ...
    defaultConfig {
        targetSdkVersion "33"
    }
}

Kotlin

android {
    compileSdkVersion = "33"
    ...
    defaultConfig {
        targetSdkVersion = "33"
    }
}

İzinlerde yapılan değişiklikler

Bu bölümde, Android 13'ü hedefledikten sonra uygulamaları etkileyen izinlerde yapılan çeşitli değişiklikler açıklanmaktadır.

Arka plan vücut sensörleri izni

Arka planda nabız gibi yaygın vücut sensörlerinden bilgi almak için BODY_SENSORS_BACKGROUND izni isteyin.

Vücut sensörü verilerine arka planda erişim isteme ile ilgili kılavuzdan daha fazla bilgi edinin.

Tam alarm izni

Tam alarmlar olarak da bilinen tam olarak zamanlanmış alarmları kullanmak için USE_EXACT_ALARM veya SCHEDULE_EXACT_ALARM iznini beyan etmeniz gerekir.

Uygulamanızın temel işlevleri tam alarmlara (ör. bir çalar saat veya takvim uygulaması için) bağlı olmadığı sürece, bunun yerine tam alarmsız alarm kullanın. Çoğu uygulama, tam olmayan alarm kullanarak görevleri ve etkinlikleri planlayabilir.

Tam alarm ayarlama hakkında daha fazla bilgi edinin.

Ayrıntılı medya izinleri

Uygulamanızın diğer uygulamaların oluşturduğu medya dosyalarına erişmesi gerekiyorsa READ_EXTERNAL_STORAGE izni yerine READ_MEDIA_* ile başlayan ayrıntılı medya izinleri istemeniz gerekir. Uygulamanıza daha önce READ_EXTERNAL_STORAGE izni verildiyse sistem, gerekli ayrıntılı medya izinlerini otomatik olarak verir.

Ayrıntılı medya izinleri hakkında daha fazla bilgi edinin.

Uygulama bileşenleri ve gezinmeyle ilgili değişiklikler

Bu bölümde, uygulama bileşeni ve gezinme davranışında yapılan ve Android 13'ü hedefledikten sonra uygulamaları etkileyen birkaç değişiklik listelenmektedir.

Uygulama bileşeni dışa aktarma şartları

Uygulamanızda amaç filtreleri kullanan etkinlikler, hizmetler veya yayın alıcıları varsa bu uygulama bileşenleri için android:exported özelliğini açıkça beyan etmeniz gerekir.

Daha güvenli bileşen dışa aktarma hakkında daha fazla bilgi edinin.

Beklemedeki amaçların değişkenliğini belirtin

Uygulamanızdaki her PendingIntent nesnesinin değişken mi yoksa sabit mi olduğunu belirtmeniz gerekir. Çoğu durumda, amaç içindeki verilerin bütünlüğünü korumak için sabit PendingIntent nesneleri kullanın.

Bekleyen amaçların değişkenliğini belirtme hakkında daha fazla bilgi edinin.

Ön plan hizmeti başlatma kısıtlamaları

Çoğu durumda uygulamanız arka planda çalışırken ön plan hizmetlerini başlatamaz.

Arka plandan ön plan hizmeti başlatmayla ilgili kısıtlamalar hakkında daha fazla bilgi edinin.

Bildirim trambolin kısıtlamaları

Kullanıcı bir bildirimle etkileşimde bulunduktan sonra, bir hizmet veya yayın alıcısının içinden startActivity()'i arayamazsınız. Tek işlevi bir etkinlik başlatmak olan böyle bir geçiş uygulama bileşeni, bildirim trambolini olarak bilinir.

Bildirim trambolin kısıtlamaları hakkında daha fazla bilgi edinin.