visual-studio - 如何将 Qt 的 Windeployqt 集成为 Visual Studio 构建工作流程的一部分？

Question

每次在 Visual Studio 中首次构建新的 Qt 项目时，即使安装了 VS Tools，我也必须复制一些与 Qt 相关的二进制文件(Qt5Core.dll、平台文件...)。否则，当从 Visual Studio 运行时，可以正确找到 Qt5Core.dll(或调试一个)，但找不到平台 DLL:

显然，当从 IDE 外部运行完成时(例如，在自动化构建的单元测试期间)，它也会失败。

Qt 有一个工具可以做到这一点，称为 windeployqt ，它基本上寻找依赖项(Qt)并复制它们。例如:

c:\Qt\Qt5.12.1\bin\windeployqt c:\projects\qt-project\Release --release

将分析c:\projects\qt-project\Release中的可执行文件，并将所需的DLL、插件、翻译和其他相关二进制文件复制到该位置。

我对如何将 windeployqt 集成到 Visual Studio 的构建工作流程中感兴趣，以便此过程是自动的(即使在不同的计算机上 checkout )。

Answer 1

您显然可以创建一个批处理文件并执行它，但请记住，您必须在编译项目之后执行此操作，因为该工具将查看可执行文件。此外，您还必须处理构建路径和 Qt 安装目录位置，以便使其跨系统可移植。

(请参阅本答案末尾的更新)

更方便的方法是将 windeployqt 配置为项目中的构建后事件(项目属性 > 构建事件 > 构建后事件)。 我在这里记录了这一点，因为我找不到任何明确的引用资料，并且我花了一段时间才弄清楚。

处理可移植性:

• $(QTDIR):此变量扩展到当前 Qt 版本的安装路径(当然，我假设它是一个 Qt 项目，并且安装了 Qt VS Tools )。使用它来定位 windeployqt(在 $(QTDIR)\bin\ 下)。

• $(OutDir):扩展到可执行文件的构建目录。像往常一样，引用它来处理带有空格的路径。这里的问题是 $(OutDir) 通常以反斜杠 (\) 结尾，因此当 "$(OutDir)" 为展开后，它将创建一个转义字符 \"，该字符将被错误地解释。为了修复它，您可以修剪前导斜杠:"$(OutDir.TrimEnd('\'))" (credits)。

• $(Configuration):扩展为当前配置的名称(通常是调试或发布，请阅读下面的其他配置名称)。现在，windeployqt 对于 --debug 或 --release 参数区分大小写，并且配置名称采用标题大小写。要小写它:--$(Configuration.toLower()) ( credits )。这一步只是为了有一个通用命令，可以通过手动添加 --debug 或 --release 标志来跳过。

这样，完整的构建后命令如下:

"$(QTDIR)\bin\windeployqt.exe" "$(OutDir.TrimEnd('\'))" --$(Configuration.toLower())

该命令可以在所有平台和项目配置中统一应用。

现在，如果您有 Release 和 Debug 之外的其他配置，您可以:

• 通过相应地添加 --debug 或 --release 来修改命令，或者

• 为“基于调试的配置”和“基于发布的配置”创建自定义属性页，并将变量(例如 BaseConfiguration)设置为 Debug或Release，然后在命令中使用这个新变量。

更新

从 Qt VS Tools 的几个版本(不确定是哪个，但至少是 2.7.1)开始，部署工具可以直接从项目的属性表添加到构建链中: