Davranış değişiklikleri: Android 12'yi hedefleyen uygulamalar

Önceki sürümlerde olduğu gibi Android 12 de uygulamanızı etkileyebilecek davranış değişiklikleri içerir. Aşağıdaki davranış değişiklikleri yalnızca Android 12 veya sonraki sürümleri hedefleyen uygulamalar için geçerlidir. Uygulamanız Android 12'yi hedefliyorsa (geçerli olduğunda) uygulamanızı bu davranışları doğru şekilde destekleyecek şekilde değiştirmeniz gerekir.

Android 12'de çalışan tüm uygulamaları etkileyen davranış değişiklikleri listesini de inceleyin.

Kullanıcı deneyimi

Özel bildirimler

Android 12, tamamen özel bildirimlerin görünümünü ve davranışını değiştirir. Önceden özel bildirimler, bildirim alanının tamamını kullanabiliyor ve kendi düzen ve stillerini sağlayabiliyordu. Bu da kullanıcıların kafasını karıştırabilecek veya farklı cihazlarda düzen uyumluluğu sorunlarına neden olabilecek karşıt kalıplara yol açıyordu.

Android 12'yi hedefleyen uygulamalar için özel içerik görünümü bulunan bildirimlerde artık bildirim alanının tamamı kullanılmaz. Bunun yerine sistem standart bir şablon uygular. Bu şablon, özel bildirimlerin tüm durumlarda diğer bildirimlerle aynı dekorasyona sahip olmasını sağlar. Bildirimin simgesi, genişletme olanakları (daraltılmış durumda) ve bildirimin simgesi, uygulama adı ve daraltma seçeneği (genişletme durumunda) buna dahildir. Bu davranış, Notification.DecoratedCustomViewStyle ile neredeyse aynıdır.

Bu sayede Android 12, kullanıcılara keşfedilebilir, tanıdık bir bildirim genişletmesi sunarak tüm bildirimleri görsel olarak tutarlı ve kolay taranır.

Aşağıdaki resimde, standart şablonda özel bir bildirim gösterilmektedir:

Aşağıdaki örneklerde, özel bildirimlerin daraltılmış ve genişletilmiş durumda nasıl oluşturulacağı gösterilmektedir:

Android 12'deki değişiklik, Notification.Style özel alt sınıflarını tanımlayan veya Notification.Builder setCustomContentView(RemoteViews), setCustomBigContentView(RemoteViews) ve setCustomHeadsUpContentView(RemoteViews) yöntemlerini kullanan uygulamaları etkilemektedir.

Uygulamanızda tamamen özel bildirimler kullanılıyorsa en kısa sürede yeni şablonla test etmenizi öneririz.

1. Özel bildirim değişikliğini etkinleştirme:

   1. Yeni davranışı etkinleştirmek için uygulamanızın targetSdkVersion değerini S olarak değiştirin.
   2. Yeniden derleyin.
   3. Uygulamanızı Android 12 çalıştıran bir cihaza veya emülatöre yükleyin.

2. Özel görünümler kullanan tüm bildirimleri test edin ve gölgede beklediğiniz gibi göründüğünden emin olun. Test sırasında aşağıdaki hususları göz önünde bulundurun ve gerekli düzenlemeleri yapın:

   • Özel görünümlerin boyutları değişti. Genel olarak, özel bildirimlere izin verilen yükseklik eskisinden daha azdır. Daraltılmış durumdayken özel içeriğin maksimum yüksekliği 106 dp'den 48 dp'ye düşürülmüştür. Ayrıca, daha az yatay alan vardır.

   • Tüm bildirimler, Android 12'yi hedefleyen uygulamalar için genişletilebilir. Genellikle bu, setCustomContentView kullanıyorsanız daraltılmış ve genişletilmiş durumların tutarlı olduğundan emin olmak için setBigCustomContentView'i de kullanmanız gerektiği anlamına gelir.

   • "Uyarı" durumunun istediğiniz gibi görünmesini sağlamak için bildirim kanalının önemini "YÜKSEK" olarak ayarlayın (Ekranda açılır).

Android App Links doğrulama değişiklikleri

Android 12 veya sonraki sürümleri hedefleyen uygulamalarda sistem, Android App Links'in doğrulanma şeklinde birkaç değişiklik yapar. Bu değişiklikler, uygulama bağlama deneyiminin güvenilirliğini artırır ve uygulama geliştiricilere ile son kullanıcılara daha fazla kontrol sağlar.

