在MFC中使用Qt(三):通过编辑项目文件(.vcxproj)实现Qt的自动化编译流程

前言

回顾下前面介绍的:
在MFC中使用Qt(一):玩腻了MFC,试试在MFC中使用Qt!(手动配置编译Qt)

在MFC中使用Qt(二):实现Qt文件的自动编译流程

本文将详细介绍方式二:通过编辑项目文件(.vcxproj)实现自动化Qt编译流程。

通过编辑项目文件(.vcxproj)实现自动化Qt编译流程

这里再新建一个MFC对话框项目MFCWithQtAuto2,尝试方式二。

新建MFCWithQtAuto2,编译运行确认没有问题:

步骤①配置Qt环境(必不可少!)


步骤②配置项目

因为不像在MFC中使用Qt(二):实现Qt文件的自动编译流程 那样,将项目标记成Qt项目,编辑项目文件(.vcxproj)实现自动化Qt编译流程方式,本质还是MFC项目。

因此在项目属性中添加要使用的本地Qt模块的包含目录、附件库目录和库文件:


配置完成后,编译运行,确认没有问题:

接着编辑项目文件(.vcxproj),代替手动编译流程中的③④步骤

①编辑项目文件(.vcxproj)

右键项目 → ​Unload Project:

在最后一个后面追加以下内容:

xml 复制代码
  <!-- 自动包含 所有目录下的 .ui 、moc、qrc文件 -->
  <ItemGroup>
    <UIFiles Include="**\*.ui" />
  </ItemGroup>
  <!-- 自定义构建步骤,编译 .ui 文件为 .h 文件 -->
  <ItemGroup>
    <CustomBuild Include="@(UIFiles)">
      <Command>"uic.exe" %(FullPath) -o $(ProjectDir)GeneratedFiles\uic\ui_%(Filename).h</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\ui_%(Filename).h</Outputs>
    </CustomBuild>
  </ItemGroup>
  <!-- 自动包含 所有目录下的 带Q_OBJECT宏的.h 文件。因无法区分普通的C++.h,因此需要在一个目录(这里是qt/UI目录)中统一管理 -->
  <ItemGroup>
    <MocFiles Include="$(ProjectDir)qt\UI\*.h" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(MocFiles)">
      <Command>"moc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\moc\moc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\moc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <!-- 自动包括所有的 .qrc 文件 -->
    <QrcFiles Include="**\*.qrc" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(QrcFiles)">
      <Command>"rcc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\qrc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\moc\moc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\rcc\qrc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
  </ItemGroup>

这里逐个解析一下这段配置作用:

1)处理 UI 文件(.ui → .h)​

xml 复制代码
<ItemGroup>
  <UIFiles Include="**\*.ui" /> <!-- 扫描所有目录下的 .ui 文件 -->
</ItemGroup>

<ItemGroup>
  <CustomBuild Include="@(UIFiles)">
    <Command>"uic.exe" %(FullPath) -o $(ProjectDir)GeneratedFiles\uic\ui_%(Filename).h</Command>
    <Outputs>$(ProjectDir)GeneratedFiles\ui_%(Filename).h</Outputs>
  </CustomBuild>
</ItemGroup>

​作用:使用 uic.exe(Qt UI 编译器)将 .ui 文件转换为 ui_*.h 头文件。

输出路径:GeneratedFiles\uic\ 目录下生成 ui_文件名.h

示例:MDialog.ui → GeneratedFiles\uic\ui_MDialog.h

2)处理 MOC 文件(含 Q_OBJECT 的 .h → .cpp)​

xml 复制代码
<ItemGroup>
  <MocFiles Include="$(ProjectDir)qt\UI\*.h" /> <!-- 仅扫描 qt\UI 目录下的头文件 -->
</ItemGroup>

<ItemGroup>
  <CustomBuild Include="@(MocFiles)">
    <Command>"moc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\moc\moc_%(Filename).cpp"</Command>
    <Outputs>$(ProjectDir)GeneratedFiles\moc_%(Filename).cpp</Outputs>
  </CustomBuild>
</ItemGroup>

作用:使用 moc.exe(Qt 元对象编译器)处理含 Q_OBJECT 宏的头文件,生成 moc_*.cpp 元对象代码。

输出路径:GeneratedFiles\moc\ 目录下生成 moc_文件名.cpp。

限制:仅处理 qt\UI (后续应用替换成自己项目指定的目录)目录下的头文件,避免扫描无关文件(如系统头文件)。

示例:qt/UI/MWidget.h → GeneratedFiles\moc\moc_MDialog.cpp

3)处理资源文件(.qrc → .cpp)

xml 复制代码
<ItemGroup>
  <QrcFiles Include="**\*.qrc" /> <!-- 扫描所有目录下的 .qrc 文件 -->
</ItemGroup>

<ItemGroup>
  <CustomBuild Include="@(QrcFiles)">
    <Command>"rcc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp"</Command>
    <Outputs>$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp</Outputs>
  </CustomBuild>
</ItemGroup>

作用:使用 rcc.exe(Qt 资源编译器)将 .qrc 文件编译为 qrc_*.cpp,嵌入二进制资源(如图标、字体)。

输出路径:GeneratedFiles\rcc\ 目录下生成 qrc_文件名.cpp。

示例:resources.qrc → GeneratedFiles\rcc\qrc_resources.cpp

4)自动包含生成的文件到编译

