行為變更：所有應用程式

Android 13 平台包含可能對應用程式造成影響的行為變更。無論 targetSdkVersion 為何，當應用程式在 Android 13 上執行時，下列行為變更將會套用至所有應用程式。您應測試應用程式，並視需要修改，以便在適當情況下支援新版本功能。

另請務必查看僅對指定 Android 13 為目標版本的應用程式造成影響的行為變更清單。

效能和電池

工作管理員

通知面板底部有一個按鈕，可顯示目前在背景執行的應用程式數量。按下這個按鈕時，系統會顯示對話方塊，列出不同應用程式的名稱。每個應用程式右側都有「停止」按鈕
圖 1：工作管理員的工作流程，可讓使用者停止有持續性前景服務的應用程式。這個工作流程僅會顯示在搭載 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 配額會隨著向使用者顯示的通知數量而增加。

如同先前 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 實作，包括語音輸入法、RecognitionService 和以意圖為基礎的 API。

Android 12 中發生了以下變更：

  • SpeechService 功能已遷移至 Speech Services by Google app，並成為預設 SpeechService 供應器。
  • RecognitionService 功能已移至 Android System Intelligence 應用程式，以支援裝置端語音辨識。

為在 Android 12 上維持應用程式相容性，Google 應用程式會使用彈跳轉址，將流量轉送至 Speech Services by Google 應用程式。在 Android 13 中，這項彈跳轉址已移除。

應用程式應使用裝置的預設 SpeechService 供應器，而非硬式編碼特定應用程式。