Android 13 新特性及適配指南-有解無憂

Android13 Logo

Android 13（API 33）于 2022年8月15日 正式發布（發布時間較往年早了一些），正式版Release源代碼也于當日被推送到AOSP Android開源專案，
GoogleSource Android13_r3 20220815
截止到筆者撰寫這篇文章時，國內部分應用軟體開發廠商已逐步接到手機廠商（華米OV等）的新版本適配要求，當前，對于Android應用開發者來說，Android 13 的軟體兼容適配已需提上作業日程，

為了貼合這篇文章的標題，本篇文章結合Android Developer官方檔案，圍繞Android13適配點與Android13新特性兩個方面進行詳細說明，

適配點：

細分媒體權限：
將 READ_EXTERNAL_STORAGE 細分為IAMGES、VIDEO、AUDIO權限
（若設定 targetSdk>=33 則此項必需適配！）
WebView調整：
廢棄setAppCacheEnabled與setForceDark方法；
（若設定 targetSdk>=33 則此項必需適配！）
靜態廣播注冊：
注冊靜態廣播時，需設定對其他應用的可見性
（若設定 targetSdk>=33 則此項必需適配！）
通知權限：
新增運行時通知權限：POST_NOTIFICATIONS
（若設定 targetSdk>=33 則此項必需適配！）
Wi-Fi ：
新增 NEARBY_WIFI_DEVICES 運行時權限
（若設定 targetSdk>=33 則此項必需適配！）
身體傳感器后臺權限：
新增 BODY_SENSORS_BACKGROUND 運行時權限
（若設定 targetSdk>=33 則此項必需適配！）
剪切板內容隱藏：
新增內容隱藏API
（根據業務需求，選擇性適配！）
非 SDK 介面的限制
（若設定 targetSdk>=33 則此項必需適配！）

新特性：

前臺服務管理器：
系統新增前臺服務管理器
（系統新特性無需適配！）

一、細分媒體權限

從Android 13開始，以Android13（API 33+）為目標平臺的應用，系統新增運行時權限READ_MEDIA_IAMGES、READ_MEDIA_VIDEO、READ_MEDIA_AUDIO 替代原有的READ_EXTERNAL_STORAGE權限，

權限	權限說明
READ_MEDIA_IAMGES	圖片權限
READ_MEDIA_VIDEO	視頻權限
READ_MEDIA_AUDIO	音頻權限

新增細分的媒體權限說明

當應用升級到targetSdk>=33時：

已授權READ_EXTERNAL_STORAGE權限的應用：系統將自動賦予對應的細化權限，
未授權仍請求READ_EXTERNAL_STORAGE權限：親測系統將不會授予任何權限，

細分媒體權限動態申請彈窗樣式：

如果同時請求 READ_MEDIA_IMAGES 和 READ_MEDIA_VIDEO 權限，系統將會提示如下權限彈窗：
如果請求 READ_MEDIA_AUDIO 權限，系統將提示如下彈窗：

官方參考：
Android Developer 細分媒體權限：
https://developer.android.google.cn/about/versions/13/behavior-changes-13

二、WebView

從Android 13開始，以Android13（API 33+）為目標平臺的應用，WebView存在以下方法與API調整：

WebSettings.setAppCacheEnabled() 方法廢棄，
WebSettings.setForceDark() 方法廢棄，

2.1 setAppCacheEnabled 廢棄

WebView 95+版本不再支持 setAppCacheEnabled
WebSettings.setAppCacheEnabled()方法廢棄

Chrome 85+版本不再支持AppCache
Chrome 85+版本不再支持AppCache

2.2 setForceDark 廢棄

從Android 13開始以Android13（API 33+）為目標平臺的應用，系統會根據應用的主題屬性isLightTheme，自動設定WebView的淺色或深色主題樣式（系統會根據 isLightTheme 來設定 prefers-color-scheme），同時，開發者Webview設定主題樣式相關API WebSettings.setForceDark() 方法將被廢棄，
基于以上更改：

