HTML一键打包EXE工具扩展API参考
HTML一键打包EXE工具支持一些原生的API, 可以直接在HTML里面通过JS调用, 可以很方便扩展HTML功能:
点击进入CSDN免费下载地址
提示: 在使用HTML一键打包EXE工具提供的API之前, 您需要在打包时的高级配置页面勾选上开启API支持, 如下图所示:
机器码API
机器码API可以用于实现自己的认证逻辑
window.HTMLPackHelper.machineCode;窗口控制API
最大化窗口
window.HTMLPackHelper.maximize();最小化窗口
window.HTMLPackHelper.minimize();恢复窗口大小
window.HTMLPackHelper.restore();关闭应用
window.HTMLPackHelper.close();切换全屏状态API
window.HTMLPackHelper.toggleFullscreen();返回主页API
window.HTMLPackHelper.backToHomePage();打开运行本地文件API
window.HTMLPackHelper.open(path);其中path为本地文件路径,支持相对路径和绝对路径
例如:
window.HTMLPackHelper.open('C:/Windows/notepad.exe');//打开记事本window.HTMLPackHelper.open('my.docx');//打开exe所在目录的my.docx文件打开调试窗口
window.HTMLPackHelper.openDebug();本地存储API
获取当前存储数据的大小(单位字节)
window.HTMLPackHelper.getStorageSize();获取数据
window.HTMLPackHelper.get(key);// key为字符串写入数据
window.HTMLPackHelper.set(key,value);//key为字符串,value为要保存的字符串的值清除所有数据
window.HTMLPackHelper.clear();获取剪切板字符串API
window.HTMLPackHelper.getClipboardString();//返回剪切板的字符串闪烁窗口API:
开始闪烁:
window.HTMLPackHelper.flashWindow();停止闪烁:
window.HTMLPackHelper.stopFlashWindow();清理缓存API:
window.HTMLPackHelper.clearAllCache();关闭计算机API
window.HTMLPackHelper.shutdownSystem();// 调用后可以关闭电脑获取唯一机器码:
window.HTMLPackHelper.getUniqueMachineCode();//调用后可获取唯一机器码,相比机器码API更加稳定浏览器打开网址API:
window.HTMLPackHelper.openUrlInBrowser('https://cn.bing.com');退出回调API:
window.HTMLPackHelper.onQuit=()=>{// 你的业务逻辑// return false: 处理完成后不关闭程序// return true: 处理完成后关闭程序returnfalse;};获取Mac地址API:
打包的时候勾选启用API, 然后在HTML页面里,即可获取电脑的Mac地址信息:
// 返回结果类似 0b:00:28:00:00:0cwindow.HTMLPackHelper.getMac();串口通信API:
获取SerialPort类示例代码如下:
constSerialPort=HTMLPackHelper.getSerialPort().SerialPort;详细使用说明可以参考serialport官方文档
获取命令行参数:
HTMLPackerHelper.getArgv();返回结果是一个array, 其中第一个值是当前EXE所在的路径,后续的值即为打开EXE所使用的命令行参数, 如下图所示
读写文件api
// 获取用户目录下的dd.ini文件, 如果不存在则会抛出异常constcontent=HTMLPackHelper.getFileContent('dd.ini');// 获取用户目录下的dd.ini文件, 如果不存在则会返回defaultconstcontent=HTMLPackHelper.getFileContent('dd.ini','default');// 向用户目录的dd.ini文件写入"ddd"HTMLPackHelper.writeFileContent('dd.ini','ddd');获取版本号API
获取打包时配置的应用版本号,可用于在页面中展示当前软件版本、做版本比较或版本提示、自动更新等场景。
// 返回打包时配置的版本号字符串,如 "1.2.0.0",未配置时默认返回 "1.0.0.0"constversion=window.HTMLPackHelper.getVersion();设置请求头API
用于在发起网络请求时动态添加自定义 HTTP 请求头,常见使用场景包括:携带身份认证 Token、设置自定义来源标识、绕过某些需要特定请求头的接口限制等。
设置请求头
// urlPattern 为匹配请求 URL 的字符串或通配符模式// headers 为包含请求头键值对的对象window.HTMLPackHelper.setRequestHeaders('https://api.example.com/*',{Authorization:'Bearer your-token','X-Custom-Header':'value',});移除请求头
// 移除之前为指定 URL 模式设置的自定义请求头window.HTMLPackHelper.removeRequestHeaders('https://api.example.com/*');