xml 复制代码
<ItemGroup>
  <ClCompile Include="$(ProjectDir)GeneratedFiles\moc\moc_*.cpp">
    <PrecompiledHeader>NotUsing</PrecompiledHeader>
  </ClCompile>
  <ClCompile Include="$(ProjectDir)GeneratedFiles\rcc\qrc_*.cpp">
    <PrecompiledHeader>NotUsing</PrecompiledHeader>
  </ClCompile>
</ItemGroup>

作用:将生成的 moc_.cpp 和 qrc_ .cpp 文件自动包含到项目编译中。

关键设置:<PrecompiledHeader>NotUsing</PrecompiledHeader> 表示这些文件不使用预编译头文件。

5)输出路径管理

所有生成的文件统一存放在 GeneratedFiles 目录的子文件夹中:

复制代码
GeneratedFiles/
├── uic/         # UI 生成的头文件(ui_*.h)
├── moc/         # MOC 生成的元对象代码(moc_*.cpp)
└── rcc/         # 资源文件生成的代码(qrc_*.cpp)

优点:避免生成文件污染源码目录,便于版本控制忽略(通过 .gitignore 排除 GeneratedFiles)。

卸载项目并添加到项目配置文件中,位置在最后一个后追加:

重新加载项目,新建Qt类MDialog。

注意新建的文件会自动放在项目根目录,这里需要手动剪切到上面项目配置文件中指定的目录下:

同样在项目中添加同目录结构一样的筛选器:

虽然这里也要手动处理,但及时在正经的Qt项目中,也会在一个目录/筛选器中维护管理Qt类文件,因此不算是之前手动编译涉及的问题。

编译运行,同样没有毛病!!!

至此,通过编辑项目文件(.vcxproj)也能够解决手动编译问题:

①每次新建/添加的Qt文件,都需要手动配置自定义生成工具以添加Qt编译工具的编译流程。

②通过Qt编译工具编译输出的文件,需要手动添加到项目中。

实现Qt编译流程自动化!!!

总结

编辑项目文件(.vcxproj)实现自动化Qt编译流程方式,本质还是MFC项目。

因此相较于在MFC中使用Qt(二):实现Qt文件的自动编译流程

还是需要在项目属性中添加要使用的本地Qt模块的包含目录、附件库目录和库文件。

补充

Qt编译工具输出的.h头文件目录,需要手动配置包含目录:

当然也可以在配置文件中添加处理:

xml 复制代码
<AdditionalIncludeDirectories>GeneratedFiles\uic;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

添加后的完整配置:

xml 复制代码
<!-- 自动包含 所有目录下的 .ui 、moc、qrc文件 -->
  <ItemGroup>
    <UIFiles Include="**\*.ui" />
  </ItemGroup>
  <!-- 自定义构建步骤,编译 .ui 文件为 .h 文件 -->
  <ItemGroup>
    <CustomBuild Include="@(UIFiles)">
      <Command>"uic.exe" %(FullPath) -o $(ProjectDir)GeneratedFiles\uic\ui_%(Filename).h</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\ui_%(Filename).h</Outputs>
    </CustomBuild>
  </ItemGroup>
  <!-- 自动包含 所有目录下的 带Q_OBJECT宏的.h 文件。因无法区分普通的C++.h,因此需要在一个目录(这里是qt/UI目录)中统一管理 -->
  <ItemGroup>
    <MocFiles Include="$(ProjectDir)qt\UI\*.h" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(MocFiles)">
      <Command>"moc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\moc\moc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\moc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <!-- 自动包括所有的 .qrc 文件 -->
    <QrcFiles Include="**\*.qrc" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(QrcFiles)">
      <Command>"rcc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\qrc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\moc\moc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\rcc\qrc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
  </ItemGroup>
  <ItemDefinitionGroup>
    <ClCompile>
      <!-- 添加新路径到现有包含目录列表 -->
      <AdditionalIncludeDirectories>GeneratedFiles\uic;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
    </ClCompile>
  </ItemDefinitionGroup>

当然目前的配置都是默认Release x64环境,没有做Debug、Release,x64、x86的区分,若有需要可自行修改调整。

相关推荐
tan180°4 小时前
MySQL表的操作(3)
linux·数据库·c++·vscode·后端·mysql
彭祥.6 小时前
Jetson边缘计算主板:Ubuntu 环境配置 CUDA 与 cudNN 推理环境 + OpenCV 与 C++ 进行目标分类
c++·opencv·分类
lzb_kkk6 小时前
【C++】C++四种类型转换操作符详解
开发语言·c++·windows·1024程序员节
程序员爱钓鱼7 小时前
【无标题】Go语言中的反射机制 — 元编程技巧与注意事项
开发语言·qt
胖大和尚8 小时前
clang 编译器怎么查看在编译过程中做了哪些优化
c++·clang
无畏烧风8 小时前
[Qt] visual studio code 安装 Qt插件
qt
钱彬 (Qian Bin)9 小时前
一文掌握Qt Quick数字图像处理项目开发(基于Qt 6.9 C++和QML,代码开源)
c++·开源·qml·qt quick·qt6.9·数字图像处理项目·美观界面
双叶83610 小时前
(C++)学生管理系统(正式版)(map数组的应用)(string应用)(引用)(文件储存的应用)(C++教学)(C++项目)
c语言·开发语言·数据结构·c++
源代码•宸10 小时前
C++高频知识点(二)
开发语言·c++·经验分享
jyan_敬言11 小时前
【C++】string类(二)相关接口介绍及其使用
android·开发语言·c++·青少年编程·visual studio