【Qt】使用pri文件管理项目中的子模块

1. 前言

.pro 文件是Qt的项目文件，里面包含了源文件路径、头文件路径、ui文件路径、资源文件路径、编译选项等诸多信息。当项目比较大时，软件中各个模块的代码文件路径、资源文件路径、编译选项都会写入到pro文件中，不仅导致pro文件会比较大，而且模块之间划分不清晰、耦合性强。如果想要移除、修改某个软件模块，则需要一番查找定位，非常不方便；同时，耦合性强可能会导致在修改某个模块时，错误修改了其他模块，影响其他模块的稳定性。解决此问题的方法，是使用pri文件对Qt项目分模块管理。模块化，是软件开发中老生常谈的技术了，使用pri对Qt项目分模块管理，能够提高软件模块的封装性和重用性。

2. 何为pri文件

pri文件是Qt项目中常用的子模块包含文件，可以认为是 project include 的缩写。它本质上是一个包含qmake指令脚本的纯文本文件，和pro文件语法相同，遵循qmake语法，但通常被pro或更上级的pri文件所包含。

下面讲解两种pri文件的应用。

3. pri文件的应用

3.1 使用pri文件将pro分解为子模块

未使用pri分解的Qt项目，项目结构及pro内容如下：

使用pri对项目进行子模块分解，分解后项目结构及pro内容如下：

pri文件内容如下：

• Ui/Ui.pri
  
• Model/Model.pri
  
  可见，使用pri将项目划分成子模块后，各个模块的相关内容，都移动到了各自的pri文件中，实现了解耦，便于管理。

使用文件夹对Qt项目进行分模块管理，和使用pri对Qt项目进行分模块管理存在相似之处，但本质上却不同。相似之处在于，二者都将不同的模块的源码、资源按模块存放在了不同的文件夹。不同之处在于，前者所有的源码资源路径、编译配置全部都被写在pro文件中，仍然存在pro文件过大、模块划分不清晰的问题，后者则不存在此问题。

3.2 使用pri封装程序库

通常，一个程序库（静态库，动态库）需要为使用者提供两种类型的文件：

• 头文件：头文件中定义了程序库相关的数据结构、被导出函数的签名等信息，供使用者包含后在程序编译期使用。
• 库文件：库文件用于将编译后的数据及代码，静态链接或动态链接到目标程序中，供使用者在程序链接及运行期间使用。

如果一个程序库的头文件和库文件很多，则使用者在将程序库导入到项目中时，需要编写很多头文件、库文件导入代码，以及添加很多头文件包含路径。在Qt中，库的导入过程包含的所有指令，可以使用pri文件完整地封装起来。使用者在使用时，只需要包含程序库的pri文件即可。

以自定义的图表程序库 MyChart 为例。MyChart库根目录内容如下：

其中，include文件夹用于存放库的头文件，内容如下：

lib目录用于存放库文件，内容如下：

不使用 pri文件，直接将库导入到 pro 文件中，需要在项目的pro文件中添加导入指令，如下图红色框中所示：

若采用pri的方式导入程序库，只需要将导入指令稍作修改，写入到pri文件中，并将pri文件作为程序库的一部分提供给使用者，使用者包含此库提供的pri文件即可。下面开始演示。

首先在程序库根目录下，新建空文本文件，重命名为MyChart.pri：

然后，使用文本编辑器编辑MyChart.pri文件，内容如下：

其中，$$PWD的值，等于当前pri文件所在目录的绝对路径，必须要基于此目录相对寻址其他路径，否则极容易出现路径错误的问题，读者可以自己尝试。

最后，我们这里将MyChart程序库文件夹拷贝到Test测试项目的根目录下，使用include指令包含MyChart.pri，即可将程序库导入到当前项目：

至此程序中可以正常使用MyChart程序库。

可见，使用pri封装程序库，可以极大的简化程序库的导入过程，实现程序库导入指令的完美复用。不仅如此，在我们需要从工程中移除某个程序库时，也非常简单，只需要从项目中删除相应的程序库导入指令即可。

4. 结语

归根结底，pri文件的使用属于模块化技术。pri文件的使用在实际项目中使用很多，而在官方文档和很多教材中往往讲解较少。和pri文件相关的问题多数是优劣问题，而不是对错问题。通过学习各种优化方案，可以降低项目风险，提高我们的项目的质量。

---

本文原创发布于公众号 Qt未来工程师。