Uygulamanızdaki web bağlantılarını açmak için Android App Link doğrulamasından yararlanıyorsanız Android App Link doğrulaması için amaç filtreleri eklerken doğru biçimi kullandığınızdan emin olun. Özellikle, bu intent filtrelerinin BROWSABLE kategorisini içerdiğinden ve https şemasını desteklediğinden emin olun.

Beyanlarınızın güvenilirliğini test etmek için uygulamanızın bağlantılarını manuel olarak da doğrulayabilirsiniz.

Pencere içinde pencere davranışında iyileştirmeler

Android 12'de pencere içinde pencere (PiP) modu için davranış iyileştirmeleri sunulmakta ve hem hareketle gezinme hem de öğe tabanlı gezinme için geçiş animasyonlarına yönelik önerilen kozmetik iyileştirmeler sunulmaktadır.

Daha fazla bilgi için Resim içinde resim iyileştirmeleri bölümüne bakın.

Yeniden tasarlanan Toast

Android 12'de, kısa mesaj görünümü yeniden tasarlanmıştır. Bildirimler artık iki satır metinle sınırlıdır ve metnin yanında uygulama simgesi gösterilir.

Daha fazla bilgi için Toast'lara genel bakış bölümüne bakın.

Güvenlik ve gizlilik

Yaklaşık konum

Android 12 veya sonraki sürümleri çalıştıran cihazlarda kullanıcılar uygulamanız için yaklaşık konum doğruluğu isteyebilir.

Not: Android 12'nin bazı sürümlerinde, hedef SDK sürümünden bağımsız olarak bu değişiklik her zaman uygulamanızı etkiler.

WebView'de modern SameSite çerezleri

Android'in WebView bileşeni, Google'ın Chrome tarayıcısını destekleyen açık kaynak projesi Chromium'u temel alır. Chromium, daha fazla güvenlik ve gizlilik sağlamanın yanı sıra kullanıcılara daha fazla şeffaflık ve kontrol sunmak için üçüncü taraf çerezlerinin kullanımıyla ilgili değişiklikler yaptı. Android 12'den itibaren bu değişiklikler, uygulamalar Android 12 (API düzeyi 31) veya sonraki sürümleri hedeflediğinde WebView bölümüne de dahil edilir.

Bir çerezin SameSite özelliği, herhangi bir istekle mi yoksa yalnızca aynı site istekleriyle mi gönderilebileceğini kontrol eder. Gizliliği koruyan aşağıdaki değişiklikler, üçüncü taraf çerezlerinin varsayılan olarak işlenmesini iyileştirir ve istenmeyen siteler arası paylaşıma karşı korunmaya yardımcı olur:

• SameSite özelliği olmayan çerezler SameSite=Lax olarak kabul edilir.
• SameSite=None içeren çerezler de Secure özelliğini belirtmelidir. Bu, güvenli bir bağlam gerektiği ve HTTPS üzerinden gönderilmesi gerektiği anlamına gelir.
• Bir sitenin HTTP ve HTTPS sürümleri arasındaki bağlantılar artık siteler arası istek olarak değerlendirilir. Bu nedenle, SameSite=None; Secure olarak uygun şekilde işaretlenmedikçe çerezler gönderilmez.

Geliştiriciler için genel yol, kritik kullanıcı akışlarınızdaki siteler arası çerez bağımlılıklarını tanımlamak ve SameSite özelliğinin gerektiğinde uygun değerlerle açıkça ayarlandığından emin olmaktır. Web siteleri arasında veya HTTP'den HTTPS'ye geçen aynı site gezinmelerinde çalışmasına izin verilen çerezleri açık bir şekilde belirtmeniz gerekir.

Web geliştiricileri için bu değişikliklerle ilgili kapsamlı yardım bilgileri için SameSite Cookies Explained ve SchemefulSameSite bölümlerine bakın.

Uygulamanızda SameSite davranışlarını test etme

Uygulamanız WebView kullanıyorsa veya çerez kullanan bir web sitesi ya da hizmet yönetiyorsanız akışlarınızı Android 12 WebView'de test etmenizi öneririz. Sorunlarla karşılaşırsanız yeni SameSite davranışlarını desteklemek için çerezlerinizi güncellemeniz gerekebilir.

