本文档介绍了支持 VTJ 开发和部署的命令行界面工具、构建过程和项目基架系统。它解释了开发人员如何通过 CLI 命令与 VTJ 交互，monorepo 构建系统如何工作，以及如何创建和配置新项目。
有关核心引擎体系结构的信息，请参阅核心体系结构 。有关多平台部署的详细信息，请参阅平台实现 。
CLI 包体系结构
VTJ CLI 作为 @vtj/cli 软件包实现，该软件包用作整个 VTJ 生态系统的中央构建工具。CLI 提供了全面的构建功能，包括 Vite 配置、TypeScript 编译、测试实用程序和开发服务器管理。
CLI 包结构
CLI 包通过 vtj 二进制命令公开其功能，主要实现使用 unbuild 构建以实现最佳 Node.js 兼容性。
Monorepo 构建系统
VTJ 使用由 Lerna 和 PNPM 管理的复杂 monorepo 结构，支持跨所有软件包的协调开发和同步发布。
构建系统组件
构建系统确保所有软件包保持版本同步，目前整个 monorepo 的版本为 0.12.40。
项目脚手架系统
create-vtj 软件包提供项目基架功能，允许开发人员使用预配置的模板快速引导新的 VTJ 项目。
脚手架架构
基架系统支持多种项目类型，每种类型都配置了适用于其目标平台的适当依赖项和构建配置。
开发工作流程脚本
根 package.json 定义了一组全面的 npm 脚本，用于编排整个 VTJ 生态系统中的开发、构建和部署工作流程。
开发脚本
| 脚本类别 | 脚本示例 | 目的 |
|---|---|---|
| 开发服务器 | dev, pro:dev, app:dev | 启动不同平台的开发服务器 |
| 构建命令 | build, pro:build, web:build | 构建生产分发 |
| 测试 | test, cli:test, coverage | 运行测试套件并生成覆盖率报告 |
| 包管理 | setup, clean, reset | 管理依赖项和工作区状态 |
| 出版 | patch, minor, prerelease | 版本管理和包发布 |
构建管道流
构建管道可确保 monorepo 中所有软件包之间的协调构建和同步发布。
构建目标和平台支持
VTJ 支持多个构建目标和部署平台，每个平台都有特定的构建配置和输出格式。
平台构建矩阵
| 平台 | 包 | 构建工具 | 输出格式 | 目标环境 |
|---|---|---|---|---|
| Web | @vtj/web | Vite | ES 模块 + UMD | 现代浏览器 |
| H5 移动版 | @vtj/h5 | Vite | ES 模块 移动网页 | |
| Uni-App | @vtj/uni-app | Uni-App CLI | Multiple | iOS/Android/小程序 |
| 专业的 | @vtj/pro | Vite | 企业平台 | |
| 组件库 | @vtj/ui | unbuild | ES 模块 + CJS | 库分发 |
构建配置管理
检测和质量保证
构建系统使用 Vitest 作为主要测试运行程序，集成了全面的测试功能，并支持覆盖率报告和持续集成。
测试基础设施
| 元件 | 工具 | 目的 |
|---|---|---|
| 测试运行程序 | vitest@~3.1.2 | 单元和集成测试 |
| 覆盖 | @vitest/coverage-v8 | 代码覆盖率分析 |
| 浏览器测试 | jsdom@~26.1.0 | Vue 组件的 DOM 模拟 |
| Vue 测试 | @vue/test-utils@~2.4.5 | Vue 组件测试工具 |
CLI 软件包提供统一的测试配置，这些配置可以被 monorepo 中的所有软件包继承，从而确保整个 VTJ 生态系统的测试实践一致。