啟用通知的通知權限

Android 13 中的通知採用選擇加入模式，這與先前使用選擇退出模式的 Android 版本有所不同。在 Android 13 中，所有應用程式都必須先向使用者要求權限，才能傳送通知提示。這有助於減少通知中斷情形、減少資訊過載，並協助使用者根據自己重視的事項控制顯示的通知。為了支援選擇加入模式，原始設備製造商必須在通知和執行階段權限系統中實作變更。

本頁說明原始設備製造商 (OEM) 必須實作哪些內容才能支援這項變更，以及如何驗證實作內容。

實作選擇加入通知的變更

自 Android 13 起，應用程式必須先向系統要求 android.permission.POST_NOTIFICATION 執行階段權限，才能傳送通知，並宣告傳送通知的意圖。

在 Android 13 以上版本中，決定應用程式是否可向使用者傳送通知的設定會儲存在權限系統中。在 Android 13 之前，這項設定會儲存在通知系統中。因此，原始設備製造商必須將現有的通知資料 (關於應用程式是否允許傳送通知) 從通知系統遷移至執行階段權限系統。原始設備製造商 (OEM) 也必須在通知系統中維護現有的 API，以便將這些資料提供給應用程式開發人員。

通知和權限系統的變更，是根據使用者通知行為的選擇加入模式而定，並在「導入指南」一節中加以說明。

選擇接受型模式中的使用者通知行為

下表說明在搭載 Android 13 的裝置上，不同應用程式版本的通知行為：

搭載 Android 13 的裝置 指定 Android 13 以上版本的應用程式 指定 Android 13 以下版本的應用程式
新安裝 系統會在應用程式提示前封鎖通知。

應用程式可控制要求權限的時機。

 系統會在作業系統提示前封鎖通知。

系統會在首次執行應用程式時要求權限。
現有應用程式 (升級) 在應用程式提示前，系統會允許通知。

系統會授予臨時權限，直到應用程式在首次符合資格的執行階段要求權限為止。

 在作業系統提示前，系統會允許通知。

系統會在應用程式首次執行前授予臨時權限。

導入指南

如需參考實作方式，請參閱通知服務、權限服務和政策服務。如要為預設權限處理常式實作例外狀況，請參閱「執行階段權限」。

在導入期間，請針對指定 Android 13 以下 SDK 的應用程式，遵循下列使用者通知行為規範：

  • 在 Android 13 裝置上新安裝的應用程式，必須在使用者核准權限提示後，才能傳送通知。
    • 如果應用程式指定 Android 13 以上版本，則必須在應用程式提示前，將通知封鎖，因為應用程式會控管要求使用者權限的時機和方式。
    • 如果應用程式指定的目標版本低於 Android 13，則必須在作業系統提示前封鎖通知。作業系統必須在第一次執行應用程式時顯示權限提示。

  • 在升級至 Android 13 之前，裝置上已存在的任何應用程式，或透過備份和還原功能還原的任何應用程式，都必須允許傳送通知，直到使用者首次從該應用程式啟動活動為止。

    • 針對指定 Android 13 以上版本 SDK 的應用程式，如果使用者先前未在應用程式或 NotificationChannel 層級為此應用程式自訂通知設定，請撤銷臨時權限授予作業。應用程式必須先向使用者要求權限，才能繼續傳送通知。

      如果指定 Android 13 為目標版本的升級應用程式目前沒有透過臨時升級授權取得通知權限，且使用者至少已啟動一次，則應用程式必須先顯示通知權限提示，才能執行任何其他前景服務。

    • 如果應用程式指定的 SDK 版本低於 Android 13，請在應用程式建立至少一個 NotificationChannel 後攔截首次啟動的活動，以便顯示權限提示，詢問使用者是否要接收來自應用程式的通知。

      如果使用者先前曾在升級裝置或備份中，為應用程式在應用程式或 NotificationChannel 層級自訂通知設定，則必須使用 FLAG_PERMISSION_USER_SET 標記，將應用程式層級設定遷移至權限系統。除非應用程式特別要求，否則不得向使用者顯示其他通知權限提示。

  • 備份和還原功能必須在 Android 13 裝置和較舊 OS 版本的裝置之間回溯和前向相容。從 Android 13 裝置產生的備份資料必須還原至較舊的 OS 版本，而較舊 OS 版本的備份資料則必須還原至 Android 13 裝置。

  • 與持續進行的媒體播放相關的媒體通知必須免除通知權限。

驗證通知和權限系統的變更

如要驗證導入作業，請執行下列測試：