Girişlerde ve yerleştirilmiş içeriklerde, oturum açma akışlarında, satın alma işlemlerinde ve kullanıcının güvenli olmayan bir sayfada başlayıp güvenli bir sayfaya geçtiği diğer kimlik doğrulama akışlarında sorunlar olup olmadığını kontrol edin.

Bir uygulamayı Web Görünümü ile test etmek için aşağıdaki adımlardan birini tamamlayarak test etmek istediğiniz uygulama için yeni SameSite davranışlarını etkinleştirmeniz gerekir:

• WebView devtools'de kullanıcı arayüzü işaretçisini webview-enable-modern-cookie-same-site olarak değiştirerek test cihazında SameSite davranışlarını manuel olarak etkinleştirin.

  Bu yaklaşım, Android 5.0 (API düzeyi 21) veya sonraki sürümleri (Android 12 dahil) ve WebView 89.0.4385.0 veya sonraki sürümleri çalıştıran tüm cihazlarda test yapmanıza olanak tanır.

• Uygulamanızı targetSdkVersion tarihine kadar Android 12'yi (API düzeyi 31) hedefleyecek şekilde derleyin.

  Bu yaklaşımı benimserseniz Android 12 çalıştıran bir cihaz kullanmanız gerekir.

Android'de WebView için uzaktan hata ayıklama hakkında bilgi edinmek isterseniz Android Cihazlarda Uzaktan Hata Ayıklamaya Başlama bölümüne bakın.

Diğer kaynaklar

SameSite'in modern davranışları ve Chrome ile WebView'de kullanıma sunulması hakkında daha fazla bilgi için Chromium SameSite Güncellemeleri sayfasını ziyaret edin. WebView veya Chromium'da bir hata bulursanız bunu herkese açık Chromium sorun takipçisinde bildirebilirsiniz.

Hareket sensörlerinin hız sınırlaması vardır

Uygulamanız Android 12 veya sonraki bir sürümü hedefliyorsa kullanıcılar hakkındaki hassas olabilecek bilgileri korumak için sistem, belirli hareket sensörlerinden ve konum sensörlerinden gelen verilerin yenileme hızına bir sınır uygular.

Sensör hız sınırlaması hakkında daha fazla bilgi edinin.

Uygulamayı hazırda bekletme

Android 12, Android 11'de (API düzeyi 30) kullanıma sunulan izinleri otomatik sıfırlama davranışını genişletir. Uygulamanız Android 12'yi hedefliyorsa ve kullanıcı birkaç ay boyunca uygulamanızla etkileşimde bulunmazsa sistem, verilen izinleri otomatik olarak sıfırlar ve uygulamanızı hazırda bekleme durumuna geçirir.

Uygulama kış uykusu kılavuzundan daha fazla bilgi edinebilirsiniz.

Veri erişimi denetiminde ilişkilendirme beyanı

Android 11'de (API düzeyi 30) kullanıma sunulan veri erişimi denetimi API'si, uygulamanızın kullanım alanlarına göre ilişkilendirme etiketleri oluşturmanıza olanak tanır. Bu etiketler, uygulamanızın hangi bölümünün belirli bir veri erişimi türünü gerçekleştirdiğini belirlemenizi kolaylaştırır.

Uygulamanız Android 12 veya sonraki sürümleri hedefliyorsa uygulamanızın manifest dosyasında bu ilişkilendirme etiketlerini belirtmeniz gerekir.

ADB yedekleme kısıtlaması

Android 12, gizli uygulama verilerinin korunmasına yardımcı olmak için adb backup komutunun varsayılan davranışını değiştirir. Android 12 (API düzeyi 31) veya sonraki sürümleri hedefleyen uygulamalar için kullanıcılar adb backup komutunu çalıştırdığında uygulama verileri cihazdan dışa aktarılan diğer tüm sistem verilerinden hariç tutulur.

Test veya geliştirme iş akışlarınız adb backup kullanarak uygulama verilerini kullanıyorsa artık uygulamanızın manifest dosyasında android:debuggable öğesini true olarak ayarlayarak uygulamanızın verilerini dışa aktarmayı etkinleştirebilirsiniz.

