@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] 部分。
要将项目从已解析版本转换为已构建应用,请运行以下命令。
-
vega project install --fix会为每个@amazon-devices/*依赖项选取与您的[os.version].target兼容的最新已发布版本,然后将这些版本写入package.json。它不会下载任何内容,也不会更改node_modules文件夹。 -
npm install会下载并安装vega project install所写入的版本。使用项目当前所用的程序包管理器即可。 -
vega project doctor会在您构建之前对项目进行验证。失败时会以非零状态退出,因此可作为CI管道门禁。 -
npx react-native build-vega会构建您的应用并生成vpkg.您也可以使用package.json中的构建脚本。
操作系统目标版本选择程序包版本的流程
您的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的包管理器都会以相同方式安装它们。

