一、CLI 概述
HBuilderX cli命令行工具, 仅适用于HBuilderX 3.1.5+版本
1. cli 程序
先科普一下 cli 是什么? CLI(command-line interface,命令行界面)可在用户提示符下键入可执行指令的界面。CLI是Command Line Interface的缩写,即命令行界面。
看文字大家是不是有点懵,那看下图是不是瞬间醒悟?没错就是这个!
2. Hbuildx 的 cli
为什么要说是 Hbuildx 的 cli 呢?
因为当前的 cli 只能为我们的 Hbuildx 去服务的!开发者可以通过cli命令行指示HBuilderX进行启动、打包、登录等操作。
命令行工具所在位置:
Windows: HBuilderX安装目录根目录, cli.exe
MacOSX
正式版 /Applications/HBuilderX.app/Contents/MacOS/cli
Alpha版 /Applications/HBuilderX-Alpha.app/Contents/MacOS/cli
特别注意:本文所有命令示例,均以cli代替cli.exe,请根据不同操作系统,实际应用。
今天主要演示 Windows 大家可以看下图,大家可以看到一下 cli.exe的文件,或者清空路径输入 cmd,打开黑窗口,这个就是当前为我们 Hbuildx 服务的CLI所在位置!
3. cli 基础命令
通过上一步的介绍,我们已经找到 Hbuildx 的cli工具了,那么我们可以通过 cli 去做一下基本的操作;如果不是通过我第二步打开的朋友,在全局是找不到当前 Hbuildx 的cli 的,后边我会带着大家配置全局的环境变量;
查看帮助文档
查看帮助文档,需要先启动Hbuildx;不然就会出现下图的问题
cli --help // 查看帮助文档 cli help // 查看帮助文档
查看 cli 版本号
cli ver
启动/关闭 Hbuildx
1. # 启动HBuilderX程序 2. cli open 3. 4. # 关闭HBuilderX程序 5. cli app quit
更多命令行
二、CLI 全局变量配置
通过上面的步骤我们已经可以成功启动当前 Hbuildx 安装目录下的 cli 工具了;
但是我们全局的 CMD 还是找不到我们的 cli工具,这种情况就需要在全局的环境变量里面配置了
1. Windows 配置全局环境变量
① 复制HBuilderX安装目录路径(即HBuilderX.exe程序所在位置的上级目录)
②右键 This PC(此电脑) -> Properties(属性) -> Advanced system settings(高级系统设置) -> Environment Variables(环境变量)
③【用户变量】,点击【编辑】,找到path,输入HBuilderX路径。
点击新建,把刚才第一步复制的路径 Copy 进来
④校验一下是否配置成功
【 Window + R 】 输入 cmd 打开命令行窗口
1. #查看当前配置是否成功 2. 3. 输入 cli ver 4.
2. MacOSX 配置全局环境变量
① 方法一:添加环境变量
警告: 修改环境变量时,请
慎重
仔细
,如果没有经验,不建议修改环境变量。
如果您的shell是bash
,进入终端,编辑环境变量文件~/.bash_profile
, 输入如下内容
如果您的shell是zsh
,进入终端,编辑环境变量文件~/.zprofile
,输入如下内容
export HX_HOME=/Applications/HBuilderX.app/Contents/MacOS/ export PATH=$HX_HOME:$PATH:.
②方法二:创建别名
打开终端,根据shell类型,执行如下命令:
# shell类型:bash echo "alias cli='/Applications/HBuilderX.app/Contents/MacOS/cli'" >> ~/.bashrc && source ~/.bashrc # shell类型:zsh echo "alias cli='/Applications/HBuilderX.app/Contents/MacOS/cli'" >> ~/.zshrc && source ~/.zshrc
③方法三:创建软连接
打开终端,执行如下命令:
ln -s /Applications/HBuilderX.app/Contents/MacOS/cli /usr/local/bin/cli