Dikkat: Uygulamanızı kullanıma sunmadan önce android:debuggable değerini false olarak ayarlayarak uygulamanızın verilerini korumaya yardımcı olun.

Daha güvenli bileşen dışa aktarma

Uygulamanız Android 12 veya sonraki sürümleri hedefliyorsa ve intent filtrelerini kullanan etkinlikler, hizmetler veya yayın alıcıları içeriyorsa bu uygulama bileşenleri için android:exported özelliğini açıkça belirtmeniz gerekir.

Uyarı: Bir etkinlik, hizmet veya yayın alıcısı intent filtreleri kullanıyorsa ve android:exported için açıkça tanımlanmış bir değeri yoksa uygulamanız Android 12 veya sonraki sürümleri çalıştıran bir cihaza yüklenemez.

Uygulama bileşeni LAUNCHER kategorisini içeriyorsa android:exported öğesini true olarak ayarlayın. Diğer çoğu durumda android:exported öğesini false değerine ayarlayın.

Aşağıdaki kod snippet'i, android:exported özelliği false olarak ayarlanmış ve intent filtresi içeren bir hizmet örneğini göstermektedir:

<service android:name="com.example.app.backgroundService"
         android:exported="false">
    <intent-filter>
        <action android:name="com.example.app.START_BACKGROUND" />
    </intent-filter>
</service>

Android Studio'da Mesajlar

Uygulamanız, intent filtreleri kullanan ancak android:exported bildirmeyen bir etkinlik, hizmet veya yayın alıcısı içeriyorsa kullandığınız Android Studio sürümüne bağlı olarak aşağıdaki uyarı mesajları gösterilir:

Android Studio 2020.3.1 Canary 11 veya sonraki sürümler

Aşağıdaki mesajlar görünür:

1. Manifest dosyanızda aşağıdaki lint uyarısı görünür:

   When using intent filters, please specify android:exported as well
   

2. Uygulamanızı derlemeye çalıştığınızda aşağıdaki derleme hatası mesajı gösterilir:

   Manifest merger failed : Apps targeting Android 12 and higher are required \
   to specify an explicit value for android:exported when the corresponding \
   component has an intent filter defined.
   

Android Studio'nun eski sürümleri

Uygulamayı yüklemeye çalışırsanız Logcat aşağıdaki hata mesajını gösterir:

Installation did not succeed.
The application could not be installed: INSTALL_FAILED_VERIFICATION_FAILURE
List of apks:
[0] '.../build/outputs/apk/debug/app-debug.apk'
Installation failed due to: 'null'

Beklemede olan intent'lerin değişkenliği

Uygulamanız Android 12'yi hedefliyorsa uygulamanızın oluşturduğu her PendingIntent nesnesinin değişkenliğini belirtmeniz gerekir. Bu ek şart, uygulamanızın güvenliğini artırır.

Beklemedeki intent değişkenliği değişikliğini test etme

Uygulamanızda değişkenlik bildirimlerinin eksik olup olmadığını belirlemek için Android Studio'da aşağıdaki lint uyarısını arayın:

Warning: Missing PendingIntent mutability flag [UnspecifiedImmutableFlag]

Güvenli olmayan intent lansmanları

Android 12 ve sonraki sürümler, platform güvenliğini iyileştirmek için güvenli olmayan niyet başlatmalarını algılayan bir hata ayıklama özelliği sunar. Sistem, güvenli olmayan bir başlatma algıladığında StrictMode ihlali gerçekleşir.

Performans

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

Android 12 veya sonraki sürümleri hedefleyen uygulamalar, birkaç özel durum hariç arka planda çalışırken ön plan hizmetlerini başlatamaz. Bir uygulama arka planda çalışırken ön plan hizmeti başlatmaya çalışırsa istisna oluşur (birkaç özel durum hariç).

Uygulamanız arka planda çalışırken hızlı çalışma planlamak ve başlatmak için WorkManager'ı kullanabilirsiniz. Kullanıcının istediği zamana duyarlı işlemleri tamamlamak için ön plan hizmetlerini tam bir alarm içinde başlatın.

Tam alarm izni

Uygulamaların sistem kaynaklarını korumasını teşvik etmek için Android 12 ve sonraki sürümleri hedefleyen ve tam alarm ayarlayan uygulamaların, sistem ayarlarındaki Özel uygulama erişimi ekranında görünen "Alarmlar ve hatırlatıcılar" özelliğine erişimi olmalıdır.