若開發者仍需自定義Webview主題顏色，可以使用：
WebSettings.setAlgorithmicDarkeningAllowed()或WebSettingsCompat.setAlgorithmicDarkeningAllowed()方法，
若開發者仍然使用WebSettings.setForceDark()系統將提示錯誤：

W/cr_WebSettings: setForceDark() is a no-op in an app with targetSdkVersion>=T

官方參考：
Android Developer 靜態廣播注冊官方介紹：
https://developer.android.google.cn/about/versions/13/behavior-changes-13

三、靜態廣播注冊

從Android 13開始，以Android13（API 33+）為目標平臺的應用，注冊靜態廣播時，需設定對其他應用的可見性：

若對其他應用可見，廣播注冊時設定：Context.RECEIVER_EXPORTED
若僅應用內使用，廣播注冊時設定：Context.RECEIVER_NOT_EXPORTED

private void registerTestReceiver() {
    IntentFilter filter = new IntentFilter();
    filter.addAction("com.xiaxl.test.action");
    // api >= 33
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        // 跨應用間使用
        MainActivity.this.registerReceiver(mTestReceiver, filter, Context.RECEIVER_EXPORTED);
        // 應用內使用
        //MainActivity.this.registerReceiver(mTestReceiver, filter, Context.RECEIVER_EXPORTED);
    }
    // api <= 32
    else {
        MainActivity.this.registerReceiver(mTestReceiver, filter);
    }
}

官方參考：
Android Developer 靜態廣播注冊官方介紹：
https://developer.android.google.cn/about/versions/13/features#java

四、通知權限

Android 13 引入了一種新的運行時通知權限：POST_NOTIFICATIONS，
POST_NOTIFICATIONS 權限級別被定義為dangerous 開發者使用該權限時需動態申請，等待用戶主動授權：
通知運行時權限

對于以Android13（API 33+）為目標平臺的應用：
在顯示Android通知欄時，一方面需要在AndroidManifest中宣告 android.permission.POST_NOTIFICATION，另一方面代碼中需動態申請該通知欄權限，

<!-- AndroidManifest權限宣告 -->
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.xiaxl.test">
	
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
</manifest>


// Java代碼動態申請POST_NOTIFICATIONS權限
if (Build.VERSION.SDK_INT >= 33) {
    int checkPermission =
            ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.POST_NOTIFICATIONS);
    if (checkPermission != PackageManager.PERMISSION_GRANTED) {
        //動態申請
        ActivityCompat.requestPermissions(MainActivity.this, new String[]{
                Manifest.permission.POST_NOTIFICATIONS}, PERMISSION_REQUEST_CODE);
    } else {
        //showRecordNotification();
    }
} else {
    //showRecordNotification();
}

POST_NOTIFICATIONS 動態授權申請彈窗如下圖所示：
POST_NOTIFICATIONS動態授權彈窗

對于以Android12（API 32-）為目標平臺的應用：
對于以API 32-為目標平臺的應用，運行在Android13及以上設備中時，當應用第一次顯示通知時，系統會自動彈出以下提示框，要求用戶動態授權，

以Android12（API 32-）為目標平臺的應用，首次顯示通知時，彈窗提醒

官方參考：
Android Developer 通知運行時權限官方介紹：
https://developer.android.google.cn/guide/topics/ui/notifiers/notification-permission

五、Wi-Fi 權限

從Android 13開始，Android系統新增了NEARBY_WIFI_DEVICES權限，將原有的ACCESS_FINE_LOCATION權限與 Wi-Fi能力使用進行了區分（避免早先開發者使用Wi-Fi能力時，需要請求用戶位置權限，從而引起用戶的歧義），

NEARBY_WIFI_DEVICES權限

從Android 13開始，開發者只要不通過Wi-Fi推導用戶的物理位置將無需再請求 ACCESS_FINE_LOCATION 權限，同時官方總結了新增權限NEARBY_WIFI_DEVICES的如下使用場景：

NEARBY_WIFI_DEVICES權限使用場景

官方參考：
Android Developer NEARBY_WIFI_DEVICES：
https://developer.android.google.cn/reference/android/Manifest.permission#NEARBY_WIFI_DEVICES

