Davranış değişiklikleri: Android 16 veya sonraki sürümleri hedefleyen uygulamalar

Önceki sürümlerde olduğu gibi Android 16'da da uygulamanızı etkileyebilecek davranış değişiklikleri vardır. Aşağıdaki davranış değişiklikleri yalnızca Android 16 veya sonraki sürümleri hedefleyen uygulamalar için geçerlidir. Uygulamanız Android 16 veya sonraki sürümleri hedefliyorsa geçerli olduğu durumlarda bu davranışları destekleyecek şekilde uygulamanızı değiştirmeniz gerekir.

Uygulamanızın targetSdkVersion değerinden bağımsız olarak Android 16'da çalışan tüm uygulamaları etkileyen davranış değişiklikleri listesini de inceleyin.

Kullanıcı deneyimi ve sistem arayüzü

Android 16 (API düzeyi 36), daha tutarlı ve sezgisel bir kullanıcı deneyimi sunmak için aşağıdaki değişiklikleri içerir.

Uçtan uca kapsamı dışında kalmayı seçme seçeneği kaldırılıyor

Android 15, Android 15'i (API düzeyi 35) hedefleyen uygulamalar için uçtan uca görünümü zorunlu kıldı ancak uygulamanız R.attr#windowOptOutEdgeToEdgeEnforcement değerini true olarak ayarlayarak kapsamı dışında kalmayı seçebilir. Android 16'yı (API düzeyi 36) hedefleyen uygulamalarda R.attr#windowOptOutEdgeToEdgeEnforcement desteği sonlandırılmış ve devre dışı bırakılmıştır. Uygulamanız, uçtan uca ekran özelliğinin kapsamı dışında kalmayı seçemez.

• Uygulamanız Android 16'yı (API düzeyi 36) hedefliyorsa ve Android 15 cihazda çalışıyorsa R.attr#windowOptOutEdgeToEdgeEnforcement çalışmaya devam eder.
• Uygulamanız Android 16'yı (API düzeyi 36) hedefliyorsa ve Android 16 cihazda çalışıyorsa R.attr#windowOptOutEdgeToEdgeEnforcement devre dışı bırakılır.

Android 16'da test etmek için uygulamanızın uçtan uca ekranı desteklediğinden emin olun ve R.attr#windowOptOutEdgeToEdgeEnforcement kullanımını kaldırın. Böylece uygulamanız Android 15 cihazlarda da uçtan uca ekranı destekler. Uçtan uca ekranı desteklemek için Compose ve Görünümler kılavuzuna bakın.

Tahmin edilen geri gitme için taşıma veya kapsam dışında kalmayı seçme gerekiyor

对于以 Android 16（API 级别 36）或更高版本为目标平台且在搭载 Android 16 或更高版本的设备上运行的应用，系统会默认启用预测性返回系统动画（返回主屏幕、跨任务和跨 activity）。此外，系统不会调用 onBackPressed，也不会再分派 KeyEvent.KEYCODE_BACK。

如果您的应用会拦截返回事件，而您尚未迁移到预测性返回，请更新应用以使用受支持的返回导航 API，或在应用的 AndroidManifest.xml 文件的 <application> 或 <activity> 标记中将 android:enableOnBackInvokedCallback 属性设置为 false，以暂时停用预测性返回。

预测性返回主屏幕动画。

预测性跨 activity 动画。

预测性跨任务动画。

Zarif yazı tipi API'lerinin desteği sonlandırıldı ve devre dışı bırakıldı

Android 15'i (API düzeyi 35) hedefleyen uygulamalarda elegantTextHeight TextView özelliği varsayılan olarak true şeklinde ayarlanır. Bu sayede, kompakt yazı tipi çok daha okunabilir bir yazı tipiyle değiştirilir. elegantTextHeight özelliğini false olarak ayarlayarak bu durumu geçersiz kılabilirsiniz.

Android 16, elegantTextHeight özelliğinin desteğini sonlandırır. Uygulamanız Android 16'yı hedeflediğinde bu özellik yoksayılır. Bu API'ler tarafından kontrol edilen "UI fonts" desteği sonlandırılıyor. Bu nedenle, Arapça, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu veya Tayca dillerinde tutarlı ve gelecekte de geçerli olacak metin oluşturma için tüm düzenleri uyarlamanız gerekir.