Bu özel uygulama erişimini elde etmek için manifest dosyasında SCHEDULE_EXACT_ALARM iznini isteyin.

Tam alarmlar yalnızca kullanıcılara yönelik özelliklerde kullanılmalıdır. Tam bir alarm ayarlamak için kabul edilebilir kullanım alanları hakkında daha fazla bilgi edinin.

Davranış değişikliğini devre dışı bırakma

Uygulamanızı Android 12'yi hedeflemeye hazırlarken, hata ayıklama yapılabilir derleme varyantınızda davranış değişikliğini test amacıyla geçici olarak devre dışı bırakabilirsiniz. Bunun için aşağıdaki görevlerden birini tamamlayın:

• Geliştirici seçenekleri ayar ekranında Uygulama Uyumluluğu Değişiklikleri'ni seçin. Görünen ekranda uygulamanızın adına dokunun, ardından REQUIRE_EXACT_ALARM_PERMISSION ayarını kapatın.

• Geliştirme makinenizdeki bir terminal penceresinde aşağıdaki komutu çalıştırın:

  adb shell am compat disable REQUIRE_EXACT_ALARM_PERMISSION PACKAGE_NAME
  

Bildirim atlama kısıtlamaları

Kullanıcılar bildirimlerle etkileşime geçtiğinde bazı uygulamalar, bildirim dokunmalarına yanıt olarak bir uygulama bileşeni başlatır. Bu bileşen, kullanıcının gördüğü ve etkileşime geçtiği etkinliği başlatır. Bu uygulama bileşenine bildirim trambolini adı verilir.

Android 12 veya sonraki sürümleri hedefleyen uygulamalar, uygulama performansını ve kullanıcı deneyimini iyileştirmek için bildirim trambolinleri olarak kullanılan hizmetlerden veya yayın alıcılarından etkinlik başlatamaz. Diğer bir deyişle, kullanıcı bir bildirime veya bildirimdeki işlem düğmesine dokunduktan sonra uygulamanız bir hizmet veya yayın alıcısının içinde startActivity() çağıramaz.

Uygulamanız, bildirim trampolini görevi gören bir hizmetten veya yayın alıcısından etkinlik başlatmaya çalıştığında sistem etkinliğin başlatılmasını engeller ve Logcat'te aşağıdaki mesaj görünür:

Indirect notification activity start (trampoline) from PACKAGE_NAME, \
this should be avoided for performance reasons.

Not: SYSTEM_ALERT_WINDOW iznine sahip uygulamaların bildirim trambolini kullanarak etkinlik başlatması hâlâ mümkün olsa da bu kullanıcı deneyimi kalıbından kaçınmalı ve bunun yerine PendingIntentkullanmalısınız.

Hangi uygulama bileşenlerinin bildirim trambolinleri olarak işlev gördüğünü belirleyin

Uygulamanızı test ederken bir bildirime dokunduktan sonra, hangi hizmetin veya yayın alıcısının uygulamanızda bildirim trambolini olarak işlev gördüğünü belirleyebilirsiniz. Bunu yapmak için aşağıdaki terminal komutunun çıkışına bakın:

adb shell dumpsys activity service \
  com.android.systemui/.dump.SystemUIAuxiliaryDumpService

Çıkışın bir bölümünde "NotifEngagementLog" metni bulunuyor. Bu bölümde, bildirime dokunma işleminin sonucu olarak başlayan bileşeni tanımlamak için gereken bilgiler yer alır.

Uygulamanızı güncelleme

Uygulamanız, bildirim trambolini işlevi gören bir hizmetten veya yayın alıcısından etkinlik başlatıyorsa aşağıdaki taşıma adımlarını tamamlayın:

1. Kullanıcıların bildirime dokunduktan sonra gördüğü etkinlikle ilişkili bir PendingIntent nesnesi oluşturun.
2. Bildiriminizi oluşturma işleminin bir parçası olarak, önceki adımda oluşturduğunuz PendingIntent nesnesini kullanın.

Etkinliğin kaynağını belirlemek için, örneğin günlük kaydı yapmak amacıyla bildirimi gönderirken ekstraları kullanın. Merkezi günlük kaydı için ActivityLifecycleCallbacks veya Jetpack yaşam döngüsü gözlemcileri'ni kullanın.

