版本
类型 | 字符串 |
---|---|
必填 | 是 |
示例 |
json
|
扩展的**版本字符串**。
版本格式
版本字符串由 1 到 4 个数字组成,数字之间用点分隔,例如 1.2.3.4
。非零数字不能以零开头。例如,2.01
不允许;但是,0.2
、2.0.1
和 2.10
是允许的。
扩展商店和浏览器可能会强制执行或警告版本字符串是否符合此格式。它们也可能会对可用数字的范围施加限制。例如
- addons.mozilla.org (AMO) 允许使用最多九位数字的版本字符串,符合此正则表达式
^(0|[1-9][0-9]{0,8})([.](0|[1-9][0-9]{0,8})){0,3}$
。此外,从 Firefox 108 开始,如果安装的扩展程序的版本号与该格式不匹配,则会提供警告。 - Chrome 网上应用店要求数字介于 0 和 65535 之间,并且不允许全零扩展字符串。例如,0.0 或 0.0.0.0 不允许。
可以创建扩展程序,使其在浏览器中运行时似乎具有有效的版本号,但不符合商店要求。在开发使用大型数字元素的跨浏览器扩展程序时,应特别注意。
某些浏览器和网上应用店可能会识别version_name 键。此键使您能够提供描述性版本字符串,该字符串可能会显示版本号。例如,1.0 beta
。
比较版本
要确定两个扩展版本中哪个是最新的,将从左到右比较版本字符串数字。缺少的版本字符串元素等效于 0
。例如,1.0 等效于 1.0.0.0。第一个版本字符串的数字大于另一个版本字符串中对应数字的版本字符串是最新的。例如,1.10 比 1.9 新。
旧版本格式
有关以前支持的版本字符串的详细信息,请参阅旧版本格式。
在代码中访问版本号
您可以在 JavaScript 代码中使用以下方法获取扩展版本
js
console.log(browser.runtime.getManifest().version);
如果清单包含
json
"version": "0.1"
您将在控制台日志中看到此内容
"0.1"
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。