Perubahan perilaku: Aplikasi yang menargetkan Android 16 atau yang lebih tinggi

Seperti rilis sebelumnya, Android 16 menyertakan perubahan perilaku yang mungkin memengaruhi aplikasi Anda. Perubahan perilaku berikut ini berlaku khusus bagi aplikasi yang menargetkan Android 16 atau yang lebih tinggi. Jika aplikasi Anda menargetkan Android 16 atau yang lebih tinggi, Anda harus memodifikasi aplikasi untuk mendukung perilaku ini, jika berlaku.

Pastikan Anda juga meninjau daftar perubahan perilaku yang memengaruhi semua aplikasi yang berjalan di Android 16, terlepas dari targetSdkVersion aplikasi Anda.

Pengalaman pengguna dan UI sistem

Android 16 (level API 36) menyertakan perubahan berikut yang dimaksudkan untuk menciptakan pengalaman pengguna yang lebih konsisten dan intuitif.

Opsi tidak menggunakan layar penuh akan dihapus

Android 15 强制实行全屏显示，但您的应用可以通过将 R.attr#windowOptOutEdgeToEdgeEnforcement 设置为 true 来选择停用。对于以 Android 16（API 级别 36）为目标平台的应用，R.attr#windowOptOutEdgeToEdgeEnforcement 已被废弃并停用，并且您的应用无法选择不采用从边缘到边缘的布局。

  • 如果您的应用以 Android 16（API 级别 36）为目标平台，并且在 Android 15 设备上运行，则 R.attr#windowOptOutEdgeToEdgeEnforcement 会继续正常运行。
  • 如果您的应用以 Android 16（API 级别 36）为目标平台，并且在 Android 16 设备上运行，则 R.attr#windowOptOutEdgeToEdgeEnforcement 会被停用。

如需在 Android 16 中进行测试，请确保您的应用支持无边框设计，并移除所有 R.attr#windowOptOutEdgeToEdgeEnforcement 用法，以便您的应用在 Android 15 设备上也能支持无边框设计。如需支持从边缘到边缘的显示，请参阅 Compose 和 Views 指南。

Migrasi atau penonaktifan diperlukan untuk kembali prediktif

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

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

“返回主页”预测性返回动画。
预测性跨 activity 动画。
预测性跨任务动画。

API font elegan tidak digunakan lagi dan dinonaktifkan

以 Android 15（API 级别 35）为目标平台的应用默认将 elegantTextHeight TextView 属性设置为 true，从而将紧凑型字体替换为可读性更高的字体。您可以通过将 elegantTextHeight 属性设置为 false 来替换此设置。

Android 16 弃用了 elegantTextHeight 属性，当您的应用以 Android 16 为目标平台后，系统会忽略该属性。由这些 API 控制的“界面字体”即将停用，因此您应调整所有布局，以确保阿拉伯语、老挝语、缅甸语、泰米尔语、古吉拉特语、卡纳达语、马拉雅拉姆语、奥里亚语、泰卢固语或泰语文本的呈现效果一致且不受未来变化的影响。

针对以 Android 14（API 级别 34）及更低版本为目标平台的应用，或针对以 Android 15（API 级别 35）为目标平台且通过将 elegantTextHeight 属性设置为 false 替换默认值的应用，
elegantTextHeight 行为。
以 Android 16（API 级别 36）为目标平台的应用，或以 Android 15（API 级别 35）为目标平台但未通过将 elegantTextHeight 属性设置为 false 来替换默认值的应用，其
elegantTextHeight 行为。

Fungsi inti

Android 16 (level API 36) menyertakan perubahan berikut yang mengubah atau memperluas berbagai kemampuan inti sistem Android.

Pengoptimalan penjadwalan kerja tarif tetap

Sebelum menargetkan Android 16, saat scheduleAtFixedRate melewatkan eksekusi tugas karena berada di luar siklus proses yang valid, semua eksekusi yang terlewat akan segera dijalankan saat aplikasi kembali ke siklus proses yang valid.

Saat menargetkan Android 16, maksimal satu eksekusi yang terlewat dari scheduleAtFixedRate akan langsung dieksekusi saat aplikasi kembali ke siklus proses yang valid. Perubahan perilaku ini diharapkan dapat meningkatkan performa aplikasi. Uji perilaku ini di aplikasi Anda untuk memeriksa apakah aplikasi Anda terpengaruh. Anda juga dapat menguji dengan menggunakan framework kompatibilitas aplikasi dan mengaktifkan flag kompatibilitas STPE_SKIP_MULTIPLE_MISSED_PERIODIC_TASKS.

