browser_specific_settings

描述

browser_specific_settings 鍵包含特定於某個主機應用程式的鍵。

Firefox (Gecko) 屬性

Firefox 在這些子鍵中儲存瀏覽器特定設定

• gecko 用於桌面版 Firefox。
• gecko_android 用於 Android 版 Firefox。

gecko 子鍵支援以下屬性

id

擴充套件 ID。提供時，此屬性必須小於等於 80 個字元。請參閱 擴充套件和擴充套件 ID 以確定何時指定 ID。

strict_min_version

支援的最低 Gecko 版本。如果安裝或執行擴充套件的 Firefox 版本低於此版本，則不會安裝或執行該擴充套件。如果未提供，則支援 strict_max_version 之前的所有版本。“*”在此欄位中無效。

strict_max_version

支援的最高 Gecko 版本。如果安裝或執行擴充套件的 Firefox 版本高於此版本，則不會安裝或執行該擴充套件。預設為“*”，表示停用最高版本檢查。

update_url

指向 擴充套件更新清單的連結。請注意，連結必須以“https”開頭。此鍵用於自行管理擴充套件更新（即，不透過 AMO）。

gecko_android 子鍵支援以下屬性

strict_min_version

支援的 Android 版 Gecko 的最低版本。如果安裝或執行擴充套件的 Firefox for Android 版本低於此版本，則不會安裝或執行該擴充套件。如果未提供，則預設為 gecko.strict_min_version 確定的版本。“*”在此欄位中無效。

strict_max_version

支援的 Android 版 Gecko 的最高版本。如果安裝或執行擴充套件的 Firefox 版本高於此版本，則不會安裝或執行該擴充套件。預設為 gecko.strict_max_version 確定的版本。

請參閱 有效的 Gecko 版本列表。

要支援 Firefox for Android 而無需指定版本範圍，gecko_android 子鍵必須是一個空物件，即 "gecko_android": {}。否則，該擴充套件僅在桌面版 Firefox 上可用。

擴充套件 ID 格式

擴充套件 ID 必須是以下之一

• GUID
• 格式類似於電子郵件地址的字串：extensionname@example.org。但是，推薦使用 @string 格式。

後一種格式更容易生成和操作。請注意，此處使用真實的電子郵件地址可能會吸引垃圾郵件。

例如

"id": "@extension-name.developer-name"

"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"

Safari 屬性

Safari 在 safari 子鍵中儲存其瀏覽器特定設定，該子鍵具有以下屬性

strict_min_version

支援的最低 Safari 版本。

strict_max_version

支援的最高 Safari 版本。

Chrome 屬性

Chrome 不使用此鍵，如果它存在於擴充套件的 manifest.json 檔案中，則會忽略它。

示例

包含所有可能鍵的示例。請注意，大多數擴充套件會省略 strict_max_version 和 update_url。

"browser_specific_settings": {
  "gecko": {
    "id": "@addon-example",
    "strict_min_version": "42.0",
    "strict_max_version": "50.*",
    "update_url": "https://example.com/updates.json"
  },
  "safari": {
    "strict_min_version": "14",
    "strict_max_version": "20"
  }
}

瀏覽器相容性