as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
应用依赖项分为两组,由Vega采用不同方法进行管理。本指南阐述了解析和安装每种依赖项所使用的工具,以及操作系统目标版本选择程序包版本的流程。 操作系统提供的Vega包带有@amazon-devices/前缀,例如@amazon-devices/kepler-camera。您的[os.version]目标会限制应用可使用这些包的哪些版本,并由vega project install为您解析。普通npm包(例如react和lodash)则按一贯方式解析,即通过您的包管理器。 您的包管理器会安装这两类包。vega project从不会替您运行它。相反,vega project会针对您的操作系统版本目标解析出系统提供包的正确版本,并将它们写入package.json。随后,您运行自己的包管理器(例如npm、yarn或pnpm)来下载并安装它们。

解析、安装和构建链

开始之前,请确认您的manifest.toml具有[os.version]部分。vega project install --fix会从该部分解析您的操作系统目标,因此在没有该部分的项目上,它会以Missing OS Version失败,且不写入任何内容。如需用一条命令创建该部分并重新对齐,请同时添加两个标志:vega project install --fix --os-min 1.2 --os-version 2.0。有关添加该部分的其他方式,请参阅清单 [os.version] 部分。 要将项目从已解析版本转换为已构建应用,请运行以下命令。
  1. vega project install --fix会为每个@amazon-devices/*依赖项选取与您的[os.version].target兼容的最新已发布版本,然后将这些版本写入package.json。它不会下载任何内容,也不会更改node_modules文件夹。
  2. npm install会下载并安装vega project install所写入的版本。使用项目当前所用的程序包管理器即可。
  3. vega project doctor会在您构建之前对项目进行验证。失败时会以非零状态退出,因此可作为CI管道门禁。
  4. npx react-native build-vega会构建您的应用并生成vpkg.您也可以使用package.json中的构建脚本。
有关命令和选项的完整详情,请参阅Vega SDK CLI引用。

操作系统目标版本选择程序包版本的流程

您的manifest.toml中的[os.version]部分决定了vega project install会解析哪些版本。
  • target - vega project install将每个@amazon-devices/*包解析为此操作系统版本可用的最新版本。
  • min - 应用支持的OS最旧版本。您的代码必须对min之后新增的API做防护,以便应用仍能在处于min的设备上运行。
不要将操作系统版本模块条目添加到您的源manifest.toml中。构建时,工具会从[os.version]生成这些条目,并写入校验、暂存和打包清单。在这些生成的清单中,位于min的操作系统版本是必填的[[needs.module]]条目,而min之后的每个操作系统版本直到target都是可选的[[wants.module]]条目。 min和target都必须是带引号的"M.n"字符串,且要指定官方正式发布的操作系统版本。否则,即使格式正确,Vega也会拒绝该值。若要以操作系统2.0为目标并仍支持操作系统1.2上的设备,请将target设为2.0,将min设为1.2。如果您的应用仅支持操作系统2.0,请将两个值都设为2.0。 有关字段定义、验证规则和模块ID格式的完整信息,请参阅清单 [os.version] 部分。

添加、更新和重新对齐程序包

下表描述了每项操作的命令。 在运行任何会重写package.json的命令后(包括install和update),请运行包管理器安装更改,然后重新构建。 update-manifest的工作方式不同。它写入manifest.toml而非package.json。它会在[os.version]中设置min和target的值,并从您的源清单中移除工具自有的操作系统版本模块条目。如果您更改target,请运行vega project install --fix将包版本重新对齐到新目标,然后运行包管理器,再重新构建。

选择程序包管理器

vega project类命令仅写入package.json。它们绝不会调用npm、yarn或pnpm。使用项目当前所用的程序包管理器即可。解析出的@amazon-devices/*版本是普通的package.json条目,任何兼容npm的包管理器都会以相同方式安装它们。

相关主题

最后修改于 2026年10月13日