Faktor bentuk perangkat

Android 16 (level API 36) menyertakan perubahan berikut untuk aplikasi saat ditampilkan di perangkat layar besar.

Tata letak adaptif

Dengan aplikasi Android yang kini berjalan di berbagai perangkat (seperti ponsel, tablet, perangkat foldable, desktop, mobil, dan TV) dan mode tampilan jendela di layar besar (seperti tampilan layar terpisah dan mode jendela desktop), developer harus membuat aplikasi Android yang beradaptasi dengan ukuran layar dan jendela apa pun, terlepas dari orientasi perangkat. Paradigma seperti membatasi orientasi dan kemampuan mengubah ukuran terlalu ketat di dunia multiperangkat saat ini.

Mengabaikan batasan orientasi, kemampuan mengubah ukuran, dan rasio aspek

Untuk aplikasi yang menargetkan Android 16 (level API 36), batasan orientasi, kemampuan mengubah ukuran, dan rasio aspek tidak lagi berlaku pada layar dengan lebar terkecil >= 600 dp. Aplikasi mengisi seluruh jendela tampilan, terlepas dari rasio aspek atau orientasi pilihan pengguna, dan tidak menggunakan pillarboxing.

Perubahan ini memperkenalkan perilaku platform standar baru. Android beralih ke model yang mengharuskan aplikasi beradaptasi dengan berbagai orientasi, ukuran tampilan, dan rasio aspek. Batasan seperti orientasi tetap atau kemampuan mengubah ukuran yang terbatas menghambat kemampuan adaptasi aplikasi. Buat aplikasi Anda adaptif untuk memberikan pengalaman pengguna terbaik.

Anda juga dapat menguji perilaku ini dengan menggunakan framework kompatibilitas aplikasi dan mengaktifkan flag kompatibilitas UNIVERSAL_RESIZABLE_BY_DEFAULT.

Perubahan umum yang dapat menyebabkan gangguan

Mengabaikan batasan orientasi, pengubahan ukuran, dan rasio aspek dapat memengaruhi UI aplikasi Anda di beberapa perangkat, terutama elemen yang didesain untuk tata letak kecil yang terkunci dalam orientasi potret: misalnya, masalah seperti tata letak yang diregangkan dan animasi serta komponen di luar layar. Setiap asumsi tentang rasio aspek atau orientasi dapat menyebabkan masalah visual pada aplikasi Anda. Pelajari lebih lanjut cara menghindarinya dan meningkatkan perilaku adaptif aplikasi Anda.

Mengizinkan rotasi perangkat akan menghasilkan pembuatan ulang aktivitas yang lebih banyak, yang dapat mengakibatkan hilangnya status pengguna jika tidak dipertahankan dengan benar. Pelajari cara menyimpan status UI dengan benar di Menyimpan status UI.

Detail implementasi

Atribut manifes dan API runtime berikut diabaikan di seluruh perangkat layar besar dalam mode layar penuh dan multi-aplikasi:

Nilai berikut untuk screenOrientation, setRequestedOrientation(), dan getRequestedOrientation() diabaikan:

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

Terkait pengubahan ukuran tampilan, android:resizeableActivity="false", android:minAspectRatio, dan android:maxAspectRatio tidak akan berpengaruh.

Untuk aplikasi yang menargetkan Android 16 (level API 36), batasan orientasi, perubahan ukuran, dan rasio aspek aplikasi diabaikan di layar besar secara default. Setiap aplikasi yang belum sepenuhnya siap dapat mengganti perilaku ini untuk sementara dengan memilih tidak ikut, yang menghasilkan perilaku sebelumnya yaitu ditempatkan dalam mode kompatibilitas.

Pengecualian

Batasan orientasi, perubahan ukuran, dan rasio aspek Android 16 tidak berlaku dalam situasi berikut:

  • Game (berdasarkan bendera android:appCategory)
  • Pengguna secara eksplisit memilih untuk menggunakan perilaku default aplikasi dalam setelan rasio aspek perangkat
  • Layar yang lebih kecil dari sw600dp

