uniapp 自动构建
uniapp 自动构建实现方法
uniapp 的自动构建可以通过多种方式实现,包括使用 CI/CD 工具、脚本自动化以及云服务等。以下是几种常见的实现方案:
使用 HBuilderX 的 CLI 工具
HBuilderX 提供了命令行工具,可以通过脚本触发自动构建。安装 HBuilderX 后,在项目根目录下执行以下命令:
cli publish --platform mp-weixin --project 项目名称
此命令会触发微信小程序的构建和发布。其他平台如 h5、mp-alipay 等可通过替换 --platform 参数实现。

结合 Jenkins 或 GitHub Actions
通过 CI/CD 工具可以实现代码提交后自动触发构建。例如,使用 GitHub Actions 的配置示例:
name: Uniapp Build
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Install dependencies
run: npm install
- name: Build for H5
run: npm run build:h5
此配置会在代码推送到仓库时自动执行 H5 版本的构建。

使用云服务如 uni-cloud
uni-cloud 提供了云端构建能力,可以通过 API 或控制台触发自动构建。在 uni-config.json 中配置云函数后,调用云函数即可触发构建流程。
自定义脚本自动化
在 package.json 中配置自定义脚本,结合跨平台参数实现多端构建:
{
"scripts": {
"build:mp-weixin": "cross-env NODE_ENV=production UNI_PLATFORM=mp-weixin vue-cli-service uni-build",
"build:h5": "cross-env NODE_ENV=production UNI_PLATFORM=h5 vue-cli-service uni-build"
}
}
通过 npm run build:mp-weixin 或 npm run build:h5 即可触发对应平台的构建。
注意事项
- 确保构建环境依赖(如 Node.js、HBuilderX CLI)已正确安装。
- 不同平台的构建配置可能需要单独处理,例如微信小程序需要配置
appid。 - 自动构建后的产物通常需要手动或通过脚本上传到对应平台。






