Qt项目中集成第三方模块的.pri文件

对于功能模块较多的Qt项目，使用pri文件管理模块文件，降低工程复杂度，提高软件模块的封装性和重用性。

一、.pro与.pri

对于模块化编程，Qt提供了pro和pri，pro管理项目，pri管理模块。

.pro 文件是Qt项目的主配置文件，用于描述整个项目的基本信息和编译配置。

.pri 文件是包含在 .pro 文件中的辅助文件，用于组织和管理项目中的共享代码、配置选项和编译规则。

使用pri将项目划分成子模块后，各个模块的相关内容，移动到各自的pri文件，实现解耦，便于管理。

.pro 文件（项目文件）

作用： .pro 文件是Qt项目的主项目文件，用于描述项目的基本信息、依赖关系、编译配置等。

内容：在 .pro 文件中，可设置项目的名称、版本号、编译选项、包含的源文件、依赖的库文件等信息。

示例：一个简单的 .pro 文件可能包含以下内容：

# 指定生成的应用程序名
TARGET = MyProject
# 生成应用程序，即可执行文件
TEMPLATE = app
# 生成库文件
TEMPLATE = lib
# 版本号
VERSION = 1.0
# 源文件
SOURCES += main.cpp \widget.cpp
# 头文件
HEADERS += widget.h
# 链接的库
LIBS += -lmylibrary
# 包含.pri 文件
include(file.pri)
# 程序编译时依赖的相关路径
DEPENDPATH += . forms include qrc sources
# 头文件包含路径
INCLUDEPATH += .
# 工程中包含的头文件
HEADERS += include/painter.h 
# 工程中包含的.ui设计文件
FORMS += forms/painter.ui
# 工程中包含的源文件
SOURCES += sources/main.cpp sources/painter.cpp
# 工程中包含的资源文件
RESOURCES += qrc/painter.qrc

.pri 文件（包含文件）

作用： .pri 文件用于包含在 .pro 文件中，可组织和管理项目中的共享代码、配置选项和编译规则。

内容：通常，.pri 文件包含一组变量定义、函数定义、条件语句等，用于封装特定的功能或配置选项。

示例：一个简单的 .pri 文件可能包含以下内容：

# 定义编译选项
DEFINES += USE_FEATURE_X
# 包含其他的 .pri 文件
include(anotherfile.pri)
# 添加源文件
SOURCES += additional.cpp
# 添加头文件
HEADERS += additional.h

二、准备第三方模块

‌下载第三方库‌
将第三方模块的源码或预编译文件（含.pri文件）放置于项目目录中，例如创建3rd-party文件夹存放第三方库‌。

‌模块目录结构示例

Project/
├── 3rd-party/
│   └── QSimpleUpdater/  # 第三方模块
│       ├── QSimpleUpdater.pri
│       └── ...
└── Project.pro

三、配置.pri文件

‌创建/修改.pri文件‌
在第三方模块的.pri文件中定义以下内容：

# 添加头文件路径
INCLUDEPATH += $$PWD/QSimpleUpdater/include
# 添加库文件路径（若需要）
LIBS += -L$$PWD/QSimpleUpdater/lib -lQSimpleUpdater
# 添加源文件（若需编译源码）
SOURCES += $$files($$PWD/QSimpleUpdater/src/*.cpp, true)
HEADERS += $$files($$PWD/QSimpleUpdater/include/*.h, true)

需根据实际路径调整$$PWD的相对路径‌。

‌条件编译（可选）‌
使用平台判断语句适配不同操作系统：
```
win32 {LIBS += -lwinmm
}
unix {LIBS += -lpthread
}
```

四、集成到.pro文件

‌包含.pri文件‌
在项目.pro文件中通过include语句引入第三方模块的.pri文件：
```
include($$PWD/3rd-party/QSimpleUpdater/QSimpleUpdater.pri)
```
‌验证配置‌
重新加载项目后，Qt Creator会自动解析.pri文件，第三方模块的头文件和源文件将显示在项目树中‌。

五、示例：集成QSimpleUpdater

‌目录结构‌
将QSimpleUpdater源码复制到项目3rd-party目录‌。

‌.pro文件配置

# Project.pro
include($$PWD/3rd-party/QSimpleUpdater/QSimpleUpdater.pri)

代码中使用

#include <QSimpleUpdater.h>
// 调用第三方模块接口