Menonaktifkan sementara

Untuk memilih tidak mengaktifkan aktivitas tertentu, deklarasikan properti manifes PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY:

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

Jika terlalu banyak bagian aplikasi Anda yang belum siap untuk Android 16, Anda dapat memilih untuk tidak ikut sepenuhnya dengan menerapkan properti yang sama di tingkat aplikasi:

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

Kesehatan dan kebugaran

Android 16 (level API 36) mencakup perubahan berikut terkait data kesehatan dan kebugaran.

Izin kesehatan dan kebugaran

对于以 Android 16（API 级别 36）或更高版本为目标平台的应用， BODY_SENSORS 权限使用更精细的权限 under android.permissions.health，which Health Connect also uses。从 Android 16 开始，凡是以前需要具有 BODY_SENSORS 或 BODY_SENSORS_BACKGROUND 权限的 API，现在都需要获取相应的 android.permissions.health 权限。这会影响以下数据类型、API 和前台服务类型：

如果您的应用使用这些 API，则应请求相应的精细权限：

这些权限与保护对 Health Connect（用于存储健康、 健身和保健数据的 Android 数据存储区）中数据的读取访问权限的权限相同。

移动应用

迁移为使用 READ_HEART_RATE 和其他精细权限的移动应用还必须 声明一项 activity 以显示应用的隐私权政策。这与健康数据共享的要求相同。

Konektivitas

Android 16 (level API 36) menyertakan perubahan berikut dalam stack Bluetooth untuk meningkatkan konektivitas dengan perangkat periferal.

Maksud baru untuk menangani hilangnya koneksi dan perubahan enkripsi

作为改进了对键值对丢失的处理的一部分，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 版本相同的现有配对丢失处理机制，以检测和管理配对丢失事件。

Cara baru untuk menghapus koneksi bluetooth

Semua aplikasi yang menargetkan Android 16 kini dapat membatalkan penyambungan perangkat Bluetooth menggunakan API publik di CompanionDeviceManager. Jika perangkat pendamping dikelola sebagai pengaitan CDM, aplikasi dapat memicu penghapusan ikatan bluetooth menggunakan removeBond(int) API baru di perangkat terkait. Aplikasi dapat memantau perubahan status ikatan dengan memproses peristiwa siaran perangkat Bluetooth ACTION_BOND_STATE_CHANGED.

Keamanan

Android 16 (level API 36) menyertakan perubahan keamanan berikut.

Penguncian versi MediaStore

Untuk aplikasi yang menargetkan Android 16 atau yang lebih tinggi, MediaStore#getVersion() kini akan unik untuk setiap aplikasi. Hal ini menghilangkan properti identifikasi dari string versi untuk mencegah penyalahgunaan dan penggunaan untuk teknik sidik jari. Aplikasi tidak boleh membuat asumsi apa pun terkait format versi ini. Aplikasi seharusnya sudah menangani perubahan versi saat menggunakan API ini dan dalam sebagian besar kasus tidak perlu mengubah perilakunya saat ini, kecuali jika developer telah mencoba menyimpulkan informasi tambahan yang berada di luar cakupan API ini yang dimaksudkan.

Intent yang Lebih Aman

Fitur Safer Intents adalah inisiatif keamanan multi-fase yang dirancang untuk meningkatkan keamanan mekanisme resolusi intent Android. Tujuannya adalah melindungi aplikasi dari tindakan berbahaya dengan menambahkan pemeriksaan selama pemrosesan intent dan memfilter intent yang tidak memenuhi kriteria tertentu.

Di Android 15, fitur ini berfokus pada aplikasi pengirim. Sekarang, dengan Android 16, kontrol beralih ke aplikasi penerima, sehingga developer dapat memilih resolusi intent yang ketat menggunakan manifes aplikasi mereka.

Dua perubahan utama sedang diterapkan:

  1. Intent Eksplisit Harus Cocok dengan Filter Intent Komponen Target: Jika intent secara eksplisit menargetkan komponen, intent tersebut harus cocok dengan filter intent komponen tersebut.

  2. Intent Tanpa Tindakan Tidak Dapat Cocok dengan Filter Intent Apa Pun: Intent yang tidak memiliki tindakan yang ditentukan tidak boleh diselesaikan ke filter intent apa pun.

