[os.version] 部分声明了您应用支持的设备操作系统版本范围。Vega会在构建时验证此部分,而Vega打包工具 (VPT) 也会在打包应用时再次验证。
自Vega SDK 0.24起,必须含有[os.version]部分。缺少该部分会导致构建失败。
min和target的值均设为1.2。后续发布更高版本的操作系统时,将target设为构建所用的最新版本,并将min保留为您支持的最旧版本。
字段
下表描述了[os.version] 部分中的字段。
两个值均须为
"M.n"格式的引用字符串,且为官方正式发布的操作系统版本。否则,即使格式正确,Vega也会拒绝该值。
验证规则
Vega会对[os.version] 部分应用以下规则:
-
min和target均须为SDK兼容性清单中已有的操作系统版本。 -
min须不高于target。 -
min版本中的每个[[needs.module]]条目均须可用。 -
您的代码必须保护
min之后的版本中添加的API,相关工具会将其记录为[[wants.module]]条目。有关详细信息,请参阅使用isPresentOnOS保护新API。
示例清单
[os.version] 部分位于其他清单部分旁,相关工具会生成与之匹配的操作系统版本模块条目。操作系统目标版本1.2的完整清单如下例所示。
[os.version] 部分由您自行设置,相关工具会生成模块条目。每个操作系统版本模块id都会将操作系统版本中的点号替换为下划线,例如1.2会变成/com.amazon.vega.os@IVega_1_2。
由于本例中的min和target均为1.2,因此清单只会生成一个 [[needs.module]] 条目,并不会生成 [[wants.module]] 条目。工具会为min生成一个need;只有当版本高于min时,才会生成want。
添加 [os.version] 部分
您可以通过以下三种方式添加该部分。
尚未添加
[os.version] 部分的项目可以从前两种方法中任选其一。这两种方法均可用于编写该部分。
第三种方法还会受到以下三项限制:
-
--dry-run可预览更改项,但不会实际写入。 -
已存在
[os.version]时,这种方法仅写入min,不会更改target。因此,旧版[os]部分可用作现有部分。要更改target,请运行vega project update-manifest。
[[needs.module]] 和 [[wants.module]] 条目,请运行vega project update-manifest。

