外部命令能干什么呢？
外部命令可以让您在HBuilderX中通过菜单、快捷键等方式调用外部程序或命令行
使用场景
- 压缩图片
- 文档转换（比如markdown转pdf）
- 调用python、shell脚本
- 打开本地的某个程序
- 传输文件到服务器
- 操作服务器的某些服务（如启动、停止、重启nginx)
- 下载文件
- 安装apk到手机
- 其它的自动化操作
外部命令在哪里？
菜单【工具】-->【外部命令】-->【自定义外部命令】
如下图，您可以看到几个例子
image.png
外部命令怎么用？
点击菜单【工具】-->【外部命令】-->【自定义外部命令】，就可以自定义外部命令
最后再介绍吧，先看几个例子。
例子1：调用外部python、shell等脚本
[{
"name":"调用python脚本",
"command":"python script.py",
"type" : "terminal",
"key":"alt+shift+p"
}]
例子2： 调用TinyPNG无损压缩图片
大部分情况下, 图片都是需要压缩的,为了 更快的打开网页,节省流量
推荐：TinyPNGg官网 无损压缩，良心网站，每月500张免费。
如下所示：YOUR_API_KEY是你申请的key, --output 可以指定目录文件名，注意如果和当前图片路径一致，会覆盖原先图片
[{
"name":"调用TinyPNG无损压缩图片",
"command":"curl --user api:YOUR_API_KEY --data-binary @${file} -i https://api.tinify.com/shrink --output ${file}",
"type" : "terminal",
"key":"alt+shift+m"
}]
注意：curl是mac自带的命令，windows上如需使用curl，请下载curl 安装
例子3：下载文件
mac上下载文件的命令有：wget、curl
windows上下载文件的命令是：bitsadmin.exe
[{
"name":"下载文件",
"command":"wget -c ${userInput:输入要下载的地址url}",
"type" : "terminal",
"key":"alt+shift+m"
}]
注意： ${userInput:弹框说明} 会在当前屏幕弹框,可以输入内容
例子4： Mac: 复制项目到远程linux服务器
scp是linux和mac上才能用的命令，windows上不可以使用哦
[{
"name":"scp传输项目到服务器",
"command":"scp -r ${projectDir} 用户名@ip:服务器目录路径",
"type" : "terminal",
"key":"alt+shift+m"
}]
例子5： 远程linux服务器 重启/启动nginx服务
[{
"name":"远程服务器重启nginx",
"command":"ssh 用户@ip '/opt/nginx/sbin/nginx -s reload'",
"type" : "terminal",
"key":""
},
{
"name":"远程服务器重启nginx",
"command":"ssh 用户@ip '/opt/nginx/sbin/nginx'",
"type" : "terminal",
"key":""
}]
例子6： 使用pandoc转markdown为pdf、doc、html
pandoc是什么？
pandoc是一个软件，是一个能把千奇百怪的文档格式互相转换的神器，是一把文档转换的瑞士军刀。
安装后，可以通过命令调用。pandoc官网
pandoc结合外部命令的例子
[{
"name": "Pandoc转md为pdf",
"command": "pandoc ${file} -o ${fileBasename}.pdf",
"type": "terminal",
"key": ""
},
{
"name": "Pandoc转md为doc",
"command": "pandoc ${file} -o ${fileBasename}.docx",
"type": "terminal",
"key": ""
},
{
"name": "Pandoc转md为html",
"command": "pandoc ${file} -o ${fileBasename}.html",
"type": "terminal",
"key": ""
}
]
例子7： 安装apk到Android手机
[
{
"name": "安装apk到android手机",
"command": "adb install ${file}",
"type": "terminal",
"key": ""
}
]
外部命令通过key配置快捷键
如上的例子，key，可以配置快捷键哦
{
"name":"scp传输项目到服务器",
"command":"scp -r ${projectDir} 用户名@ip:服务器目录路径",
"type" : "terminal",
"key":"alt+shift+m"
}
使用外部命令注意事项
因为变量和快捷键，所以外部命令强大。
//------------外部命令 变量说明------------//
"command"、"workingDir"中可使用预定义的变量来获取当前文件的路径信息
${file} 当前文件的完整路径，比如 D:\files\test.txt
${fileName} 当前文件的文件名，比如 test.txt
${fileExtension} 当前文件的扩展名，比如 txt
${fileBasename} 当前文件仅包含文件名的部分，比如 test
${fileDir} 当前文件所在目录的完整路径，比如 D:\files
${projectDir} 当前文件所在项目的完整路径，只有当前文件是项目管理器中某个项目下的文件时才起作用
示例传送门
示例传送门，github External-commands.json
复制粘贴即可使用
