完整教程：Qt开发经验 --- qmake执行系统命令（15）

文章目录

• • @[toc]
  • 1 与其它方法的比较
  • 2 程序依赖文件自动安装（INSTALLS）
  • 3 链接阶段开始之前执行自定义命令（QMAKE_PRE_LINK ）
  • 4 链接阶段完成后执行自定义命令（QMAKE_POST_LINK）
  • 5 qmake中使用system()执行系统命令

更多精彩内容

内容导航

Qt开发经验

---

1 与其它方法的比较

方法	优点	缺点
system()	灵活，可执行任意命令	平台依赖，错误处理困难
INSTALLS	跨平台，Qt原生支持	仅用于安装阶段，使用较复杂
QMAKE_POST_LINK	构建后执行，适合拷贝	平台依赖，仅在链接后执行
QMAKE_PRE_LINK	构建后执行，适合拷贝	平台依赖，仅在链接前执行

2 程序依赖文件自动安装（INSTALLS）

• 有时候我们程序会使用到依赖文件，而我们又不想把文件放到资源文件中，这就导致了每次编译、修改后都需要手动拷贝到当前文件夹下，非常麻烦；

• 其实我们可以通过QMake来设置，在pro文件中使用INSTALLS来将指定文件安装到指定路径

  webFile.path = $$path # 文件安装路径
  webFile.files = $$PWD/lib # 文件/文件夹原本位置
  INSTALLS += webFile

• 注意： 只是设置了上面代码，编译后不会生效，需要手动输入下列命令来将文件安装到指定路径；

  • msvc编译器：nmake install或者jom.exe install；
  • MinGW编译器：mingw32-make install;
  • gcc编译器：make install
  • 注意：如果这些make没有环境变量，则不一定执行成功，可以使用绝对路径，例如：D:\Qt\Qt5.12.5\Tools\QtCreator\bin\jom.exe install

• 或者选择【项目】->【使用的编译器】->【添加Build步骤】->【Custom Process Step】，输入安装命令，然后编译完成后就可以在path路径下看见lib文件夹了。

  

3 链接阶段开始之前执行自定义命令（QMAKE_PRE_LINK ）

QMAKE_PRE_LINK 是 qmake 提供的变量，用于在链接阶段开始之前执行自定义命令。

基本概念

• 作用时机：在所有源文件编译完成之后，但在链接过程开始之前执行
• 执行环境：作为 Makefile 中链接步骤之前的预处理命令运行
• 平台相关：命令语法需要匹配目标平台（Windows使用cmd命令，Unix/Linux使用shell命令）

4 链接阶段完成后执行自定义命令（QMAKE_POST_LINK）

QMAKE_POST_LINK 是 qmake 提供的一个重要变量，用于在链接阶段完成后执行自定义命令。

基本概念

• 作用时机：在编译器完成所有目标文件链接之后，但在整个构建过程结束之前执行
• 执行环境：在生成的 Makefile 中作为后链接步骤运行
• 平台相关：命令语法需匹配目标平台（Windows使用cmd命令，Unix/Linux使用shell命令）

示例：将crashpad文件夹中文件拷贝到DESTDIR路径下；

QMAKE_POST_LINK += xcopy /D /F /E /Y \"$${PWD}/vcpkg_installed/x64-windows/tools/crashpad\" \"$${DESTDIR}\"

各部分详细说明

1. QMAKE_POST_LINK
   • qmake 变量，在链接完成后执行指定命令
   • 使用 += 操作符将命令追加到现有命令列表
2. xcopy
   • Windows 系统下的文件和目录复制命令
   • 比 copy 命令功能更强大，支持目录递归复制
3. 参数详解：
   • /D - 只复制源文件中较新或目标不存在的文件（日期比较）
   • /F - 显示每个被复制文件的完整源路径和目标路径
   • /E - 复制所有子目录，包括空目录
   • /Y - 覆盖现有文件时不提示确认
   • /Q - 复制时不显示文件名
   • /S - 复制目录和子目录，但不包括空目录
   • /H - 复制隐藏和系统文件
   • /K - 复制属性信息
   • /R - 覆盖只读文件
   • /I - 如果目标不存在且正在复制多个文件，则假定目标是目录
4. 源路径：\"$${PWD}/vcpkg_installed/x64-windows/tools/crashpad\"
   • $${PWD} - 当前项目工作目录
   • vcpkg_installed/x64-windows/tools/crashpad - vcpkg 安装的 crashpad 工具目录
   • 双引号防止路径中空格导致的问题
5. 目标路径：\"$${DESTDIR}\"
   • $${DESTDIR} - qmake 定义的目标输出目录
   • 通常是可执行文件的输出位置

执行时机和目的

• 执行时机：整个项目编译链接完成后自动执行
• 主要目的：将 crashpad 相关工具文件复制到可执行文件所在目录
• 实际效果：确保生成的程序能够找到所需的 crashpad 工具（如 crashpad_handler.exe）

使用场景

1. Crash Reporting - 复制 crashpad 崩溃报告工具
2. 依赖文件部署 - 将运行时需要的工具文件复制到输出目录
3. vcpkg 集成 - 处理通过 vcpkg 安装的第三方工具文件

注意事项

1. 路径存在性：确保源目录 vcpkg_installed/x64-windows/tools/crashpad 存在
2. 权限要求：需要有读取源目录和写入目标目录的权限
3. 平台限制：xcopy 是 Windows 特有命令，不适用于 Unix/Linux 系统
4. 转义字符：路径中的双引号需要使用反斜杠转义

5 qmake中使用system()执行系统命令

在qmake中，system()函数用于执行系统命令，常用于在构建过程中执行外部命令，包括文件拷贝操作。

使用场景

1. 文件拷贝
2. 目录操作
3. 外部工具调用
4. 构建前/后处理

使用示例

# windows复制文件
system(xcopy /D /F /Y \"$${PWD}/config.ini\" \"$${DESTDIR}\")
# linux复制单个文件
system(cp $$PWD/config.ini $$DESTDIR/)
# windows查看文件
system(dir)
# linux查看文件
system(ls -l)

---

---