在Vega Studio中验证应用清单

应用清单验证通过在部署React Native或原生应用之前识别缺少的必填字段、不正确的数据类型、无效的URL和兼容性问题，从而在开发过程早期发现配置错误。 Vega SDK通过Visual Studio Code (VS Code) 的扩展程序Vega Studio，提供内置的manifest验证功能。使用Vega Studio，您可以在以下开发阶段在编辑器中获得清单验证：

开发 - 编辑manifest.toml文件时立即获得反馈
代码提交 - 防止新更改中出现验证错误
构建流程 - 在部署之前发现问题
应用提交 - 确认符合平台要求

先决条件

安装Vega SDK。
项目根目录中的有效manifest.toml文件。
（可选）安装TOML语言支持。

检查验证

Vega Studio默认启用清单验证。验证会自动开始。要验证它是否有效，可执行以下操作：

打开VS Code。
从活动栏中选择Vega扩展图标，打开Vega Studio面板。
从Projects（项目）部分打开您的项目。

验证无法自动启动

如果验证无法自动启动，请右键单击manifest.toml并选择Validate Manifest（验证清单）。

屏幕截图，示出了右键单击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] 部分。如果缺失，则构建失败并出现以下错误：

Missing [os.version].target. A Vega application must declare its OS version. Add to manifest.toml: [os.version] target = "<version>" min = "<version>" Or run: vega project update-manifest --os-version <version> --os-min <version>
Missing [os.version].min. Declare both min and target in [os.version].
Vega operation FAILED due to an irrecoverable error: vega build refused: 2 OS-version compliance error(s) in manifest.toml. See above.

要修复此问题，请在项目根目录下运行下列命令：

vega project update-manifest --os-min 1.2 --os-version 1.2

有关字段、验证规则和三种部分添加方法，请参阅清单 [os.version] 部分。有关此错误的更多详细信息，请参阅构建失败并报错“缺少 [os.version]”。要通过命令行而非编辑器来验证操作系统版本配置，请运行vega project doctor。

开发 Vega 应用

在Vega Studio中验证应用清单

先决条件

检查验证

验证无法自动启动

查看验证结果

验证错误示例

操作系统版本错误示例

相关主题

​先决条件

​检查验证

​验证无法自动启动

​查看验证结果

​验证错误示例

​操作系统版本错误示例

​相关主题

先决条件

检查验证

验证无法自动启动

查看验证结果

验证错误示例

操作系统版本错误示例

相关主题