as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
跳转到主要内容
[os.version] 部分声明了您应用支持的设备操作系统版本范围。Vega会在构建时验证此部分,而Vega打包工具 (VPT) 也会在打包应用时再次验证。 自Vega SDK 0.24起,必须含有[os.version]部分。缺少该部分会导致构建失败。
截至Vega SDK 0.24,操作系统1.2是唯一正式发布的版本,因此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。
要通过命令行验证清单的操作系统版本配置,请运行vega project doctor。要生成 [[needs.module]] 和 [[wants.module]] 条目,请运行vega project update-manifest。

相关主题

最后修改于 2026年10月26日