Android 13 平台包含可能對應用程式造成影響的行為變更。無論 targetSdkVersion
為何,當應用程式在 Android 13 上執行時,下列行為變更將會套用至所有應用程式。您應測試應用程式,並視需要修改,以便在適當情況下支援新版本功能。
另請務必查看只會影響指定 Android 13 版本應用程式的行為變更清單。
效能和電池
工作管理員
從 Android 13 (API 級別 33) 開始,使用者可以透過通知導覽匣完成工作流程,停止提供持續性前景服務的應用程式,如圖 1 所示。這種預設用途稱為工作管理員。應用程式必須能夠處理使用者啟動的停止事件。
使用 JobScheduler 改善預先擷取工作的處理方式
JobScheduler 可讓應用程式將特定工作標示為「預先擷取」工作 (使用 JobInfo.Builder.setPrefetch()
),這表示在理想情況下,這些工作應在下次啟動應用程式之前或之前執行,藉此改善使用者體驗。過去,JobScheduler 只使用信號,可讓預先擷取工作適時使用免費或超量的資料。
在 Android 13 (API 級別 33) 以上版本中,系統會嘗試判斷應用程式下次啟動時,並使用該預估值執行預先擷取工作。應用程式應嘗試針對想在下次應用程式啟動前完成的工作,使用預先擷取工作。
電池資源使用率
Android 13 (API 級別 33) 提供以下方式可讓系統更妥善地管理裝置電池續航力:
- 更新系統將應用程式排入「受限制」應用程式待命值區的時間規則。
- 當使用者將應用程式設為「受限制」狀態,用於背景電池用量時,應用程式可以執行的新限制。
利用這些變更測試應用程式時,請務必檢查下列事項:
測試應用程式在系統將其排入「受限制」應用程式待命值區時的回應方式。請使用下列 Android Debug Bridge (ADB) 指令,將應用程式指派給這個值區:
adb shell am set-standby-bucket PACKAGE_NAME restricted
針對處於背景電池用量處於「受限制」狀態的應用程式,測試應用程式如何回應下列常見限制:
- 無法啟動前景服務
- 現有前景服務會從前景移除
- 無法觸發鬧鐘
- 無法執行工作
請使用以下 ADB 指令,將應用程式設為「受限制」狀態:
adb shell cmd appops set PACKAGE_NAME RUN_ANY_IN_BACKGROUND ignore
高優先順序 Firebase 雲端訊息 (FCM) 配額
Android 13 (API 級別 33) 會更新 Firebase 雲端通訊 (FCM) 配額,針對針對高優先順序 FCM 顯示通知的應用程式,提供高優先順序 FCM 傳送服務的可靠性。在 Android 13 (API 級別 33) 中已變更下列內容:
- 應用程式待命值區將不再決定應用程式可使用的高優先順序 FCM。
- 高優先順序 FCM 配額會根據使用者回應高優先順序 FCM 的通知數量,按比例調整。
與先前的 Android 版本一樣,高優先順序 FCM 超過配額上限後,系統會將其降級為一般優先順序。為因應 FCM 而啟動前景服務 (FGS) 時,建議您檢查 RemoteMessage.getPriority()
的結果,確認其為 PRIORITY_HIGH
和/或處理任何可能的 ForegroundServiceStartNotAllowedException
例外狀況。
如果您的應用程式不一定會因應高優先順序 FCM 而發布通知,建議您將這些 FCM 的優先順序變更為「一般」,以免發生通知的訊息降級。
隱私權
通知的執行階段權限
Android 13 (API 級別 33) 推出了執行階段通知權限:POST_NOTIFICATIONS
。這項變更可協助使用者關注自己最重視的通知。
我們強烈建議您盡快指定 Android 13 以上版本,才能享有這項功能的額外控管功能和彈性。
進一步瞭解應用程式權限最佳做法。
隱藏剪貼簿中的機密內容
如果應用程式允許使用者將敏感內容 (例如密碼或信用卡資訊) 複製到剪貼簿,您必須在呼叫 ClipboardManager#setPrimaryClip()
前,先在 ClipData 的 ClipDescription
中加上標記。加入此標記可避免敏感內容出現在內容預覽畫面中。
如要為敏感內容加上標記,請在 ClipDescription
中新增布林值附加項目。無論目標 API 級別為何,所有應用程式都必須執行這項作業。
// When your app is compiled with the API level 33 SDK or higher
clipData.apply {
description.extras = PersistableBundle().apply {
putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true)
}
}
// If your app is compiled with a lower SDK
clipData.apply {
description.extras = PersistableBundle().apply {
putBoolean("android.content.extra.IS_SENSITIVE", true)
}
}
如要進一步瞭解新的剪貼簿 UI,請參閱「複製及貼上」功能頁面。
安全性
捨棄共用使用者 ID
如果應用程式使用已淘汰的 android:sharedUserId
屬性,且不再依賴該屬性的功能,您可以將 android:sharedUserMaxSdkVersion
屬性設為 32
,如以下程式碼片段所示:
<manifest ...> <!-- To maintain backward compatibility, continue to use "android:sharedUserId" if you already added it to your manifest. --> android:sharedUserId="SHARED_PACKAGE_NAME" android:sharedUserMaxSdkVersion="32" ... </manifest>
這項屬性會告知系統應用程式不再依賴共用使用者 ID。如果應用程式宣告 android:sharedUserMaxSdkVersion
,且新安裝在搭載 Android 13 以上版本的裝置上,應用程式會視為您從未定義 android:sharedUserId
。更新後的應用程式仍會使用現有的共用使用者 ID。
共用使用者 ID 會在套件管理員中造成非確定性的行為。應用程式應改用適當的通訊機制 (例如服務和內容供應器),以促進共用元件之間的互通性。
使用者體驗
關閉的前景服務通知
在搭載 Android 13 以上版本的裝置上,根據預設,使用者可以關閉與前景服務相關的通知。
核心功能
已移除舊版語音服務實作項目
Android 13 從 Google 應用程式中移除 SpeechService
實作項目,包括語音 IME、RecognitionService
和意圖型 API。
在 Android 12 中,發生下列變更:
SpeechService
功能已遷移至 Google 語音服務應用程式,成為預設的SpeechService
提供者。RecognitionService
功能已移至 Android System Intelligence 應用程式,以便支援裝置端語音辨識功能。
為維護 Android 12 的應用程式相容性,Google 應用程式會透過 Trampoline 將流量導向 Google 語音服務應用程式。在 Android 13 中,這個 Trampoline 已移除。
應用程式應使用裝置的預設供應器 SpeechService
,而不是為特定應用程式進行硬式編碼。