Android 14'ü (API düzeyi 34) ve önceki sürümleri hedefleyen uygulamalarda veya elegantTextHeight özelliğini false olarak ayarlayarak varsayılan davranışı geçersiz kılan Android 15'i (API düzeyi 35) hedefleyen uygulamalarda

elegantTextHeight davranışı.

Android 16'yı (API düzeyi 36) hedefleyen uygulamalar veya elegantTextHeight özelliğini false olarak ayarlayarak varsayılanı geçersiz kılmayan Android 15'i (API düzeyi 35) hedefleyen uygulamalar için

elegantTextHeight davranışı.

Temel işlevler

Android 16 (API düzeyi 36), Android sisteminin çeşitli temel özelliklerini değiştiren veya genişleten aşağıdaki değişiklikleri içerir.

Sabit ücretli çalışma planlaması optimizasyonu

Android 16'yı hedeflemeden önce, scheduleAtFixedRate geçerli bir işlem yaşam döngüsü dışında olduğu için bir görev yürütmeyi kaçırdığında, uygulama geçerli bir yaşam döngüsüne döndüğünde tüm kaçırılan yürütmeler hemen yürütülür.

Android 16'yı hedeflerken, uygulama geçerli bir yaşam döngüsüne döndüğünde en fazla bir scheduleAtFixedRate yürütme işleminin eksikliği hemen yürütülür. Bu davranış değişikliğinin uygulama performansını iyileştirmesi bekleniyor. Uygulamanızın etkilenip etkilenmediğini kontrol etmek için uygulamanızda bu davranışı test edin. Uygulama uyumluluk çerçevesini kullanarak ve STPE_SKIP_MULTIPLE_MISSED_PERIODIC_TASKS uyumluluk işaretini etkinleştirerek de test yapabilirsiniz.

Cihaz form faktörleri

Android 16 (API düzeyi 36), büyük ekranlı cihazlarda görüntülenen uygulamalar için aşağıdaki değişiklikleri içerir.

Uyarlanabilir düzenler

Android uygulamaları artık çeşitli cihazlarda (ör. telefonlar, tabletler, katlanabilir cihazlar, masaüstü bilgisayarlar, arabalar ve TV'ler) ve büyük ekranlarda pencere modlarında (ör. bölünmüş ekran ve pencereli görüntüleme) çalıştığından, geliştiriciler cihazın yönünden bağımsız olarak her ekran ve pencere boyutuna uyum sağlayan Android uygulamaları oluşturmalıdır. Yönü ve yeniden boyutlandırılabilirliği kısıtlama gibi paradigmalar, günümüzün çok cihazlı dünyasında çok kısıtlayıcıdır.

Yön, yeniden boyutlandırılabilirlik ve en boy oranı kısıtlamalarını yoksayma

Android 16'yı (API düzeyi 36) hedefleyen uygulamalarda, en küçük genişliği 600 dp'den büyük olan ekranlarda yön, yeniden boyutlandırılabilirlik ve en-boy oranı kısıtlamaları artık geçerli değildir. Uygulamalar, en boy oranına veya kullanıcının tercih ettiği yöne bakılmaksızın tüm ekran penceresini doldurur ve dikey kenar boşluğu kullanılmaz.

Bu değişiklik, yeni bir standart platform davranışı sunar. Android, uygulamaların çeşitli yönlere, ekran boyutlarına ve en boy oranlarına uyum sağlamasının beklendiği bir modele doğru ilerliyor. Sabit yön veya sınırlı yeniden boyutlandırma gibi kısıtlamalar, uygulamanın uyarlanabilirliğini engeller. Mümkün olan en iyi kullanıcı deneyimini sunmak için uygulamanızı uyarlanabilir hale getirin.

Bu davranışı, uygulama uyumluluk çerçevesini kullanarak ve UNIVERSAL_RESIZABLE_BY_DEFAULT uyumluluk işaretini etkinleştirerek de test edebilirsiniz.

Sık karşılaşılan zarar veren değişiklikler

Yön, yeniden boyutlandırılabilirlik ve en-boy oranı kısıtlamalarının yoksayılması, uygulamanızın kullanıcı arayüzünü bazı cihazlarda etkileyebilir. Bu durum özellikle dikey yönde kilitli küçük düzenler için tasarlanmış öğeleri (ör. uzatılmış düzenler, ekran dışı animasyonlar ve bileşenler gibi sorunlar) etkileyebilir. En boy oranı veya yönle ilgili varsayımlar, uygulamanızda görsel sorunlara neden olabilir. Bu sorunları nasıl önleyeceğiniz ve uygulamanızın uyarlanabilir davranışını nasıl iyileştireceğiniz hakkında daha fazla bilgi edinin.

Cihazın döndürülmesine izin verilmesi, daha fazla etkinliğin yeniden oluşturulmasına neden olur. Bu da düzgün şekilde korunmadığı takdirde kullanıcı durumunun kaybedilmesine yol açabilir. Kullanıcı arayüzü durumunu doğru şekilde kaydetmeyi Kullanıcı arayüzü durumlarını kaydetme bölümünden öğrenebilirsiniz.

Uygulama ayrıntıları

Aşağıdaki manifest özellikleri ve çalışma zamanı API'leri, tam ekran ve çoklu pencere modlarında büyük ekranlı cihazlarda yoksayılır:

• screenOrientation
• resizableActivity
• minAspectRatio
• maxAspectRatio
• setRequestedOrientation()
• getRequestedOrientation()

screenOrientation, setRequestedOrientation() ve getRequestedOrientation() için aşağıdaki değerler yoksayılır:

• portrait
• reversePortrait
• sensorPortrait
• userPortrait
• landscape
• reverseLandscape
• sensorLandscape
• userLandscape

Ekranı yeniden boyutlandırma konusunda android:resizeableActivity="false", android:minAspectRatio ve android:maxAspectRatio'nin hiçbir etkisi yoktur.

Android 16'yı (API düzeyi 36) hedefleyen uygulamalarda, uygulama yönü, yeniden boyutlandırılabilirlik ve en-boy oranı kısıtlamaları büyük ekranlarda varsayılan olarak yoksayılır. Tam olarak hazır olmayan her uygulama, kapsam dışında kalmayı seçerek bu davranışı geçici olarak geçersiz kılabilir. Bu durumda, uyumluluk moduna yerleştirilme şeklindeki önceki davranış geçerli olur.

İstisnalar

Android 16'daki yön, yeniden boyutlandırılabilirlik ve en-boy oranı kısıtlamaları aşağıdaki durumlarda geçerli değildir:

• Oyunlar (android:appCategory işaretine göre)
• Kullanıcıların, cihazın en boy oranı ayarlarında uygulamanın varsayılan davranışını açıkça etkinleştirmesi
• sw600dp boyutundan küçük ekranlar

Geçici olarak devre dışı bırakma

Belirli bir etkinliği devre dışı bırakmak için PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY manifest özelliğini beyan edin:

<activity ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
  ...
</activity>

Uygulamanızın çok fazla bölümü Android 16'ya hazır değilse aynı özelliği uygulama düzeyinde uygulayarak tamamen devre dışı bırakabilirsiniz:

<application ...>
  <property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY" android:value="true" />
</application>

Önemli: Kapsam dışında kalmayı seçmek geçici bir işlemdir ve gelecekteki bir Android sürümünde API düzeyi 37 hedeflendiğinde geçerli olmaz. Yani API düzeyi 37'yi hedefleyen uygulamalarda yön, yeniden boyutlandırılabilirlik ve en-boy oranı kısıtlamaları en az sw600dp olan ekranlarda yoksayılır.

Sağlık ve fitness

Android 16 (API düzeyi 36), sağlık ve fitness verileriyle ilgili aşağıdaki değişiklikleri içerir.

Sağlık ve fitness izinleri

Android 16 (API düzeyi 36) veya sonraki sürümleri hedefleyen uygulamalarda BODY_SENSORS izinleri, android.permissions.health altında Health Connect'in de kullandığı daha ayrıntılı izinler kullanır. Android 16'dan itibaren, daha önce BODY_SENSORS veya BODY_SENSORS_BACKGROUND iznini gerektiren tüm API'ler artık ilgili android.permissions.health iznini gerektiriyor. Bu durum aşağıdaki veri türlerini, API'leri ve ön plan hizmet türlerini etkiler:

• Wear OS'teki Sağlık Hizmetleri'nden HEART_RATE_BPM
• Android Sensör Yöneticisi'nden Sensor.TYPE_HEART_RATE
• Wear OS'te ProtoLayout tarafından sunulan heartRateAccuracy ve heartRateBpm
• FOREGROUND_SERVICE_TYPE_HEALTH: BODY_SENSORS yerine ilgili android.permission.health izninin gerektiği durumlar

Uygulamanız bu API'leri kullanıyorsa ilgili ayrıntılı izinleri istemelidir:

• Nabız, SpO2 veya deri sıcaklığının kullanım sırasında izlenmesi için: BODY_SENSORS yerine READ_HEART_RATE gibi android.permissions.health altındaki ayrıntılı izni isteyin.
• Arka planda sensör erişimi için: BODY_SENSORS_BACKGROUND yerine READ_HEALTH_DATA_IN_BACKGROUND isteyin.

Bu izinler, sağlık, fitness ve sağlıklı yaşam verileri için Android veri deposu olan Health Connect'teki verileri okuma erişimini koruyan izinlerle aynıdır.

Mobil uygulamalar

READ_HEART_RATE ve diğer ayrıntılı izinleri kullanmaya geçiş yapan mobil uygulamaların, uygulamanın gizlilik politikasını göstermek için bir etkinlik beyan etmesi de gerekir. Bu, Health Connect ile aynı şarttır.

Önemli: Mobil uygulamalar için gerekçe sunulmaması, iznin iptal edilmesine neden olur.

Bağlantı

Android 16 (API düzeyi 36), çevre birimleriyle bağlantıyı iyileştirmek için Bluetooth yığınında aşağıdaki değişiklikleri içerir.

Bağlantı kaybını ve şifreleme değişikliklerini işlemek için yeni intent'ler

作为改进了对键值对丢失的处理的一部分，Android 16 还引入了 2 个新 intent，以便应用更好地了解键值对丢失和加密更改。

以 Android 16 为目标平台的应用现在可以：

• 在检测到远程键盘连接丢失时接收 ACTION_KEY_MISSING intent，以便提供更具信息量的用户反馈并采取适当的措施。
• 每当链接的加密状态发生变化时，都会收到 ACTION_ENCRYPTION_CHANGE intent。这包括加密状态更改、加密算法更改和加密密钥大小更改。如果应用在稍后收到 ACTION_ENCRYPTION_CHANGE intent 时成功加密了链接，则必须将该绑定视为已恢复。

适应不同的 OEM 实现

虽然 Android 16 引入了这些新 intent，但其实现和广播可能会因不同的设备制造商 (OEM) 而异。为了确保您的应用在所有设备上都能提供一致且可靠的体验，开发者应设计其绑定丢失处理机制，以妥善适应这些潜在的变化。

我们建议您采用以下应用行为：

• 如果广播 ACTION_KEY_MISSING intent：

  系统会断开 ACL（异步无连接）链接，但会保留设备的配对信息（如此处所述）。

  您的应用应将此 intent 用作检测配对丢失的主要信号，并在发起设备忘记或重新配对之前引导用户确认远程设备是否在范围内。

  如果设备在收到 ACTION_KEY_MISSING 后断开连接，您的应用应谨慎重新连接，因为设备可能已不再与系统绑定。

• 如果未广播 ACTION_KEY_MISSING intent：

  ACL 链接将保持连接状态，系统会移除设备的配对信息，与 Android 15 中的行为相同。

  在这种情况下，您的应用应继续使用与之前的 Android 版本相同的现有配对丢失处理机制，以检测和管理配对丢失事件。

Bluetooth bağlantısını kaldırmanın yeni yolu

Android 16'yı hedefleyen tüm uygulamalar artık CompanionDeviceManager'teki herkese açık bir API'yi kullanarak Bluetooth cihazlarının eşlemesini kaldırabilir. Bir tamamlayıcı cihaz CDM ilişkisi olarak yönetiliyorsa uygulama, ilişkili cihazdaki yeni removeBond(int) API'yi kullanarak Bluetooth bağını kaldırmayı tetikleyebilir. Uygulama, Bluetooth cihaz yayın etkinliğini dinleyerek ACTION_BOND_STATE_CHANGED bağ durumu değişikliklerini izleyebilir.

Güvenlik

Android 16 (API düzeyi 36), aşağıdaki güvenlik değişikliklerini içerir.

MediaStore sürümünü kilitleme

Android 16 veya sonraki sürümleri hedefleyen uygulamalarda MediaStore#getVersion() artık her uygulamaya özgü olacak. Bu sayede, kötüye kullanımı ve parmak izi teknikleri için kullanımını önlemek amacıyla sürüm dizesinden tanımlayıcı özellikler kaldırılır. Uygulamalar bu sürümün biçimiyle ilgili herhangi bir varsayıma kapılmamalıdır. Uygulamalar, bu API'yi kullanırken sürüm değişikliklerini zaten ele almalıdır. Geliştirici, bu API'nin amaçlanan kapsamının dışında ek bilgiler elde etmeye çalışmadığı sürece çoğu durumda mevcut davranışlarını değiştirmeleri gerekmez.

Daha Güvenli Intent'ler

Safer Intents özelliği, Android'in intent çözümleme mekanizmasının güvenliğini artırmak için tasarlanmış çok aşamalı bir güvenlik girişimidir. Amaç, intent işleme sırasında kontroller ekleyerek ve belirli ölçütleri karşılamayan intent'leri filtreleyerek uygulamaları kötü amaçlı eylemlerden korumaktır.

Android 15'te bu özellik, gönderen uygulamaya odaklanıyordu. Android 16'da ise kontrol, alan uygulamaya geçiyor. Böylece geliştiriciler, uygulama manifestlerini kullanarak katı intent çözümlemeyi etkinleştirebiliyor.

İki önemli değişiklik yapılıyor:

1. Belirgin Intent'ler, Hedef Bileşenin Intent Filtresiyle Eşleşmelidir: Bir Intent açıkça bir bileşeni hedefliyorsa o bileşenin Intent filtresiyle eşleşmelidir.

2. İşlem içermeyen intent'ler hiçbir intent filtresiyle eşleşemez: İşlem belirtilmeyen intent'ler hiçbir intent filtresiyle çözümlenmemelidir.

Bu değişiklikler yalnızca birden fazla uygulama söz konusu olduğunda geçerlidir ve tek bir uygulama içindeki intent işlemeyi etkilemez.

Etki

Bu özelliğin etkinleştirilmesi için geliştiricilerin uygulama manifestinde özelliği açıkça etkinleştirmesi gerekir. Bu nedenle, özelliğin etkisi yalnızca aşağıdaki geliştiricilerin uygulamalarıyla sınırlı olacaktır:

• Daha Güvenli Intent'ler özelliği ve avantajları hakkında bilgi sahibi olma
• Uygulamalarında daha katı intent işleme uygulamalarını kullanmayı etkin bir şekilde tercih etmelidir.

Bu etkinleştirme yaklaşımı, mevcut daha az güvenli intent çözümleme davranışına bağlı olabilecek mevcut uygulamaların bozulma riskini en aza indirir.

Android 16'daki ilk etki sınırlı olsa da Safer Intents girişimi, gelecekteki Android sürümlerinde daha geniş bir etki yaratacak bir yol haritasına sahiptir. Zaman içinde katı niyet çözümlemeyi varsayılan davranış hâline getirmeyi planlıyoruz.

Daha Güvenli Intent'ler özelliği, kötü amaçlı uygulamaların intent çözümleme mekanizmasındaki güvenlik açıklarından yararlanmasını zorlaştırarak Android ekosisteminin güvenliğini önemli ölçüde artırabilir.

Ancak kapsam dışında kalmayı seçme ve zorunlu yaptırıma geçiş, mevcut uygulamalarla ilgili olası uyumluluk sorunlarını gidermek için dikkatli bir şekilde yönetilmelidir.

Uygulama

Geliştiricilerin, uygulama manifestlerinde intentMatchingFlags özelliğini kullanarak daha katı intent eşlemeyi açıkça etkinleştirmeleri gerekir. Aşağıda, özelliğin tüm uygulama için etkinleştirildiği ancak bir alıcıda devre dışı bırakıldığı/kapsamı dışında kalmayı seçildiği bir örnek verilmiştir:

<application android:intentMatchingFlags="enforceIntentFilter">
    <receiver android:name=".MyBroadcastReceiver" android:exported="true" android:intentMatchingFlags="none">
        <intent-filter>
            <action android:name="com.example.MY_CUSTOM_ACTION" />
        </intent-filter>
        <intent-filter>
            <action android:name="com.example.MY_ANOTHER_CUSTOM_ACTION" />
        </intent-filter>
    </receiver>
</application>

Not: Bu özellik, <application> etiketinin yanı sıra <activity>, <activity-alias>, <receiver>, <service>, <provider> gibi bileşen etiketlerinde de belirtilebilir. Bileşendeki özellik, <application> etiketindeki özelliği geçersiz kılmak için kullanılabilir.

Desteklenen işaretler hakkında daha fazla bilgi:

İşaret Adı	Açıklama
enforceIntentFilter	Gelen intent'ler için daha katı eşleştirme uygular.
yok	Gelen amaçlar için tüm özel eşleme kurallarını devre dışı bırakır. Birden fazla işaret belirtildiğinde, çakışan değerler "none" işaretine öncelik verilerek çözülür.
allowNullAction	Eşleşme kurallarını esneterek işlem içermeyen niyetlerin eşleşmesine izin verir. Bu işaret, belirli bir davranışı elde etmek için "enforceIntentFilter" ile birlikte kullanılır.

Test ve Hata Ayıklama

Yaptırım etkin olduğunda, intent'i çağıran taraf intent'i doğru şekilde doldurmuşsa uygulamalar düzgün çalışmalıdır. Ancak engellenen intent'ler, "PackageManager." etiketiyle "Intent does not match component's intent filter:" ve "Access blocked:" gibi uyarı günlüğü mesajlarını tetikler. Bu, uygulamayı etkileyebilecek ve dikkat edilmesi gereken olası bir sorunu gösterir.

Logcat filtresi:

tag=:PackageManager & (message:"Intent does not match component's intent filter:" | message: "Access blocked:")

GPU sistem çağrısı filtreleme

Mali GPU yüzeyini sağlamlaştırmak için kullanımdan kaldırılan veya yalnızca GPU geliştirmesi için tasarlanan Mali GPU IOCTL'leri üretim derlemelerinde engellenmiştir. Ayrıca, GPU profil oluşturma için kullanılan IOCTL'ler kabuk işlemi veya hata ayıklanabilir uygulamalarla sınırlandırılmıştır. Platform düzeyindeki politika hakkında daha fazla bilgi için SAC güncellemesine bakın.

Bu değişiklik, Mali GPU'yu kullanan Pixel cihazlarda (Pixel 6-9) gerçekleşir. Arm, r54p2 sürümündeki Documentation/ioctl-categories.rst dosyasında IOCTL'lerinin resmi sınıflandırmasını sağlamıştır. Bu liste, gelecekteki sürücü sürümlerinde güncellenmeye devam edecektir.

Bu değişiklik, desteklenen grafik API'lerini (Vulkan ve OpenGL dahil) etkilemez ve geliştiricileri veya mevcut uygulamaları etkilemesi beklenmez. Streamline Performance Analyzer ve Android GPU Inspector gibi GPU profili oluşturma araçları bu durumdan etkilenmez.

Test

Aşağıdakine benzer bir SELinux reddi görüyorsanız uygulamanız bu değişiklikten etkilenmiş olabilir:

06-30 10:47:18.617 20360 20360 W roidJUnitRunner: type=1400 audit(0.0:85): avc:  denied  { ioctl }
for  path="/dev/mali0" dev="tmpfs" ino=1188 ioctlcmd=0x8023
scontext=u:r:untrusted_app_25:s0:c512,c768 tcontext=u:object_r:gpu_device:s0 tclass=chr_file
permissive=0 app=com.google.android.selinux.pts

Uygulamanızın engellenen IOCTL'leri kullanması gerekiyorsa lütfen bir hata bildiriminde bulunun ve bu bildirimi [e-mail] adresine atayın.

SSS

1. Bu politika değişikliği tüm OEM'ler için geçerli mi? Bu değişiklik isteğe bağlı olacak ancak bu sağlamlaştırma yöntemini kullanmak isteyen tüm OEM'ler tarafından kullanılabilecek. Değişikliği uygulama talimatlarını uygulama belgelerinde bulabilirsiniz.

2. Bunu uygulamak için OEM kod tabanında değişiklik yapmak zorunlu mu yoksa varsayılan olarak yeni bir AOSP sürümüyle birlikte mi geliyor? Platform düzeyindeki değişiklik, varsayılan olarak yeni bir AOSP sürümüyle birlikte sunulacak. Tedarikçiler, bu değişikliği uygulamak isterlerse kod tabanlarında etkinleştirebilirler.

3. IOCTL listesinin güncel tutulmasından SoC'ler mi sorumludur? Örneğin, cihazım ARM Mali GPU kullanıyorsa değişiklikler için ARM ile iletişime geçmem gerekir mi? Her SoC, sürücü yayınlandıktan sonra IOCTL listelerini cihaz başına güncellemelidir. Örneğin, ARM, sürücü güncellemesi yaptığında kendisine ait yayınlanmış IOCTL listesini günceller. Ancak OEM'ler, güncellemeleri SEPolicy'lerine dahil ettiklerinden ve gerektiğinde seçilen özel IOCTL'leri listelere eklediklerinden emin olmalıdır.

4. Bu değişiklik, piyasadaki tüm Pixel cihazlara otomatik olarak uygulanır mı yoksa kullanıcının bu değişikliği uygulamak için bir ayarı değiştirmesi gerekir mi? Bu değişiklik, Mali GPU'yu kullanan tüm Pixel cihazlar (Pixel 6-9) için geçerlidir. Bu değişikliğin uygulanması için kullanıcıların herhangi bir işlem yapması gerekmez.

5. Bu politikanın kullanılması çekirdek sürücüsünün performansını etkiler mi? Bu politika, GFXBench kullanılarak Mali GPU'da test edilmiş ve GPU performansında ölçülebilir bir değişiklik gözlemlenmemiştir.

6. IOCTL listesinin mevcut kullanıcı alanı ve çekirdek sürücü sürümleriyle uyumlu olması gerekli mi? Evet, izin verilen IOCTL'lerin listesi, hem kullanıcı alanı hem de çekirdek sürücüleri tarafından desteklenen IOCTL'lerle senkronize edilmelidir. Kullanıcı alanındaki veya çekirdek sürücüsündeki IOCTL'ler güncellenirse SEPolicy IOCTL listesi de buna göre güncellenmelidir.

7. ARM, IOCTL'leri "kısıtlanmış" / "enstrümantasyon" olarak sınıflandırdı ancak bazılarını üretim kullanım alanlarında kullanmak ve/veya diğerlerini reddetmek istiyoruz. Kullanıcı alanı Mali kitaplıklarının yapılandırmasına bağlı olarak, kullandıkları IOCTL'leri nasıl sınıflandıracaklarına karar vermek OEM/SoC'lerin sorumluluğundadır. Bu konuda karar vermenize yardımcı olması için ARM'nin listesini kullanabilirsiniz ancak her OEM/SoC'nin kullanım alanı farklı olabilir.

Gizlilik

Android 16 (API düzeyi 36), aşağıdaki gizlilik değişikliklerini içerir.

Yerel Ağ İzni

任何拥有 INTERNET 权限的应用都可以访问 LAN 中的设备。 这让应用可以轻松连接到本地设备，但也会带来隐私问题，例如生成用户指纹，以及推断出位置信息。

本地网络保护项目旨在通过新的运行时权限控制对本地网络的访问，从而保护用户隐私。

发布计划

此项变更将在 25Q2 和 26Q2 这两个版本之间部署。 开发者必须在 25Q2 遵循此指南并分享反馈，因为这些保护措施将在后续 Android 版本中强制执行。 此外，他们还需要根据以下指南更新依赖于隐式本地网络访问权限的场景，并为用户拒绝和撤消新权限做好准备。

影响

在当前阶段，LNP 是一项选择性启用的功能，这意味着只有选择启用该功能的应用才会受到影响。选择启用阶段的目标是让应用开发者了解其应用的哪些部分依赖于隐式本地网络访问，以便他们可以准备在下一个版本中为其设置权限保护。

如果应用使用以下方式访问用户的本地网络，则会受到影响：

• 在本地网络地址上直接或通过库使用原始套接字（例如 mDNS 或 SSDP 服务发现协议）
• 使用访问本地网络的框架级类（例如 NsdManager）

发往和来自本地网络地址的流量需要本地网络访问权限。下表列出了一些常见情况：

应用底层网络操作	需要本地网络权限
建立传出 TCP 连接	是
接受传入的 TCP 连接	是
发送 UDP 单播、多播、广播	是
接收传入的 UDP 单播、多播、广播	是

这些限制在网络栈深处实现，因此适用于所有网络 API。这包括在原生或托管代码中创建的套接字、Cronet 和 OkHttp 等网络库，以及在这些库之上实现的任何 API。尝试解析本地网络上的服务（即带有 .local 后缀的服务）需要本地网络权限。

注意： 源自需要本地网络访问权限的 Android WebView 的流量将继承宿主应用的权限状态

上述规则的例外情况：

• 如果设备的 DNS 服务器位于本地网络中，则进出该服务器（通过端口 53）的流量不需要本地网络访问权限。
• 使用输出切换器作为应用内选择器的应用不需要本地网络权限（更多指南将于 2025 年第 4 季度发布）。

注意： 许多媒体投放场景都依赖于对本地网络的访问，并且会受到此项变更的影响。不过，并非所有提供投屏功能的应用都需要请求这项新权限。25Q4 中将提供用于处理投屏场景的未来 API 和指南。

开发者指南（选择启用）

如需选择启用本地网络限制，请执行以下操作：

1. 将设备刷写到搭载 25Q2 Beta 3 或更高版本的 build。
2. 安装要测试的应用。

3. 在 adb 中切换 Appcompat 标志：

   adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>
   

4. 重启设备

现在，您的应用对本地网络的访问权限受到限制，任何访问本地网络的尝试都会导致套接字错误。如果您使用的 API 在应用进程之外执行本地网络操作（例如 NsdManager），则在选择启用阶段不会受到影响。

如需恢复访问权限，您必须向应用授予NEARBY_WIFI_DEVICES权限。

1. 确保应用在其清单中声明 NEARBY_WIFI_DEVICES 权限。
2. 依次前往设置 > 应用 > [应用名称] > 权限 > 附近的设备 > 允许。

注意： 在未来的 Android 版本中，此功能将由“附近的设备”权限组中的新权限进行保护

现在，您的应用对本地网络的访问权限应该已恢复，并且所有场景都应该像选择启用该应用之前一样正常运行。

本地网络保护强制执行后，应用网络流量将受到以下影响。

权限	出站 LAN 请求	出站/入站互联网请求	入站 LAN 请求
已授予	Works	Works	Works
未授予	最差排行榜	Works	最差排行榜

使用以下命令关闭应用兼容性标志

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

错误

每当调用套接字调用 send 或 send 变体到本地网络地址时，这些限制引起的错误都会返回给调用套接字。

错误示例：

sendto failed: EPERM (Operation not permitted)

sendto failed: ECONNABORTED (Operation not permitted)

本地网络定义

此项目中的本地网络是指利用支持广播的网络接口（例如 Wi-Fi 或以太网）的 IP 网络，但不包括移动网络 (WWAN) 或 VPN 连接。

以下网络被视为本地网络：

IPv4：

• 169.254.0.0/16 // 链路本地
• 100.64.0.0/10 // CGNAT
• 10.0.0.0/8 // RFC1918
• 172.16.0.0/12 // RFC1918
• 192.168.0.0/16 // RFC1918

IPv6：

• 链路本地
• 直接连接的路由
• 桩网络（例如 Thread）
• 多个子网（待定）

此外，多播地址（224.0.0.0/4、ff00::/8）和 IPv4 广播地址 (255.255.255.255) 也被归类为本地网络地址。

Uygulamaya ait fotoğraflar

当面向 SDK 36 或更高版本的应用在搭载 Android 16 或更高版本的设备上提示用户授予照片和视频权限时，如果用户选择限制对所选媒体的访问权限，则会在照片选择器中看到该应用拥有的所有照片。用户可以取消选择任何这些预选项，这会撤消该应用对这些照片和视频的访问权限。