CodeMix使用教程：构建管道和验证

在CodeMix中构建管道和验证

CodeMix利用通过CodeMix增强任务定义的构建管道来生成项目的单一权威构建。 使用构建管道，用户可以使用外部工具进行构建和验证，并直接在编辑器中查看结果。 通过使用通常用于构建应用程序以进行部署的相同工具，您可以确保在IDE中具有一致的开发体验。

CodeMix通过自动为Angular和TypeScript项目创建模板tasks.json文件来简化构建管道。 对于其他类型的项目，可以手动修改tasks.json文件以包含构建管道支持。

CodeMix插件与基于Eclipse的IDE和工具（如MyEclipse、Spring Tools Suite和JBoss Tools）兼容，因此用户可以继续在习惯的环境中工作。

验证

CodeMix支持两种验证模式：编辑器内验证和项目验证。

编辑器内验证

编辑器内验证对CodeMix编辑器中打开的所有文件都有效。 此验证由VS Code或已安装的代码扩展提供的验证逻辑支持。 验证通常是即时的，当您键入时，错误在编辑器中出现或消失，而无需保存文件。 在许多情况下，打开的依赖文件也会立即得到验证。

项目验证

项目验证会更新文件中的错误和警告标记。 这些标记显示在资源管理器视图中，以及“项目”和“标记”视图中。 项目验证会影响项目中未在编辑器中打开的文件。 对于在编辑器中打开的文件，编辑器内验证仍然有效。

默认情况下启用项目验证，但可以在项目的“属性”>“CodeMix”>“验证和构建”页面上更改此设置。

有多种模式可以启用项目级验证。根据用户需求选择最佳模式：

• 单击Build图标开始观看（推荐）

单击编辑器底部的构建图标以开始监视项目 - 构建图标将更改为监视图标，以指示项目当前正在被监视。单击监视图标以停止观察项目。在此模式下，保存正在编辑的源文件时会自动触发验证。这是默认选项，是正在进行开发的最佳选项。

• 始终在此IDE运行时注意更改

此模式类似于上述模式，但无需单击构建图标即可开始观看 - 只要IDE正在运行，项目就会被监视。编辑器中的监视图标表示当前监视状态。要停止观察项目，请更改“验证和构建属性”页面上的设置。此模式非常适合持续开发的项目，包括从IDE外部接收更改的项目。为多个项目选择此选项时要小心，因为每个监视项目消耗的内存越多。

• 单击“生成”图标以启动一次性生成

在此模式下，CodeMix不会监视项目对文件所做的更改。对于完整的项目构建，请单击编辑器内构建图标。除非再次显式启动构建，否则构建后所做的更改不会更新标记状态。此模式最大限度地减少了IDE使用的资源，非常适合仅定期开发或几乎没有现代Web更改的项目。

• 禁用构建图标;使用CodeMix触发Project> Build Now

此模式与上述模式相同，但编辑器中未显示任何图标。要启动构建，请选择Project> Build Now with CodeMix。

有关显示在编辑器右下角的图标的说明，请参阅编辑器图标表。

任务和构建管道

CodeMix利用通过CodeMix增强任务定义的构建管道来生成项目的单一权威构建。 使用构建管道，可以使用外部工具进行构建和验证，并直接在编辑器中查看结果。 通过使用通常用于构建应用程序以进行部署的相同工具，可以确保在IDE中具有一致的开发体验。

为Angular和TypeScript项目构建管道

对于Angular和TypeScript项目，CodeMix通过在创建新项目，导入现有项目或从早期版本的Webclipse或Angular IDE升级时自动创建模板tasks.json文件来简化构建管道。 如果需要创建tasks.json文件，请使用CodeMix编辑器打开项目中的任何文件，单击构建图标上的下拉箭头，然后选择Add tasks.json for Angular CLI / TypeScript。

高级提示：tasks.json文件位于<project_root> / .vscode。如果项目在使用CodeMix 2.0访问之前已经有了tasks.json文件，CodeMix将不会自动添加构建管道集成。可以手动添加集成，或删除tasks.json文件，并让CodeMix重新创建它，如上所述。

为其他项目构建管道

目前，CodeMix没有为其他类型的项目自动构建管道集成，但可以手动修改tasks.json文件以使用构建管道支持。

启用构建管道

如果tasks.json文件中的任务配置为使用CodeMix构建管道，则在项目的CodeMix> Validation and Build属性页面上将有一个Use tasks.json复选框。选中此复选框以确保外部任务用于构建和项目验证。

如果清除该复选框，如果没有扩充的tasks.json，或者如果没有tasks.json文件，CodeMix将使用内部可用的工具验证项目。

建立和验证

CodeMix有许多不同的验证模式。启用外部构建任务时，这些模式的工作方式完全相同，但执行tasks.json中的外部任务而不是使用内部验证逻辑。

根据验证首选项，IDE会自动执行构建任务或监视任务，并使用配置为任务定义一部分的问题匹配器来解析输出。输出中报告的问题在IDE中标记，与右侧行号中的相应文件相对应 - 不再需要详细扫描输出并手动匹配报告的工作区资源错误。

编辑图标

如果启用了项目验证，则编辑器窗口右下角将显示以下图标。

增加构建管道集成的任务

tasks.json的示例：

观察codemix节点下的属性：

• 生命周期属性可以具有以下三个值之一：构建，监视，以及用于Angular项目的服务。 此属性的值确定是在IDE中的监视，一次性构建还是服务请求期间运行任务。

• validatedExtensions是一个扩展列表，用于指定在保存时触发构建/监视的文件类型，以及从外部任务标识的问题中添加哪些标记。

• readyChecks确保在启动任何监视或构建任务之前满足指定的条件。

生命周期属性确定CodeMix如何将任务与构建管道集成。 即使没有生命周期属性，还有其他智能可以自动将某些TypeScript或shell任务集成到构建管道中，但为了清晰起见，我们建议添加此值。

有关更多详细信息，请参阅 Tasks in CodeMix with tasks.json.