六、剪切板內容隱藏

從Android 13（API 33）開始，Android剪切板新增了一項新API：
Android 13（API 33）開始，用戶可以選擇使用API PersistableBundle#(ClipDescription.EXTRA_IS_SENSITIVE, true)隱藏要復制到剪切板的用戶賬戶、密碼登敏感資訊，

相關API使用舉例如下：

private void addData2Clipboard() {
    ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
    ClipData clipData = https://www.cnblogs.com/xiaxveliang/p/ClipData.newPlainText("111111", "我是密碼");
    ClipDescription description = clipData.getDescription();
    // 隱私內容：剪切板加密
    PersistableBundle persistableBundle = new PersistableBundle();
    if (Build.VERSION.SDK_INT >= 33) {
        persistableBundle.putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true);
    } else {
        persistableBundle.putBoolean("android.content.extra.IS_SENSITIVE", true);
    }
    description.setExtras(persistableBundle);
    // 剪切板添加加密內容
    clipboardManager.setPrimaryClip(clipData);
}

不使用新API與使用新API隱藏敏感資訊，剪切板前后對比如下所示：

剪切板內容隱藏API使用效果

七、身體傳感器后臺權限

從Android 13開始，以Android13（API 33+）為目標平臺的應用，在后臺訪問身體傳感器（例如心率、體溫和血氧飽和度）時，除了需要請求現有的 BODY_SENSORS 權限外，還需要請求 BODY_SENSORS_BACKGROUND 權限，

身體傳感器后臺權限

官方參考：
Android Developer BODY_SENSORS_BACKGROUND：
https://developer.android.google.cn/reference/android/Manifest.permission#BODY_SENSORS_BACKGROUND

八、非 SDK 介面限制

官方從 Android 9（API 級別 28）開始，逐步開始對應用使用的非 SDK 介面實施了限制，
如果你的APP通過參考非 SDK 介面或嘗試使用反射或 JNI 來獲取句柄，這些限制就會起作用，官方給出的解釋是為了提升用戶體驗、降低應用崩潰風險，

8.1、非SDK介面檢測工具

官方給出了一個檢測工具，下載地址：veridex
https://android.googlesource.com/platform/prebuilts/runtime/+archive/master/appcompat.tar.gz

veridex使用方法：

appcompat.sh --dex-file=apk.apk

veridex檢測截圖

8.2、blacklist、greylist、greylist-max-o、greylist-max-p含義

以上截圖中，blacklist、greylist、greylist-max-o、greylist-max-p含義如下：

blacklist 黑名單：禁止使用的非SDK介面，運行時直接Crash（因此必須解決）
greylist 灰名單：即當前版本仍能使用的非SDK介面，但在下一版本中可能變成被限制的非SDK介面
greylist-max-o：在targetSDK<=O中能使用，但是在targetSDK>=P中被禁止使用的非SDK介面
greylist-max-p：在targetSDK<=P中能使用，但是在targetSDK>=Q中被禁止使用的非SDK介面

官方參考：
Android Developer 非SDK介面限制：
https://developer.android.google.cn/guide/app-compatibility/restrictions-non-sdk-interfaces#test-for-non-sdk

九、前臺服務管理器

從Android 13（API 33）開始，Android通知欄中新增了一項新特性：
用戶可以選擇在通知欄中通過“前臺服務管理器”，對“正在運行的前臺服務”進行停止操作，

前臺服務管理器

參考

Android Developer：Andoid13
https://developer.android.google.cn/about/versions/13

AOSP：Android13版本說明
https://source.android.google.cn/docs/setup/start/android-13-release

GoogleSource：Android13_r3
https://android.googlesource.com/platform/build/+/refs/tags/android-13.0.0_r4

= THE END =

文章首發于公眾號”CODING技術小館“，如果文章對您有幫助，歡迎關注我的公眾號，

轉載請註明出處，本文鏈接：https://www.uj5u.com/yidong/519203.html

標籤：Android

上一篇：如何規范App廣告的隱私獲取，讓用戶擁有更多知情權？

下一篇：使用SDLocalize高效完成iOS本地化國際化作業