背景

在开发UniApp项目时,打包H5版本通常需要在HBuilderX中手动点击「发行 -> 网站-PC Web」,操作繁琐且无法集成到自动化发布流程中。本文介绍如何通过HBuilderX CLI工具实现命令行打包。

环境准备

1. 安装HBuilderX

从官网下载并安装HBuilderX:https://www.dcloud.io/hbuilderx.html

2. 登录账号

首次使用CLI前,需要在HBuilderX图形界面中登录账号(只需登录一次)。

3. CLI工具路径

[安装目录]\HBuilderX\cli.exe

打包命令

命令格式

"[HBuilderX安装路径]\cli.exe" publish --platform H5 --project "[项目路径]"

参数说明

参数 说明
publish 发布命令
–platform H5 指定发布平台为H5
–project 指定项目路径

使用示例

"D:\Program Files\HBuilderX\cli.exe" publish --platform H5 --project "D:\project\myapp"

输出结果

打包完成后,H5文件输出到:

项目根目录/unpackage/dist/build/web/

包含:

  • index.html - 入口文件
  • static/ - 静态资源
  • assets/ - 资源文件

常见问题

Q1: 提示需要登录?

A: 首次使用需先在HBuilderX图形界面登录账号

Q2: 返回码0但没有生成文件?

A: CLI后台执行需要等待几秒,检查输出目录

Q3: 报错"无法创建文件"?

A: 关闭HBuilderX,确保目录可写

注意事项

  1. 使用绝对路径,避免中文或特殊字符
  2. 确保项目目录有读写权限
  3. 不同版本HBuilderX的CLI参数可能略有差异
Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