Davranışı açma/kapatma

Uygulamanızın hata ayıklama yapılabilir sürümünü test ederken NOTIFICATION_TRAMPOLINE_BLOCK uygulama uyumluluk işaretini kullanarak bu kısıtlamayı etkinleştirebilir ve devre dışı bırakabilirsiniz.

Yedekleme ve geri yükleme

Android 12'yi (API düzeyi 31) çalıştıran ve hedefleyen uygulamalarda yedekleme ve geri yüklemenin çalışma şeklinde değişiklikler yapılmıştır. Android yedekleme ve geri yüklemenin iki biçimi vardır:

• Bulut yedeklemeleri: Kullanıcı verileri, daha sonra bu cihazda veya yeni bir cihazda geri yüklenebilmesi için kullanıcının Google Drive'ında saklanır.
• Cihazdan cihaza (D2D) aktarımlar: Kullanıcı verileri, eski cihazından kullanıcının yeni cihazına doğrudan gönderilir (ör. kablo kullanarak).

Verilerin yedeklenmesi ve geri yüklenmesi hakkında daha fazla bilgi edinmek için Otomatik Yedekleme ile kullanıcı verilerini yedekleme ve Android Yedekleme Hizmeti ile anahtar/değer çiftlerini yedekleme başlıklı makaleleri inceleyin.

Cihazlar arası aktarım işleviyle ilgili değişiklikler

Android 12 ve sonraki sürümleri çalıştıran ve bu sürümleri hedefleyen uygulamalar için:

• XML yapılandırma mekanizmasıyla dahil etme ve hariç tutma kurallarının belirtilmesi, cihazlar arası aktarımları etkilemez ancak bulut tabanlı yedekleme ve geri yüklemeyi (ör. Google Drive yedeklemeleri) etkiler. D2D aktarımlarıyla ilgili kuralları belirtmek için sonraki bölümde açıklanan yeni yapılandırmayı kullanmanız gerekir.

• Bazı cihaz üreticilerinin cihazlarında android:allowBackup="false" belirtildiğinde Google Drive'a yapılan yedeklemeler devre dışı bırakılır ancak uygulama için cihazlar arası aktarım devre dışı bırakılmaz.

Yeni dahil etme ve hariç tutma biçimi

Android 12 ve sonraki sürümleri çalıştıran ve hedefleyen uygulamalar, XML yapılandırması için farklı bir biçim kullanır. Bu biçim, bulut yedeklemeleri ve D2D aktarımı için dahil etme ve hariç tutma kurallarını ayrı ayrı belirtmenizi zorunlu kılarak Google Drive yedekleme ile D2D aktarımı arasındaki farkı açıkça ortaya koyar.

İsteğe bağlı olarak, yedeklemeyle ilgili kuralları belirtmek için de bu özelliği kullanabilirsiniz. Bu durumda, Android 12 veya sonraki sürümleri çalıştıran cihazlarda daha önce kullanılan yapılandırma yoksayılır. Android 11 veya önceki sürümleri çalıştıran cihazlar için eski yapılandırma hâlâ gereklidir.

Not: Yeni yapılandırma biçimini kullanıyorsanız uygulamanız, Android 12 veya sonraki sürümleri çalıştıran bir cihazda çalışırken henüz Android 12'yi hedeflemeseniz bile yeni davranışı kullanacaktır.

XML biçimi değişiklikleri

Aşağıda, Android 11 ve önceki sürümlerde yedekleme ve geri yükleme yapılandırması için kullanılan biçim verilmiştir:

<full-backup-content>
    <include domain=["file" | "database" | "sharedpref" | "external" |
                     "root"] path="string"
    requireFlags=["clientSideEncryption" | "deviceToDeviceTransfer"] />
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                     "root"] path="string" />
</full-backup-content>

Aşağıda, biçimdeki değişiklikler kalın olarak gösterilmiştir.

<data-extraction-rules>
  <cloud-backup [disableIfNoEncryptionCapabilities="true|false"]>
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
  </cloud-backup>
  <device-transfer>
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
  </device-transfer>
</data-extraction-rules>

Daha fazla bilgi için Otomatik Yedekleme ile kullanıcı verilerini yedekleme kılavuzundaki ilgili bölüme bakın.

