權限警告指南
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Chrome 擴充功能可改善使用者的瀏覽器體驗。為執行這類擴充功能,請使用需要特定權限的 Chrome API。某些權限較不受干擾,而且不會顯示警告。其他權限則會觸發警告,要求使用者允許。本頁面提供權限警告的使用指南。特定警告會在適用權限下的權限中說明。
新增會觸發警告的新權限時,系統會停用擴充功能,直到使用者接受新權限為止。請參閱更新權限,瞭解如何測試這項行為。
某些權限在與其他權限配對時可能不會顯示警告。舉例來說,如果擴充功能也要求 "<all_urls>"
,就不會顯示 "tabs"
警告。
最佳做法
權限警告是用來說明 API 授予的功能,但有些警告則比其他警告更難理解。使用者較有可能安裝遵循下列指南的擴充功能:
- 要求相關權限
- 擴充功能除了要滿足單一用途要求外,也必須符合權限使用政策的規定。請務必只要求支援擴充功能主要功能的權限。
- 使用選用權限
- 在執行階段要求權限,改善新手上路體驗。如此一來,您就能更詳細瞭解特定權限的相關資訊,並讓使用者選擇要啟用哪些功能。如需實作詳細資料,請參閱「Permissions API」。
- 使用「activeTab」權限
- 這項權限不會顯示權限警告。這會授予使用者目前所在網站的臨時主機權限。詳情請參閱「瞭解 ActiveTab 權限」一文。
查看警告
如要查看擴充功能的權限警告,可以選擇下列幾種做法:
事前準備
- 安裝 Node.js 和 NPM。
- 安裝 Chromium。
- 複製 extension-update-testing-tool 存放區。
- 在存放區根目錄中執行
npm install
。
使用工具
- 執行
npm start
。
- 在 Chromium 中前往 http://localhost:8080 開啟本機伺服器。
- 將未封裝的擴充功能 (資料夾或 .zip 檔案) 拖曳至頁面。
- 按照「手動安裝」下方的說明操作,即可下載並安裝擴充功能。
手動封裝擴充功能
- 瀏覽至「
chrome://extensions
」
- 啟用開發人員模式
- 按一下「封裝擴充功能」。
- 在擴充功能根目錄欄位中,指定擴充功能資料夾的路徑。忽略第一次套件的「私密金鑰」欄位。
按一下「Pack Extension」按鈕。
Chrome 會建立兩個檔案:.crx
檔案和一個 .pem
檔案。.pem
檔案包含用來簽署擴充功能的私密金鑰。請確認您記得這些檔案儲存了哪些目錄。
更新 .pem
擴充功能時,請將這個檔案存放在安全的地方。
將 .crx
檔案放入擴充功能的「管理」頁面,即可安裝。
捨棄 .crx
檔案後,瀏覽器會詢問是否能新增擴充功能,並顯示警告。
更新權限
如果擴充功能新增的權限會觸發警告,可能會暫時停用該擴充功能。只有在使用者同意接受新權限後,系統才會重新啟用擴充功能。
如要檢查擴充功能是否在新增權限時遭到停用,您可以選擇以下做法:
以下步驟假設您已按照使用擴充功能更新測試工具的操作說明啟動伺服器。
使用工具
- 新增有警告的權限。
- 增加擴充功能的版本號碼。
- 將未封裝的擴充功能 (資料夾或 .zip 檔案) 拖曳至頁面。
- 前往
chrome://extensions
。
- 按一下「Update」按鈕。
手動更新擴充功能
- 在「查看警告」中找出剛才建立的
.crx
檔案。
- 重新命名或刪除。
- 開啟
manifest.json
,然後新增任何觸發警告的權限。
- 請前往
chrome://extensions
,請勿移除先前安裝的套件。
- 再次封裝擴充功能,但這次請在第二個輸入項目中新增 pem 檔案。
- 將新的封裝擴充功能拖曳至「擴充功能管理」頁面。
畫面上會顯示對話方塊,提示使用者接受新權限。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-02-05 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-02-05 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-02-05 (世界標準時間)。"],[],[]]