更新记录

1.0.0（2026-03-19） 下载此版本

插件获取的oss以及服务器链接信息均存储在本地。

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

DevOps自动部署工具

HBuilder X插件，用于自动打包和部署uni-app项目的H5和WGT包。

功能特性

1. H5打包部署

• 自动打包H5项目
• 通过SSH上传到指定服务器
• 支持按项目配置不同的服务器信息

2. WGT打包部署

• 自动打包WGT文件
• 上传到阿里云OSS
• 自动更新数据库版本信息
• 支持配置更新类型、更新内容、热更新版本号等

安装

1. 将插件目录复制到HBuilderX的插件目录
2. 重启HBuilderX
3. 在菜单栏"发行"中可以看到相关命令

使用方法

H5部署

1. 点击"发行" -> "DevOps部署配置" -> "设置H5部署配置"
2. 填写SSH服务器信息：
   • 服务器IP
   • SSH用户名
   • SSH密码
   • 上传路径
3. 点击"发行" -> "打包H5"即可自动打包并上传

WGT部署

1. 点击"发行" -> "DevOps部署配置" -> "设置WGT部署配置"
2. 填写配置信息：
   • 阿里云OSS配置（AccessKeyId、AccessKeySecret、Bucket、Region）
   • 数据库配置（IP、用户名、密码、数据库名）
   • 版本信息（租户编号、APP类型、更新类型、更新内容、热更新版本号）
3. 点击"发行" -> "打包WGT"即可自动打包、上传OSS并更新数据库
4. 根据自己版本控制的数据库表，去修改/utils/dbUpdate.js的sql脚本

配置说明

APP类型

• 0: 安卓
• 1: iOS

更新类型

• 0: 不用更新
• 1: 更新(非强制)
• 2: 更新(强制)

依赖

• ssh2: SSH文件传输
• ali-oss: 阿里云OSS上传
• mysql2: MySQL数据库操作

注意事项

1. 配置信息按项目的appid分别保存，不同项目可以有不同的配置
2. WGT打包会自动根据manifest.json中的版本号命名
3. 数据库更新会根据租户编号和APP类型匹配记录进行更新
4. OSS上传的文件会自动添加时间戳避免重复

目录结构

devops/
├── commands/           # 命令实现
│   ├── buildH5.js     # H5打包
│   ├── buildWgt.js    # WGT打包
│   ├── setConfigH5.js # H5配置
│   └── setConfigWgt.js# WGT配置
├── utils/             # 工具函数
│   ├── hx.js         # HBuilderX辅助函数
│   ├── sendFile.js   # SSH文件上传
│   ├── ossUpload.js  # OSS上传
│   └── dbUpdate.js   # 数据库更新
├── extension.js       # 插件入口
└── package.json       # 插件配置

开发调试

1. 在HBuilderX中打开本插件工程
2. 按下Ctrl+r运行插件，会打开一个新的HBuilderX窗口
3. 在新窗口中测试插件功能
4. 修改代码后需要重新运行（连续按Ctrl+r停止并重新运行）