Perubahan ini hanya berlaku jika ada beberapa aplikasi yang terlibat dan tidak memengaruhi penanganan intent dalam satu aplikasi.

Dampak

Sifat opsional berarti developer harus mengaktifkannya secara eksplisit dalam manifes aplikasi agar dapat diterapkan. Akibatnya, dampak fitur ini akan terbatas pada aplikasi yang developernya:

  • Mengetahui fitur Safer Intents dan manfaatnya.
  • Secara aktif memilih untuk menggabungkan praktik penanganan intent yang lebih ketat ke dalam aplikasi mereka.

Pendekatan opsional ini meminimalkan risiko merusak aplikasi yang ada yang mungkin mengandalkan perilaku resolusi intent yang kurang aman saat ini.

Meskipun dampak awal di Android 16 mungkin terbatas, inisiatif Safer Intents memiliki peta rencana untuk dampak yang lebih luas dalam rilis Android mendatang. Rencananya adalah untuk akhirnya menjadikan resolusi intent yang ketat sebagai perilaku default.

Fitur Safer Intents berpotensi meningkatkan keamanan ekosistem Android secara signifikan dengan mempersulit aplikasi berbahaya untuk mengeksploitasi kerentanan dalam mekanisme resolusi intent.

Namun, transisi ke penonaktifan dan penerapan wajib harus dikelola dengan cermat untuk mengatasi potensi masalah kompatibilitas dengan aplikasi yang ada.

Penerapan

Developer harus mengaktifkan pencocokan intent yang lebih ketat secara eksplisit menggunakan atribut intentMatchingFlags dalam manifes aplikasi mereka. Berikut adalah contoh saat fitur ini bersifat opsional untuk seluruh aplikasi, tetapi dinonaktifkan/tidak diaktifkan di penerima:

<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>

Selengkapnya tentang flag yang didukung:

Nama Flag Deskripsi
enforceIntentFilter Menerapkan pencocokan yang lebih ketat untuk intent masuk
tidak ada Menonaktifkan semua aturan pencocokan khusus untuk intent masuk. Saat menentukan beberapa flag, nilai yang bertentangan akan diselesaikan dengan memberikan prioritas ke flag "none"
allowNullAction Melonggarkan aturan pencocokan untuk mengizinkan intent tanpa tindakan agar cocok. Flag ini akan digunakan bersama dengan "enforceIntentFilter" untuk mencapai perilaku tertentu

Pengujian dan Proses Debug

Saat penerapan aktif, aplikasi akan berfungsi dengan benar jika pemanggil intent telah mengisi intent dengan benar. Namun, intent yang diblokir akan memicu pesan log peringatan seperti "Intent does not match component's intent filter:" dan "Access blocked:" dengan tag "PackageManager." Hal ini menunjukkan potensi masalah yang dapat memengaruhi aplikasi dan memerlukan perhatian.

Filter Logcat:

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

Pemfilteran syscall GPU

为了加固 Mali GPU Surface，我们已在生产版本中屏蔽了已废弃或仅用于 GPU 开发的 Mali GPU IOCTL。 此外，用于 GPU 性能剖析的 IOCTL 已限制为 shell 进程或可调试的应用。如需详细了解平台级政策，请参阅 SAC 更新。

此项变更适用于使用 Mali GPU 的 Pixel 设备（Pixel 6-9）。Arm 已在其 r54p2 release 版本的 Documentation/ioctl-categories.rst 中提供了 IOCTL 的官方分类。此列表将在未来的驱动程序版本中继续维护。

此项变更不会影响受支持的图形 API（包括 Vulkan 和 OpenGL），预计也不会影响开发者或现有应用。 Streamline Performance Analyzer 和 Android GPU 检查器等 GPU 性能剖析工具不会受到影响。

测试

如果您看到类似以下内容的 SELinux 拒绝，则您的应用很可能受到了此项变更的影响：

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

如果您的应用需要使用被屏蔽的 IOCTL，请提交 bug 并将其分配给 android-partner-security@google.com。

