在Vega Studio中验证应用清单
在Vega Studio中验证应用清单
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。
应用清单验证通过在部署React Native或原生应用之前识别缺少的必填字段、不正确的数据类型、无效的URL和兼容性问题，从而在开发过程早期发现配置错误。
Vega SDK通过Visual Studio Code (VS Code) 的扩展程序Vega Studio，提供内置的manifest验证功能。使用Vega Studio，您可以在以下开发阶段在编辑器中获得清单验证：
- 开发 - 编辑manifest.toml文件时立即获得反馈
- 代码提交 - 防止新更改中出现验证错误
- 构建流程 - 在部署之前发现问题
- 应用提交 - 确认符合平台要求
重要须知： 本文档可能引用“Kepler Studio”（Vega Studio以前的名称）。所有功能和命令的工作方式相同。
先决条件
- 安装Vega SDK。
- 项目根目录中的有效manifest.toml文件。
- （可选）安装TOML语言支持。
注意： 无论您是否安装了TOML语言支持，Vega Studio的内置验证功能都能正常运行。TOML语言支持具有语法高亮功能，易于发现错误，可读性更佳。
检查验证
Vega Studio默认启用清单验证。验证会自动开始。
要验证它是否有效，可执行以下操作：
-
打开VS Code。
-
从活动栏中选择Vega扩展图标
，打开Vega Studio面板。 -
从Projects（项目）部分打开您的项目。
验证无法自动启动
如果验证无法自动启动，请右键单击manifest.toml并选择Validate Manifest（验证清单）。
查看验证结果
要查看验证结果，请检查PROBLEMS（问题）面板：
Mac： Cmd+Shift+M
Linux： Ctrl+Shift+M
验证错误示例
当验证检测到问题时，您会看到清晰、可操作的错误消息，例如：
Error: Missing required property 'package.id'（错误：缺少必需的属性'package.id'）
Location: Line 3, manifest.toml（位置：第3行，manifest.toml）
Fix: Add a unique identifier for your package, e.g., package.id = "com.example.myapp"（修复：为您的程序包添加唯一标识符，例如package.id = "com.example.myapp"）
操作系统版本错误示例
自SDK 0.24起，必须含有 [os.version] 部分。如果缺失，则构建失败并出现以下错误：
缺失 [os.version].target。Vega应用程序必须声明其操作系统版本。添加到manifest.toml：[os.version] target = "<版本>" min = "<版本>"或执行：vega project update-manifest --os-version <版本> --os-min <版本>
缺失 [os.version].min。声明 [os.version] 中的最低版本和目标版本。
发生不可恢复错误，Vega操作失败：vega build拒绝执行： manifest.toml中存在2处OS-version合规性错误 。请参阅上文。
要修复此问题，请在项目根目录下运行下列命令：
vega project update-manifest --os-min 1.2 --os-version 1.2
有关字段、验证规则和三种部分添加方法，请参阅清单 [os.version] 部分。有关此错误的更多详细信息，请参阅构建失败并报错“缺少 [os.version]”。
要通过命令行而非编辑器来验证操作系统版本配置，请运行vega project doctor。
相关主题
Last updated: 2026年8月19日
