Android 11 的權限更新

Android 11 可讓使用者針對位置、麥克風和相機指定更精細的權限。此外，系統會重設指定 Android 11 以上版本為目標版本的未使用應用程式的權限，如果應用程式使用系統警示視窗或讀取電話號碼相關資訊，可能需要更新宣告的權限。

單次授權

從 Android 11 開始，每次應用程式要求位置資訊、麥克風或相機的相關權限時，向使用者顯示的權限對話方塊就會包含稱為「僅允許這一次」的選項。如果使用者在對話方塊中選取這個選項，您的應用程式就會獲得暫時的單次授權。

進一步瞭解系統如何處理一次性權限。

注意： 如果您的應用程式在要求執行階段權限時已遵循最佳做法，則無須變更應用程式即可支援單次授權。

針對未使用的應用程式自動重設權限

如果應用程式指定的是 Android 11 以上版本，且未使用的期間長達幾個月，系統會自動重設使用者已授予應用程式的機密執行階段權限，藉此保護使用者資料。這項操作的效果等同於使用者在系統設定中檢視權限，並將應用程式的存取層級變更為「拒絕」。如果應用程式遵循在執行階段要求權限的最佳做法，則不必對應用程式進行任何變更。這是因為在使用者與應用程式中的功能互動時，您應驗證這些功能是否具有所需的權限。

注意： 系統只會重設執行階段權限，也就是在使用者提出要求時，向使用者顯示執行階段提示的權限。

進一步瞭解系統如何自動重設未使用的應用程式權限。

權限對話方塊的顯示方式

從 Android 11 開始，如果使用者在裝置上安裝應用程式後不限時間內，不止一次針對特定權限要求輕觸「拒絕」，則當您的應用程式再次要求該權限時，使用者就不會看到系統權限對話方塊。使用者的動作暗示著「不要再詢問」。在先前的版本中，除非使用者之前曾經勾選「不要再詢問」核取方塊或選項，否則應用程式每次要求權限時，使用者都會看到系統權限對話方塊。Android 11 的這項行為異動，可避免使用者拒絕的權限要求重複出現。

使用者可能會永久拒絕授予應用程式權限，如要確認是否如此 (出於偵錯和測試目的)，請使用下列指令：

adb shell dumpsys package PACKAGE_NAME

其中 PACKAGE_NAME 是要檢查的套件名稱。

您可以在指令輸出內容中看到類似下方的區段：

...
runtime permissions:
  android.permission.POST_NOTIFICATIONS: granted=false, flags=[ USER_SENSITIVE_WHEN_GRANTED|USER_SENSITIVE_WHEN_DENIED]
  android.permission.ACCESS_FINE_LOCATION: granted=false, flags=[ USER_SET|USER_FIXED|USER_SENSITIVE_WHEN_GRANTED|USER_SENSITIVE_WHEN_DENIED]
  android.permission.BLUETOOTH_CONNECT: granted=false, flags=[ USER_SENSITIVE_WHEN_GRANTED|USER_SENSITIVE_WHEN_DENIED]
...

遭使用者拒絕一次的權限會標記 USER_SET。如果是遭使用者選取「拒絕」兩次，表明要永久拒絕的權限，則會標記 USER_FIXED。

在測試期間，您可能需要重設這些標記，確保測試人員不會在未顯示要求對話方塊時感到意外。如要這麼做，請使用下列指令：

adb shell pm clear-permission-flags PACKAGE_NAME PERMISSION_NAME user-set user-fixed

PERMISSION_NAME 是您要重設的權限名稱。如要查看 Android 應用程式權限的完整清單，請參閱權限 API 參考資料頁面。

注意： 如果您的應用程式已遵循權限相關最佳做法，則無須變更應用程式即可支援此行為變更。

進一步瞭解如何在應用程式中處理權限遭拒的情況。

系統快訊視窗變更

Android 11 對應用程式授予 SYSTEM_ALERT_WINDOW 權限的方式做出了幾項變更。這項異動旨在讓權限授予更加謹慎，進而保護使用者。

系統會在特定應用程式要求時，自動授予 SYSTEM_ALERT_WINDOW 權限

系統會在要求時，自動授予特定類型的應用程式 SYSTEM_ALERT_WINDOW 權限：

• 任何具有 ROLE_CALL_SCREENING 且要求 SYSTEM_ALERT_WINDOW 的應用程式，都會自動獲得權限。如果應用程式失去 ROLE_CALL_SCREENING，就會失去權限。

• 任何透過 MediaProjection 擷取螢幕畫面並要求 SYSTEM_ALERT_WINDOW 的應用程式，都會自動獲得該權限，除非使用者明確拒絕授予應用程式該權限。當應用程式停止擷取螢幕畫面時，就會失去該權限。這個用途主要適用於遊戲直播應用程式。

這些應用程式不需要傳送 ACTION_MANAGE_OVERLAY_PERMISSION 即可取得 SYSTEM_ALERT_WINDOW 權限，只要直接要求 SYSTEM_ALERT_WINDOW 即可。

MANAGE_OVERLAY_PERMISSION 意圖一律會將使用者導向系統權限畫面

從 Android 11 開始，ACTION_MANAGE_OVERLAY_PERMISSION 意圖一律會將使用者帶往頂層「設定」畫面，使用者可以在該畫面中授予或撤銷應用程式的 SYSTEM_ALERT_WINDOW 權限。系統會忽略意圖中的任何 package: 資料。

在舊版 Android 中，ACTION_MANAGE_OVERLAY_PERMISSION 意圖可指定套件，將使用者帶往應用程式專屬畫面，以便管理權限。自 Android 11 起，系統就不再支援這項功能。相反地，使用者必須先選取要授予或撤銷權限的應用程式。這項異動旨在讓權限授予更加謹慎，進而保護使用者。

電話號碼

Android 11 會變更應用程式讀取電話號碼時使用的電話相關權限。

如果應用程式指定 Android 11 以上版本為目標，且需要存取下列清單中的電話號碼 API，則必須要求 READ_PHONE_NUMBERS 權限，而非 READ_PHONE_STATE 權限。

• TelephonyManager 類別和 TelecomManager 類別中的 getLine1Number() 方法。
• TelephonyManager 類別中不支援的 getMsisdn() 方法。

如果應用程式宣告 READ_PHONE_STATE 以呼叫前述清單以外的方法，您可以繼續在所有 Android 版本中要求 READ_PHONE_STATE。不過，如果您只將 READ_PHONE_STATE 權限用於上述清單中的方法，請按照下列方式更新資訊清單檔案：

1. 變更 READ_PHONE_STATE 的宣告，讓應用程式只在 Android 10 (API 級別 29) 以下版本中使用權限。
2. 新增 READ_PHONE_NUMBERS 權限。

下列資訊清單宣告程式碼片段示範了這個程序：

<manifest>
    <!-- Grants the READ_PHONE_STATE permission only on devices that run
         Android 10 (API level 29) and lower. -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"
                     android:maxSdkVersion="29" />
    <uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />
</manifest>

其他資源

如要進一步瞭解 Android 11 中權限的變更，請參閱下列資料：

影片

配合 Android 11 最新隱私權變更進行開發