run_hidden
Windows 下以隐藏窗口启动进程的轻量级工具(含 CLI + C 库)。
此项目包含两个 CLI 工具:run_hidden 和 run_hidden_wait。
两者使用方法完全一致。区别仅在于:前者成功启动目标程序后立即返回 0;后者等待目标程序执行完毕并返回其退出码。
在 Windows 平台上,由于工具本身编译为 GUI 程序,以实现自身窗口的隐藏(否则会有命令行窗口一闪而过),而导致通过 shell 执行工具时,可能无法正常接受其退出码,但这并不是工具自身的问题,一些其他的特殊方式是可以拿到退出码的,比如:
- Windows API:
CreateProcess()+WaitForSingleObject()+GetExitCodeProcess()。- cmd 命令:
cmd /c start /wait。- PowerShell 命令:
Start-Process -Wait。
run_hidden <program> [args...]。run_hidden_wait <program> [args...]。
<program> 是要启动的可执行文件,[args...] 是传给它的参数。
例如:
run_hidden "C:\Program Files\Notepad3\Notepad3.exe" "C:\Temp\my notes.txt"
run_hidden_wait "C:\Tools\worker.exe" --mode "quick run"<program> 必须是可执行文件。在 Windows 平台上,支持相对路径和 PATH 路径。
必须至少提供 <program>;未传入任何参数时,CLI 返回 1。除程序名外,所有参数都会传给目标程序。
run_hidden()
int run_hidden(const char *cmd_line, bool is_wait);cmd_line:包含目标程序及参数的单个字符串(应使用系统代码页编码)。is_wait:是否等待目标程序执行完毕,然后返回其退出码。
run_hidden_w()、run_hidden_w_mut()是run_hidden()的变体,它们接受宽字符串。这主要是为了支持 Windows 平台,因为 Windows 平台原生使用宽字符串编码。当手头已有宽字符串时,使用宽字符串版本,可减少不必要的编码转换开销。而
run_hidden_w()和run_hidden_w_mut()之分,是出于 Windows API 的支持,Windows API 要求输入是可修改的,因此run_hidden_w()会分配临时缓冲区以存储输入的一份副本,再将临时缓冲区传给 Windows API。当字符串已是可修改缓冲区中的内容时,使用run_hidden_w_mut()可减少一次内存分配与数据拷贝的开销。
run_hidden_build_cmd_line()
从参数串数组解析并构造完整命令行字符串。
unsigned run_hidden_build_cmd_line(
const char *const *args, unsigned args_count,
char *out_buf, unsigned buf_len
);参数:
args:参数串数组。args_count:参数串个数。out_buf:输出缓冲区指针。为空指针用于计算长度。buf_len:输出缓冲区可写入的字节数,不包括'\0'。传入非空out_buf时,缓冲区至少需要buf_len + 1个字节;若空间不足,结果会被截断。
返回值: out_buf 为空时返回所需字节数(不包括 '\0');否则返回实际写入的字节数。
run_hidden_build_cmd_line_from_argv()(宏)
从来自 main 函数的 argc 和 argv 解析并构造完整命令行字符串(忽略 argv[0])。
#define run_hidden_build_cmd_line_from_argv(argc, argv, out_buf, buf_len) \
run_hidden_build_cmd_line((argv) + 1, (argc) - 1, out_buf, buf_len)这是一个调用 API 函数 run_hidden_build_cmd_line() 的宏。
⚠️ 注意:此宏参数argc和argv的顺序与run_hidden_build_cmd_line()相反。
环境要求:CPM.cmake。
在 CMakeLists.txt 中:
include(${PROJECT_SOURCE_DIR}/cmake/CPM.cmake)
CPMAddPackage("gh:mtueih/run_hidden#v0.5.1")在 CMakeLists.txt 中:
find_package(run_hidden REQUIRED)在 CMakeLists.txt 中:
target_link_libraries(your_target PRIVATE run_hidden::run_hidden)#include <run_hidden/run_hidden.h>run_hidden("\"C:\\Program Files\\Notepad3\\Notepad3.exe\" temp.txt", false);- 操作系统:Windows XP+。
- 构建工具:CMake 3.24+。
- C 编译器:支持 C99+ 的 C 编译器。
- 生成工具:Ninja、make 等。
git clone https://github.com/mtueih/run_hidden.git --depth 1 -b v0.5.1
cd run_hiddencmake -B build -DCMAKE_BUILD_TYPE=Release -DRUN_HIDDEN_INSTALL_LIB=ON -DRUN_HIDDEN_INSTALL_CLI=ON
cmake --build build --config Release --parallel
cmake --install build --config Release --strip --prefix install有关上述命令的说明:
- 配置命令。通过
-DRUN_HIDDEN_INSTALL_LIB=ON与-DRUN_HIDDEN_INSTALL_CLI=ON分别启用了库与 CLI 工具的安装,你可以按需安装,如果不需要安装某一个,将对应选项删除即可。 - 安装命令。通过
--prefix install将产物安装在了install目录下,而不是全局安装,以便你按自己的方式使用安装产物。如果你希望全局安装,则删除它即可。