Uygulamalar için manifest işareti

Manifest dosyanızda android:dataExtractionRules özelliğini kullanarak uygulamalarınızı yeni XML yapılandırmasına yönlendirin. Yeni XML yapılandırmasını işaret ettiğinizde, Android 12 veya sonraki sürümleri çalıştıran cihazlarda eski yapılandırmayı işaret eden android:fullBackupContent özelliği yoksayılır. Aşağıdaki kod örneğinde yeni manifest dosyası girişleri gösterilmektedir:

<application
    ...
    <!-- The below attribute is ignored. -->
    android:fullBackupContent="old_config.xml"
    <!-- You can point to your new configuration using the new
         dataExtractionRules attribute . -->
    android:dataExtractionRules="new_config.xml"
    ...>
</application>

Bağlantı

Bluetooth izinleri

Android 12'de BLUETOOTH_SCAN, BLUETOOTH_ADVERTISE ve BLUETOOTH_CONNECT izinleri kullanıma sunuluyor. Bu izinler, Android 12'yi hedefleyen uygulamaların, özellikle de cihaz konumuna erişim gerektirmeyen uygulamaların Bluetooth cihazlarla etkileşime geçmesini kolaylaştırır.

Cihazınızı Android 12 veya sonraki sürümleri hedeflemeye hazırlamak için uygulamanızın mantığını güncelleyin. Eski Bluetooth izinleri grubu yerine daha modern bir Bluetooth izinleri grubu tanımlayın.

Eşler arası eş zamanlı + İnternet bağlantısı

Android 12 (API düzeyi 31) veya sonraki sürümleri hedefleyen uygulamalar için eşzamanlı eşler arası ve internet bağlantılarını destekleyen cihazlar hem eş cihazla hem de internet sağlayan birincil ağla eşzamanlı kablosuz bağlantıları sürdürebilir. Bu da kullanıcı deneyimini daha sorunsuz hale getirir. Android 11 (API düzeyi 30) veya önceki sürümleri hedefleyen uygulamalar, eş cihaza bağlanmadan önce birincil kablosuz ağın bağlantısının kesildiği eski davranışı kullanmaya devam eder.

Uyumluluk

WifiManager.getConnectionInfo(), WifiInfo değerini yalnızca tek bir ağ için döndürebilir. Bu nedenle, API'nin davranışı Android 12 ve sonraki sürümlerde aşağıdaki şekilde değiştirilmiştir:

• Yalnızca tek bir kablosuz ağ varsa WifiInfo döndürülür.
• Birden fazla kablosuz ağ varsa ve arama uygulaması eşler arası bağlantıyı tetiklediyse eş cihaza karşılık gelen WifiInfo döndürülür.
• Birden fazla kablosuz ağ varsa ve arama uygulaması eşler arası bağlantıyı tetiklemediyse internet sağlayan birincil bağlantının WifiInfo bağlantısı döndürülür.

İkili eşzamanlı kablosuz ağları destekleyen cihazlarda daha iyi bir kullanıcı deneyimi sunmak için tüm uygulamaların (özellikle de eşler arası bağlantıları tetikleyen uygulamaların) WifiManager.getConnectionInfo() çağrısından vazgeçmesini ve bunun yerine NetworkCallback'yi kaydettirmek için kullanılan NetworkRequest ile eşleşen tüm WifiInfo nesnelerini almak üzere NetworkCallback.onCapabilitiesChanged() kullanmasını öneririz. getConnectionInfo(), Android 12'den itibaren kullanımdan kaldırılmıştır.

Aşağıdaki kod örneğinde, WifiInfo öğesinin NetworkCallback içinde nasıl alınacağı gösterilmektedir:

Kotlin

val networkCallback = object : ConnectivityManager.NetworkCallback() {
  ...
  override fun onCapabilitiesChanged(
           network : Network,
           networkCapabilities : NetworkCapabilities) {
    val transportInfo = networkCapabilities.getTransportInfo()
    if (transportInfo !is WifiInfo) return
    val wifiInfo : WifiInfo = transportInfo
    ...
  }
}

Java