常见问题解答

  1. 此项政策变更是否适用于所有 OEM？ 此项变更将采用选择启用模式，但任何想要使用此加固方法的原始设备制造商(OEM)都可以使用。如需了解如何实现此项变更，请参阅实现文档。

  2. 是否必须在 OEM 代码库中进行更改才能实现此项变更，还是默认随新的 AOSP 版本提供？ 平台级变更将默认随新的 AOSP 版本提供。供应商可以选择在其代码库中启用此项变更，以便应用此项变更。

  3. SoC 是否负责让 IOCTL 列表保持最新状态？例如，如果我的设备使用 ARM Mali GPU，我是否需要就任何变更与 ARM 联系？ 各个 SoC 必须在驱动程序发布后根据设备更新其 IOCTL 列表。 例如，ARM 会在驱动程序更新后更新其发布的 IOCTL 列表。 不过，OEM 应确保将更新纳入其 SEPolicy，并根据需要将任何选定的自定义 IOCTL 添加到列表中。

  4. 此项变更是否会自动应用于所有在售 Pixel 设备，还是需要用户执行操作来切换某些内容以应用此项变更？ 此项变更适用于所有使用 Mali GPU 的在售 Pixel 设备（Pixel 6-9）。无需用户执行任何操作即可应用此项变更。

  5. 使用此政策是否会影响内核驱动程序的性能？ 我们已使用 GFXBench 在 Mali GPU 上对此政策进行了测试，未观察到 GPU 性能发生任何可衡量的变化。

  6. IOCTL 列表是否需要与当前的用户空间和内核驱动程序版本保持一致？是，允许的 IOCTL 列表必须与用户空间和内核驱动程序支持的 IOCTL 同步。如果用户空间或内核驱动程序中的 IOCTL 发生更新，则必须更新 SEPolicy IOCTL 列表以进行匹配。

  7. ARM 已将 IOCTL 分类为“受限”/“检测”，但我们希望在生产用例中使用其中的一些 IOCTL，并/或拒绝其他 IOCTL。 各个 OEM/SoC 负责根据其用户空间 Mali 库的配置，决定如何对其使用的 IOCTL 进行分类。 ARM 的列表可用于帮助决定这些内容，但每个 OEM/SoC 的用例可能有所不同。

Privasi

Android 16 (level API 36) menyertakan perubahan privasi berikut.

Izin Jaringan Lokal

Perangkat di LAN dapat diakses oleh aplikasi apa pun yang memiliki izin INTERNET. Hal ini memudahkan aplikasi terhubung ke perangkat lokal, tetapi juga memiliki implikasi privasi seperti membentuk sidik jari pengguna, dan menjadi proxy untuk lokasi.

Project Perlindungan Jaringan Lokal bertujuan melindungi privasi pengguna dengan membatasi akses ke jaringan lokal menggunakan izin runtime baru.

Rencana rilis

Perubahan ini akan di-deploy antara dua rilis, 25Q2 dan 26Q2 masing-masing. Developer harus mengikuti panduan ini untuk 25Q2 dan memberikan masukan karena perlindungan ini akan diterapkan pada rilis Android mendatang. Selain itu, mereka harus memperbarui skenario yang bergantung pada akses jaringan lokal implisit dengan menggunakan panduan berikut dan bersiap menghadapi penolakan dan pencabutan izin baru oleh pengguna.

Dampak

Pada tahap saat ini, LNP adalah fitur keikutsertaan yang berarti hanya aplikasi yang memilih untuk menggunakan fitur ini yang akan terpengaruh. Tujuan fase keikutsertaan adalah agar developer aplikasi memahami bagian aplikasi mereka yang bergantung pada akses jaringan lokal implisit sehingga mereka dapat bersiap untuk melindungi izinnya pada rilis berikutnya.

Aplikasi akan terpengaruh jika mengakses jaringan lokal pengguna menggunakan:

  • Penggunaan soket mentah secara langsung atau library pada alamat jaringan lokal (misalnya, protokol penemuan layanan mDNS atau SSDP)
  • Penggunaan class tingkat framework yang mengakses jaringan lokal (misalnya, NsdManager)

Traffic ke dan dari alamat jaringan lokal memerlukan izin akses jaringan lokal. Tabel berikut mencantumkan beberapa kasus umum:

Operasi Jaringan Tingkat Rendah Aplikasi Izin Jaringan Lokal Diperlukan
Membuat koneksi TCP keluar ya
Menerima koneksi TCP masuk ya
Mengirim unicast, multicast, siaran UDP ya
Menerima unicast, multicast, siaran UDP masuk ya

