浏览器特定设置

类型 对象
强制性 通常情况下,不需要(但请参见何时需要附加组件 ID?)。如果无法确定扩展 ID,则为强制性,请参见browser_specific_settings.gecko.id
示例
json
"browser_specific_settings": {
  "gecko": {
    "id": "[email protected]",
    "strict_min_version": "42.0"
  }
}

描述

browser_specific_settings 键包含特定于特定主机应用程序的键。

Firefox (Gecko) 属性

Firefox 将浏览器特定设置存储在以下子键中

  • gecko 用于 Firefox 的桌面版本。
  • gecko_android 用于 Firefox 的 Android 版本。

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 必须是以下之一

后一种格式更易于生成和操作。请注意,在此处使用真实的电子邮件地址可能会招致垃圾邮件。

例如

json
"id": "[email protected]"
json
"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"

Safari 属性

Safari 将其浏览器特定设置存储在 safari 子键中,该子键具有以下属性

strict_min_version

支持的 Safari 最低版本。

strict_max_version

支持的 Safari 最高版本。

示例

包含所有可能键的示例。请注意,大多数扩展省略了 strict_max_versionupdate_url

json
"browser_specific_settings": {
  "gecko": {
    "id": "[email protected]",
    "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"
  }
}

浏览器兼容性

BCD 表仅在浏览器中加载