用途:本技能覆盖 DCloud 官方命令行工具包装器 @dcloudio/hbuilderx-cli,让开发者通过终端或 npm scripts 使用 HBuilderX 功能,无需手动操作 IDE,适用于 Web、Android、iOS、HarmonyOS 及微信/支付宝/抖音小程序等多平台开发。
主要能力:hbuilderx 为通用包装器,可透传参数并自动启动 HBuilderX;uni-launch 启动各平台开发环境;uni-logcat 查看各平台运行日志;uni-test 运行 uni-app 自动化测试。
使用方式:全局安装 npm install -g @dcloudio/hbuilderx-cli,或本地安装 npm install @dcloudio/hbuilderx-cli --save-dev。常用命令如 uni-launch web、uni-launch app-android --deviceId emulator-5554、uni-logcat web、uni-test web --testcaseFile tests/login.test.js。可在 package.json 的 scripts 中配置,通过 npm run 调用,传参需加 --。
限制:必须已安装并运行 HBuilderX,CLI 会自动检测进程;uni-launch 需 HBuilderX 5.0+,uni-logcat 与 uni-test 需 4.87+;uni-test 需先在 HBuilderX 中安装 uni-app 自动化测试插件;iOS 自动化测试仅支持模拟器;iOS 真机开发需有效 Apple 开发者证书。自动检测失败时可设置 HBUILDERX_CLI_PATH 环境变量。IDE 本身配置、uni-app 代码编写、原生插件开发、云端打包发布不在本技能范围内。