浏览器特定设置
类型 | 对象 |
---|---|
强制性 | 通常情况下,不需要(但请参见何时需要附加组件 ID?)。如果无法确定扩展 ID,则为强制性,请参见browser_specific_settings.gecko.id 。 |
示例 |
json
|
描述
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 必须是以下之一
- GUID
- 以电子邮件地址格式的字符串:
[email protected]
后一种格式更易于生成和操作。请注意,在此处使用真实的电子邮件地址可能会招致垃圾邮件。
例如
"id": "[email protected]"
"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"
Safari 属性
Safari 将其浏览器特定设置存储在 safari
子键中,该子键具有以下属性
strict_min_version
-
支持的 Safari 最低版本。
strict_max_version
-
支持的 Safari 最高版本。
示例
包含所有可能键的示例。请注意,大多数扩展省略了 strict_max_version
和 update_url
。
"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 表仅在浏览器中加载