行為變更：所有應用程式

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 配額會隨著系統向使用者顯示的通知數量，按照高優先順序 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。

注意： 如果您已在資訊清單中定義 android:sharedUserId 屬性，請勿將其移除，否則會導致應用程式更新失敗。

共用的使用者 ID 會在套件管理員中造成不確定因素的行為。應用程式應改用適當的通訊機制 (例如服務和內容供應器)，以促進共用元件之間的互通性。

使用者體驗

可關閉的前景服務通知

在搭載 Android 13 以上版本的裝置上，根據預設，使用者可以關閉與前景服務相關的通知。

核心功能

已移除舊版語音服務導入方式

Android 13 會從 Google 應用程式中移除 SpeechService 實作，包括語音輸入法、RecognitionService 和以意圖為基礎的 API。

Android 12 中發生了以下變更：

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

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

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