final NetworkCallback networkCallback = new NetworkCallback() {
  ...
  @Override
  public void onCapabilitiesChanged(
         Network network,
         NetworkCapabilities networkCapabilities) {
    final TransportInfo transportInfo = networkCapabilities.getTransportInfo();
    if (!(transportInfo instanceof WifiInfo)) return;
    final WifiInfo wifiInfo = (WifiInfo) transportInfo;
    ...
  }
  ...
};

mDNSResponder yerel API'si

Android 12, uygulamaların mDNSReplyer yerel API'sini kullanarak mDNSResponseer arka plan programı ile etkileşime girebileceği zamanı değiştirir. Önceden, bir uygulama ağda bir hizmeti kaydettiğinde ve getSystemService() yöntemini çağırdığında, uygulama henüz NsdManager yöntemi çağırmamış olsa bile sistemin NSD hizmeti mDNSReplyer arka plan programını başlatıyordu. Ardından daemon, cihazı tüm düğümler çoklu yayın gruplarına kaydetti. Bu da sistemin daha sık uyandığına ve ek güç kullandığına neden oldu. Android 12 ve sonraki sürümlerde sistem, pil kullanımını en aza indirmek için mDNSResponder daemon'ını yalnızca NSD etkinlikleri için gerektiğinde başlatır ve sonrasında durdurur.

Bu değişiklik, mDNSResponder daemon'ın ne zaman kullanılabileceğini etkilediğinden, getSystemService() yöntemi çağrıldıktan sonra mDNSResponder daemon'ın başlatılacağını varsayılan uygulamalar, sistemden mDNSResponder daemon'ın kullanılamadığını belirten mesajlar alabilir. NsdManager kullanan ve mDNSResponder yerel API'sini kullanmayan uygulamalar bu değişiklikten etkilenmez.

Tedarikçi firma kitaplıkları

Tedarikçi firma tarafından sağlanan yerel paylaşılan kitaplıklar

Uygulama Android 12'yi (API düzeyi 31) veya sonraki sürümleri hedefliyorsa silikon tedarikçileri ya da cihaz üreticileri tarafından sağlanan NDK dışı yerel paylaşılan kitaplıklara varsayılan olarak erişilemez. Kitaplıklara yalnızca <uses-native-library> etiketi kullanılarak açıkça istendiğinde erişilebilir.

Uygulama Android 11 (API düzeyi 30) veya önceki sürümleri hedefliyorsa <uses-native-library> etiketi gerekmez. Bu durumda, NDK kitaplığı olup olmadığına bakılmaksızın yerel olarak paylaşılan tüm kitaplıklara erişilebilir.

SDK dışı kısıtlamalar güncellendi

Android 12, Android geliştiricileriyle yapılan ortak çalışmaya ve en son dahili testlere dayanarak kısıtlanmış SDK dışı arayüzlerin güncellenmiş listelerini içerir. Mümkün olduğunda, SDK olmayan arayüzleri kısıtlamadan önce herkese açık alternatiflerin kullanılabildiğinden emin oluruz.

Uygulamanız Android 12'yi hedeflemiyorsa bu değişikliklerden bazıları sizi hemen etkilemeyebilir. Ancak şu anda bazı SDK olmayan arayüzleri (uygulamanızın hedef API düzeyine bağlı olarak) kullanabilirsiniz. Ancak SDK olmayan herhangi bir yöntem veya alan kullanmak her zaman uygulamanızın bozulma riski taşır.

Uygulamanızda SDK dışı arayüzlerin kullanılıp kullanılmadığını öğrenmek için uygulamanızı test edebilirsiniz. Uygulamanız SDK dışı arayüzleri kullanıyorsa SDK alternatiflerine geçiş planlamaya başlamanız gerekir. Bununla birlikte, bazı uygulamaların SDK dışı arayüzler için geçerli kullanım alanları olduğunun farkındayız. Uygulamanızdaki bir özellik için SDK dışı arayüz kullanmanın alternatifini bulamıyorsanız yeni bir herkese açık API isteğinde bulunmanız gerekir.

Android'in bu sürümündeki değişiklikler hakkında daha fazla bilgi edinmek için Android 12'deki SDK dışı arayüz kısıtlamalarında yapılan güncellemeler başlıklı makaleyi inceleyin. SDK olmayan arayüzler hakkında genel olarak daha fazla bilgi edinmek için SDK dışı arayüzlerdeki kısıtlamalar bölümüne bakın.