Qt Pri详解

一、Pri文件简介

在Qt中，Pri文件是一种项目文件，用于将C++代码、JavaScript文件、资源文件等链接在一起，并生成可执行文件。Pri文件中可以定义编译规则、链接规则、生成规则、部署规则等等，通过使用不同的变量和函数，来实现各种复杂的构建流程和部署流程。

Pri文件是基于Makefile语法的，因此需要使用一定的Makefile知识。同时，Qt Creator集成开发环境及其命令行工具Qt Build System（qbs）可以方便地生成Pri文件并进行构建，使得在不需要编写完整的Makefile的情况下进行快速开发和构建成为可能。

二、Pri文件编写基础

Pri文件的编写离不开变量、函数和条件判断等基础语法。

1. 变量的定义

Pri文件中的变量可以是预定义的系统变量，如$$PWD表示Pri文件所在的目录；也可以是用户自定义的变量，如SRC_DIR表示源文件目录。变量定义的语法是：

VARIABLE_NAME = variable_value

其中，VARIABLE_NAME为变量名，variable_value为变量的值。在变量的值中，可以嵌入其他变量，例如：

SRC_DIR = $$PWD/src
OBJ_DIR = $$PWD/obj
OBJECTS_DIR = $$OBJ_DIR/$$TARGET

其中，$$TARGET表示生成文件的目标类型，可以是exe、dll、plugin等。

2. 函数的使用

Pri文件中的函数可以大大简化复杂的构建流程，例如文件搜索、文件生成、文件拷贝、库链接等等。

函数的语法是：

FUNCTION_NAME(arg1, arg2, ...)

其中，FUNCTION_NAME为函数名，arg1、arg2等为函数的参数。常用的函数包括：

files：用于搜索指定目录下的所有文件
subdirs：指定当前目录下的子目录
target.sources：为目标文件指定源文件
target.depends：指定目标文件所依赖的文件
target.commands：为目标文件指定编译命令、链接命令等
target.path：指定目标文件生成的路径
target.link：为目标文件指定需要链接的库文件以及链接命令等

例如：

LIBS += -lfoo
target_link($$TARGET, $$LIBS)

其中，target_link是一个自定义的函数，用于将$$LIBS中指定的库链接到$$TARGET中。

3. 条件判断

在Pri文件中，可以根据具体情况对不同的操作进行条件判断，例如：

win32:LIBS += -lwsock32
else:LIBS += -lsocket -lnsl

其中，win32表示在Windows平台下进行操作，else表示在其他平台下进行操作。

三、Pri文件高级应用

在掌握了基础的Pri文件语法之后，Pri文件可以进行更多复杂的编译任务。

1. 如何指定编译器

在Pri文件中，可以通过设置QMAKE_CXX和QMAKE_CC变量来指定编译器：

QMAKE_CXX = g++
QMAKE_CC = gcc

2. 如何生成动态库和静态库

在Pri文件中，可以通过target.commands指定动态库和静态库的生成规则：

lib.path = /usr/lib
lib.name = foo
lib.files = source1.cpp source2.cpp
lib.commands = $$QMAKE_CXX -shared -o $$lib.target $$OBJECTS

其中，lib.path指定库文件生成的路径，lib.name指定库文件的名称，lib.files指定库文件的源文件，lib.commands指定库文件的生成命令。

3. 如何生成可执行文件和文件拷贝

可执行文件和文件拷贝的生成规则如下：

executable.output = foo
executable.files = source1.cpp source2.cpp
executable.commands = $$QMAKE_CXX -o $$executable.target $$OBJECTS
INSTALLS += exe
exe.target = /usr/bin
exe.files = $$executable.target
exe.commands = $$QMAKE_COPY $$executable.target $$exe.target

其中，executable.output指定可执行文件的名称，executable.files指定可执行文件的源文件，executable.commands指定可执行文件的生成命令。INSTALLS指定生成文件的部署规则，exe.target指定部署目标目录，exe.files指定需要部署的文件，exe.commands指定文件拷贝的命令。

四、Pri文件的使用案例

以下是一个简单的Pri文件的示例：

SRC_DIR = $$PWD/src
OBJ_DIR = $$PWD/obj
TARGET_DIR = $$PWD/bin

INCLUDEPATH += $$PWD/include
LIBS += -ldl

target.path = $$TARGET_DIR
target.name = myapp

message(Building ... $$TARGET)
message(Source files: $$SOURCES)

contains(CONFIG, debug) {
    message(Building in debug mode...)

    TARGET = myappd

    COMMON_FLAGS = -g -O0
}

contains(CONFIG, release) {
    message(Building in release mode...)

    TARGET = myapp

    COMMON_FLAGS = -O2
}

sources = $$files($$SRC_DIR/*.cpp)

target.sources = $$sources

OBJECTS_DIR = $$OBJ_DIR/$$TARGET

mocable_headers = $$_PRO_FILE_PWD_/input.h
mocables = $$mocable_headers
mocables.headers = $$mocable_headers
mocables.commands = $$QTDIR/bin/moc $$mocables.headers -o $$mocables.target

QMAKE_EXTRA_TARGETS += mocables

unix {
    target.commands = $$QMAKE_CXX -o $$TARGET $$OBJECTS $$LIBS
    mocables.target = $${OBJECTS_DIR}/input.moc
    mkdir($${OBJECTS_DIR})
} else {
    target.commands = link -out:$$TARGET.exe $$OBJECTS $$LIBS
    mocables.target = $${OBJECTS_DIR}/input.moc.obj
    mkdir($$system_path($${OBJECTS_DIR}))
}

target.dependency_type = TYPE_C

target.CONFIG += dll
target.LIBS += -lfoo

DISTFILES += $$PWD/post_install_script

mocables.CONFIG += no_link_target

INSTALLS += target mocables
target.files = $$TARGET
mocables.files = $${mocable_headers}

其中，该Pri文件实现了基本的编译和部署任务，具体实现方式如下：

定义了SRC_DIR、OBJ_DIR、TARGET_DIR三个变量，用于指定源文件目录、目标文件目录和可执行文件目录。
指定了头文件搜索路径和库文件搜索路径。
定义了BUILD_MODE变量，用于指定构建模式，debug或release。
根据BUILD_MODE的设置，确定了可执行文件的名称，以及编译选项。
依据源文件目录下的所有.cpp文件，为目标文件指定源文件。
指定了需要运行moc预编译器的头文件，用于生成mocable文件。
指定了可执行文件的链接库、库文件等。
配置了可执行文件的部署规则。

通过这个简单的Pri文件，我们可以看到Qt Pri的强大和方便。在实际开发中，Pri文件可以根据需求定制，支持多库编译、多平台编译、资源文件编译等等，大大提高了开发效率。

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/285242.html