zy-gbs-cmd/README.md

zy-gbs-cmd

zy-gbs-cmd 用于构建前端项目，并将构建产物提交到业务项目配置的 Java Git 仓库。

工具不调用授权接口，也不保存账号密码。Git 克隆和推送使用当前电脑已有的 Git 凭据。

环境要求

• Node.js 18 或更高版本
• Git
• Yarn

工具使用的模块均为 Node.js 内置模块，无需安装运行时依赖。

业务项目的依赖安装和项目构建只使用 Yarn；Windows 下会自动调用 yarn.cmd。

安装

安装已发布版本可以使用 npm 或 Yarn：

npm install -g zy-gbs-cmd

yarn global add zy-gbs-cmd

本地安装当前目录：

npm install -g 

业务项目配置

在业务项目根目录创建或修改 jjb.config.js：

javaGit 必须是完整的 Git 克隆地址，不能只填写 Git 服务地址。jsconfig.json

创建项目

在存放项目根目录执行：

zy-gbs-cmd create

根据提示输入项目目录名并选择模板：

1. 1.0（Ant Design 5）
2. 2.0（Ant Design 6）

工具会为 javaGit、javaGitName、appIdentifier 和 production 分支生成默认值，直接回车即可使用，也可以手动输入。appIdentifier 根据最终 javaGit 的仓库名去除 zcloud_gbs_、_gwj 后转换为小驼峰。

创建成功后模板自带的 Git 记录会被删除，工具不会自动安装依赖。进入新项目后手动执行：

yarn install

推送项目

在业务项目根目录执行：

zy-gbs-cmd push java

也可以直接指定环境：

zy-gbs-cmd push java production

指定环境后会自动执行同名构建脚本，例如 production 对应 build:production，不再询问构建命令和环境。

工具会把：

dist/index.html
dist/<appIdentifier>/

复制到 Java 仓库：

start/src/main/resources/templates/<appIdentifier>.html
start/src/main/resources/templates/<appIdentifier>/

工具只暂存和提交当前应用在 templates 下的目录及 HTML，不会提交 Java 仓库其他路径的文件。

发布到 npm Registry

登录 Registry：

yarn login

首次发布：

yarn publish

后续发布前需要先更新版本号，例如：

yarn version --patch
yarn publish