權限警告指南

Chrome 擴充功能可改善使用者的瀏覽器體驗。為執行這類擴充功能,請使用需要特定權限的 Chrome API。某些權限較不受干擾,而且不會顯示警告。其他權限則會觸發警告,要求使用者允許。本頁面提供權限警告的使用指南。特定警告會在適用權限下的權限中說明。

當使用者新增擴充功能時,系統會顯示權限警告範例
圖 1:安裝時顯示的權限警告對話方塊。

新增會觸發警告的新權限時,系統會停用擴充功能,直到使用者接受新權限為止。請參閱更新權限,瞭解如何測試這項行為。

停用擴充功能範例,直到使用者接受新權限為止。
圖 2:在使用者接受新權限之前停用的擴充功能。

某些權限在與其他權限配對時可能不會顯示警告。舉例來說,如果擴充功能也要求 "<all_urls>",就不會顯示 "tabs" 警告。

最佳做法

權限警告是用來說明 API 授予的功能,但有些警告則比其他警告更難理解。使用者較有可能安裝遵循下列指南的擴充功能:

要求相關權限
擴充功能除了要滿足單一用途要求外,也必須符合權限使用政策的規定。請務必只要求支援擴充功能主要功能的權限。
使用選用權限
在執行階段要求權限,改善新手上路體驗。如此一來,您就能更詳細瞭解特定權限的相關資訊,並讓使用者選擇要啟用哪些功能。如需實作詳細資料,請參閱「Permissions API」。
使用「activeTab」權限
這項權限不會顯示權限警告。這會授予使用者目前所在網站的臨時主機權限。詳情請參閱「瞭解 ActiveTab 權限」一文。

查看警告

如要查看擴充功能的權限警告,可以選擇下列幾種做法:

使用擴充功能更新測試工具

事前準備

  1. 安裝 Node.js 和 NPM。
  2. 安裝 Chromium
  3. 複製 extension-update-testing-tool 存放區。
  4. 在存放區根目錄中執行 npm install

使用工具

  1. 執行 npm start
  2. 在 Chromium 中前往 http://localhost:8080 開啟本機伺服器。
  3. 將未封裝的擴充功能 (資料夾或 .zip 檔案) 拖曳至頁面。
  4. 按照「手動安裝」下方的說明操作,即可下載並安裝擴充功能。

手動封裝擴充功能

  1. 瀏覽至「chrome://extensions
  2. 啟用開發人員模式
  3. 按一下「封裝擴充功能」
    封裝擴充功能
    圖 3:在「擴充功能管理」頁面中啟用開發人員模式
  4. 在擴充功能根目錄欄位中,指定擴充功能資料夾的路徑。忽略第一次套件的「私密金鑰」欄位。
  5. 按一下「Pack Extension」按鈕。

    指定擴充功能路徑,然後按一下「封裝擴充功能」
    圖 4:指定擴充功能路徑
  6. Chrome 會建立兩個檔案:.crx 檔案和一個 .pem 檔案。.pem 檔案包含用來簽署擴充功能的私密金鑰。請確認您記得這些檔案儲存了哪些目錄。

    封裝的擴充功能檔案
    圖 5:封裝的擴充功能檔案
  7. 更新 .pem 擴充功能時,請將這個檔案存放在安全的地方。

  8. .crx 檔案放入擴充功能的「管理」頁面,即可安裝。

    將檔案拖曳到這裡即可安裝
    圖 6:拖曳檔案即可安裝
  9. 捨棄 .crx 檔案後,瀏覽器會詢問是否能新增擴充功能,並顯示警告。

    新分頁擴充功能警告
    圖 7:新分頁擴充功能的警告

更新權限

如果擴充功能新增的權限會觸發警告,可能會暫時停用該擴充功能。只有在使用者同意接受新權限後,系統才會重新啟用擴充功能。

如要檢查擴充功能是否在新增權限時遭到停用,您可以選擇以下做法:

使用擴充功能更新測試工具進行更新

以下步驟假設您已按照使用擴充功能更新測試工具的操作說明啟動伺服器。

使用工具

  1. 新增有警告的權限
  2. 增加擴充功能的版本號碼
  3. 將未封裝的擴充功能 (資料夾或 .zip 檔案) 拖曳至頁面。
  4. 前往 chrome://extensions
  5. 按一下「Update」按鈕。

手動更新擴充功能

  1. 在「查看警告」中找出剛才建立的 .crx 檔案。
  2. 重新命名或刪除。
  3. 開啟 manifest.json,然後新增任何觸發警告的權限
  4. 請前往 chrome://extensions請勿移除先前安裝的套件
  5. 再次封裝擴充功能,但這次請在第二個輸入項目中新增 pem 檔案。
    在封裝擴充功能時新增 Pem 檔案
    圖 8:包含 pem 檔案的封裝擴充功能對話方塊。
  6. 將新的封裝擴充功能拖曳至「擴充功能管理」頁面。
  7. 畫面上會顯示對話方塊,提示使用者接受新權限。

    擴充功能已停用

    圖 9:已停用擴充功能的警告

    同意授權
    圖 10:要求新權限對話方塊