Pembatasan ini diterapkan jauh di dalam stack jaringan, sehingga berlaku untuk semua API jaringan. Hal ini mencakup soket yang dibuat dalam kode native atau terkelola, library jaringan seperti Cronet dan OkHttp, serta API apa pun yang diimplementasikan di atasnya. Mencoba menyelesaikan layanan di jaringan lokal (yaitu, yang memiliki sufiks .local) akan memerlukan izin jaringan lokal.

Pengecualian untuk aturan di atas:

  • Jika server DNS perangkat berada di jaringan lokal, traffic ke atau dari server tersebut (di port 53) tidak memerlukan izin akses jaringan lokal.
  • Aplikasi yang menggunakan Output Switcher sebagai pemilih dalam aplikasi tidak memerlukan izin jaringan lokal (panduan lebih lanjut akan tersedia pada Kuartal 4 2025).

Panduan Developer (Keikutsertaan)

Untuk mengaktifkan pembatasan jaringan lokal, lakukan langkah-langkah berikut:

  1. Lakukan flash perangkat ke build dengan 25Q2 Beta 3 atau yang lebih baru.
  2. Instal aplikasi yang akan diuji.

  3. Alihkan flag Appcompat di adb:

    adb shell am compat enable RESTRICT_LOCAL_NETWORK <package_name>

  4. Mulai Ulang Perangkat

Sekarang akses aplikasi Anda ke jaringan lokal dibatasi dan setiap upaya untuk mengakses jaringan lokal akan menyebabkan error soket. Jika Anda menggunakan API yang melakukan operasi jaringan lokal di luar proses aplikasi Anda (misalnya: NsdManager), API tersebut tidak akan terpengaruh selama fase keikutsertaan.

Untuk memulihkan akses, Anda harus memberikan izin aplikasi Anda untuk NEARBY_WIFI_DEVICES.

  1. Pastikan aplikasi mendeklarasikan izin NEARBY_WIFI_DEVICES dalam manifesnya.
  2. Buka Setelan > Aplikasi > [Nama Aplikasi] > Izin > Perangkat di sekitar > Izinkan.

Sekarang, akses aplikasi Anda ke jaringan lokal akan dipulihkan dan semua skenario Anda akan berfungsi seperti sebelum mengikutsertakan aplikasi.

Setelah penegakan perlindungan jaringan lokal dimulai, berikut dampak traffic jaringan aplikasi.

Izin Permintaan LAN Keluar Permintaan Internet Keluar/Masuk Permintaan LAN Masuk
Diberikan YouTube YouTube YouTube
Tidak Diberikan Gagal YouTube Gagal

Gunakan perintah berikut untuk menonaktifkan flag App-Compat

adb shell am compat disable RESTRICT_LOCAL_NETWORK <package_name>

Error

Error yang timbul dari batasan ini akan dikembalikan ke soket panggilan setiap kali soket memanggil send atau varian send ke alamat jaringan lokal.

Contoh error:

sendto failed: EPERM (Operation not permitted)

sendto failed: ECONNABORTED (Operation not permitted)

Definisi Jaringan Lokal

Jaringan lokal dalam project ini mengacu pada jaringan IP yang menggunakan antarmuka jaringan yang mendukung siaran, seperti Wi-Fi atau Ethernet, tetapi tidak termasuk koneksi seluler (WWAN) atau VPN.

Berikut ini dianggap sebagai jaringan lokal:

IPv4:

  • 169.254.0.0/16 // Link Lokal
  • 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:

  • Link-local
  • Rute yang terhubung langsung
  • Jaringan stub seperti Thread
  • Beberapa subnet (TBD)

Selain itu, alamat multicast (224.0.0.0/4, ff00::/8) dan alamat siaran IPv4 (255.255.255.255) diklasifikasikan sebagai alamat jaringan lokal.

Foto milik aplikasi

Saat diminta untuk memberikan izin foto dan video oleh aplikasi yang menargetkan SDK 36 atau yang lebih tinggi di perangkat yang menjalankan Android 16 atau yang lebih tinggi, pengguna yang memilih untuk membatasi akses ke media yang dipilih akan melihat foto apa pun yang dimiliki oleh aplikasi yang telah dipilih sebelumnya di pemilih foto. Pengguna dapat membatalkan pilihan salah satu item yang telah dipilih sebelumnya, yang akan mencabut akses aplikasi ke foto dan video tersebut.