一般來說,Chrome 使用者安裝擴充功能的方式是前往 Chrome 線上應用程式商店的擴充功能清單,然後直接在該頁面安裝擴充功能。不過,在某些情況下,其他安裝流程可能更適合。例如:
- 擴充功能與其他軟體相關聯,當使用者安裝該其他軟體時,系統應一併安裝擴充功能。
- 網路管理員想在整個機構中安裝相同的擴充功能。
在之前,Google Chrome 支援下列擴充功能安裝方法:
- 使用偏好設定 JSON 檔案 (僅適用於 macOS X 和 Linux)
- 使用 Windows 登錄檔 (僅適用於 Windows)
兩種方法都支援安裝在 update_URL
代管的擴充功能。在 Windows 和 macOS 上,update_URL
必須指向 Chrome 線上應用程式商店。使用這些方法安裝擴充功能時,Windows 和 macOS 使用者必須透過下列確認對話方塊啟用擴充功能:
在 Linux 上,偏好設定檔案可以指向 Chrome 線上應用程式商店擴充功能、外部代管的擴充功能或使用者電腦上的 CRX 擴充功能檔案。Linux 使用者不會收到啟用擴充功能的提示,系統會自動安裝擴充功能。
事前準備
從 Chrome 線上應用程式商店安裝
如果您要發布由 Chrome 線上應用程式商店代管的擴充功能,則必須先發布擴充功能。接著,請留意下列事項:
- 更新網址:
https://clients2.google.com/service/update2/crx
。這個網址會指向 Chrome 線上應用程式商店 - 擴充功能 ID:可在擴充功能的 Chrome 線上應用程式商店網址中找到。
從本機 CRX 檔案安裝
如果您要透過本機檔案向 Linux 使用者發布,就必須封裝 CRX 檔案,並注意下列事項:
擴充功能 ID:如要查看擴充功能 ID,請前往擴充功能管理頁面
chrome://extensions
。擴充功能版本:這個值會顯示在擴充功能管理頁面
chrome://extensions
或資訊清單 JSON 檔案中。
- CRX 檔案的位置:可以是本機目錄或網路共用資料夾。請確認檔案可供要安裝擴充功能的電腦使用。
從個人伺服器安裝
如果您要為 Linux 使用者發布在個人伺服器上代管的擴充功能,請按照「在 Linux 上安裝擴充功能」一文的操作說明進行,並注意下列事項:
擴充功能 ID:您可以在擴充功能管理頁面
chrome://extensions
中找到這項資訊。update_url XML 檔案路徑:必須與資訊清單 JSON 檔案中宣告的
update_url
欄位路徑相符。
以下範例假設版本為 1.0,擴充功能 ID 為 aaabbbcccdddeeefff。
使用偏好設定檔案
macOS
- 建立含有擴充功能 ID 名稱的 JSON 檔案。例如:
aaabbbcccdddeeefff.json
將檔案放入下列其中一個資料夾:
- 針對特定使用者
~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
- 適用於所有使用者
/Library/Application Support/Google/Chrome/External Extensions/
使用欄位名稱「external_update_url」指定更新網址。例如:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
儲存 JSON 檔案。
啟動 Google Chrome 並前往 chrome://extensions。這時畫面上應會顯示該擴充功能。
排解 Mac OS 權限問題
在 macOS 上,只有在檔案系統權限禁止無權限使用者變更時,系統才會讀取所有使用者的外部擴充功能檔案。如果在啟動 Chrome 時沒有看到已安裝的外部擴充功能,則外部擴充功能偏好設定檔可能有權限問題。如要確認這是否為問題所在,請按照下列步驟操作:
- 啟動 Play 管理中心程式。您可以在 /Applications/Utilities/Console 下方找到這個檔案。
- 如果控制台最左側的圖示顯示「Show Log List」,請按一下該圖示。左側會顯示第二欄。
- 按一下左側窗格中的「管理中心訊息」。
- 搜尋「Can not read external extensions」字串。如果讀取外部擴充功能檔案時發生問題,系統會顯示錯誤訊息。請先查看其他錯誤訊息,內容應能說明問題所在。例如,如果您看到以下錯誤訊息:「Path /Library/Application Support/Google/Chrome is not have by the wrong group」,請使用
chgrp
或 Finder 的「取得資訊」對話方塊,將目錄的版主變更為系統管理員群組。 - 修正問題後,請重新啟動 Chrome。測試是否已安裝外部擴充功能。一個權限錯誤可能會導致 Chrome 無法偵測到第二個錯誤。如果未安裝外部擴充功能,請重複執行這些步驟,直到控制台應用程式不再顯示錯誤為止。
Linux
- 建立名為擴充功能 ID 的 JSON 檔案。例如
aaabbbcccdddeeefff.json
。 請將檔案放入下列其中一個資料夾:
/opt/google/chrome/extensions/
/usr/share/google-chrome/extensions/
以下清單說明從 Chrome 線上應用程式商店、CRX 檔案或個人伺服器安裝擴充功能:
- 如要安裝 Chrome 線上應用程式商店擴充功能,請使用欄位名稱「external_update_url」指定更新網址。例如:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
- 如要從 CRX 檔案安裝擴充功能,請在「external_crx」中指定位置,並在「external_version」中指定版本。例如:
json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
- 如要安裝在個人伺服器上代管的擴充功能,則「external_update_url」欄位必須指向 XML 檔案,如以下範例所示:
json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
- 如要安裝 Chrome 線上應用程式商店擴充功能,請使用欄位名稱「external_update_url」指定更新網址。例如:
儲存 JSON 檔案。
啟動 Google Chrome 並前往 chrome://extensions,你應該會看到擴充功能列表。
支援的語言代碼
如果只想安裝部分瀏覽器語言代碼的擴充功能,您可以在欄位名稱「supported_locales」中列出支援的語言代碼。語言代碼可能會指定「en」等父語言代碼,在這種情況下,系統會為所有英文語言代碼 (例如「en-US」、「en-GB」等) 安裝擴充功能。如果選取的瀏覽器語言代碼不受擴充功能支援,系統會解除安裝外部擴充功能。如果缺少「supported_locales」清單,擴充功能就會在任何語言代碼下安裝。例如:
{
"external_update_url": "https://clients2.google.com/service/update2/crx",
"supported_locales": [ "en", "fr", "de" ]
}
使用 Windows 登錄檔
在登錄檔中找出或建立下列機碼:
- 32 位元 Windows
HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
- 64 位元 Windows
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
在「Extensions」鍵下,建立名稱與擴充功能 ID 相同的新金鑰 (資料夾)。例如:
aaabbbcccdddeeefff
。在擴充功能索引鍵中建立「update_url」屬性,並將其設為下列值:
json { "update_url": "https://clients2.google.com/service/update2/crx" }
啟動 Chrome。
前往 chrome://extensions,你應該會看到擴充功能列在其中。
更新及解除安裝
Google Chrome 會在每次啟動時掃描偏好設定和登錄檔中的中繼資料項目,並視需要變更 Chrome 線上應用程式商店所代管的已安裝外部擴充功能。
如要將本機 CRX 副檔名更新為新版本,請更新檔案,然後更新偏好設定 json 檔案中的版本。
如要解除安裝擴充功能 (例如,如果軟體已解除安裝),請移除偏好設定檔案 (例如 aaabbbcccdddeeefff.json
) 或登錄檔的中繼資料。
常見問題
本節將解答外部擴充功能的常見問題。
Google Chrome 是否仍支援「預先安裝」功能?
可以,但只能從 Chrome 線上應用程式商店 (update_url
) 安裝,而非從本機 CRX 路徑安裝。詳情請參閱應用程式和擴充功能政策。
使用偏好設定檔安裝時,常見的錯誤有哪些?
- 未指定與 CRX 檔案中列出的 ID 或版本相同的 ID 或版本。
- JSON 檔案 (例如
aaabbbcccdddeeefff.json
) 位於錯誤位置,或是指定的 ID 與擴充功能 ID 不符。 - JSON 檔案中的語法錯誤 (忘記使用逗號分隔項目,或在某處留下尾隨的逗號)。
- JSON 檔案進入點指向錯誤的 CRX 檔案路徑 (或指定路徑,但未指定檔案名稱)
- 系統不會對 UNC 路徑中的反斜線進行轉義。舉例來說,
"\\server\share\file"
有誤,應為"\\\\server\\share\\extension"
。 - 網路共用的權限問題。
安裝登錄檔時有哪些常見錯誤?
- 未指定與 Chrome 線上應用程式商店中列出的 ID 相同的 ID。
- 建立金鑰的登錄位置錯誤。
- 登錄項目指向錯誤指向 Chrome 線上應用程式商店 CRX 檔案的路徑。
- 網路共用的權限問題。
- 並非所有的 Chrome 執行個體都會關閉。設定登錄表後,請嘗試重新啟動電腦。
如果使用者解除安裝擴充功能,該怎麼辦?
如果使用者透過 UI 解除安裝擴充功能,系統將不會在每次啟動時安裝或更新。也就是說,系統會將外部擴充功能加入封鎖清單。
如何從封鎖清單中移除?
如果使用者解除安裝您的擴充功能,您應尊重使用者的決定。不過,如果您 (開發人員) 不小心透過使用者介面解除安裝擴充功能,可以透過使用者介面正常安裝擴充功能,然後再解除安裝,即可移除封鎖清單標記。