JPwise-docs

Appearance

HBuilder 打包部署手册 ​

一、环境准备 ​

1.1 开发工具 ​

  • HBuilderX：版本建议 3.0 以上
  • Node.js：版本建议 16.17.1

1.2 项目环境配置 ​

项目支持多个环境，在 utils/define.js 中进行配置：

二、打包前准备 ​

2.1 环境配置修改 ​

  1. 修改环境配置文件 utils/define.js：
javascript
// 根据需要部署的环境，修改 baseURL
const baseURL =
  process.env.NODE_ENV === "production"
    ? "http://sh.goodwaysoft.com:8089" // 生产环境地址
    : "http://10.10.1.205:30000"; // 开发环境地址
  1. 如果需要集成其他 app 则需要配置以下内容，具体参照：
    • 如果需要集成其他 app 则需要配置以下内容，具体参照钉钉部署和企业微信部署
    • SSO 登录地址：ssoLoginUrlPCRoot、ssoLoginUrlMobile
    • 企业微信配置：qyhCorpId、qyhAgentId
    • 钉钉配置：dingCorpId

三、HBuilder 打包步骤 ​

3.1 H5 网页打包 ​

  1. 打开 HBuilderX，加载项目

  2. 选择发布类型

    • 点击菜单：发行 → 网站-PC Web或手机H5

  3. 配置打包参数

    • 网站标题：输入应用名称
    • 网站域名：输入部署域名（如：http://sh.goodwaysoft.com:8089）
    • 运行基础路径：根据部署路径设置（默认为 /）

  4. 选择发布目录

    • 建议选择：unpackage/dist/build/h5

  5. 点击"发行"按钮，等待打包完成

3.3 APP 打包（如需要） ​

  1. 云打包

    • 点击菜单：发行 → 原生App-云打包
    • 选择打包平台（Android/iOS）
    • 配置证书信息
    • 点击"打包"按钮

  2. 离线打包

    • 点击菜单：发行 → 原生App-本地打包
    • 生成本地打包资源
    • 使用 Android Studio 或 Xcode 进行原生打包

四、部署到服务器 ​

4.1 部署前检查 ​

  1. 检查打包文件

    • H5：检查 unpackage/dist/build/h5 目录
    • 确认 index.html 文件存在
    • 确认静态资源文件完整

  2. 准备服务器

    • 确保服务器已安装 Web 服务器（Nginx/Apache）
    • 确保服务器端口开放（默认 80/443）
    • 确保有足够的磁盘空间

4.2 上传文件到服务器 ​

  1. 上传文件：unpackage/dist/build/h5/ 目录
  2. 使用 nginx 或其他方式启动，自行定义端口号