Qt基础学习(一)——.pro文件

目录

前言

一直没有时间对Qt的.pro文件进行学习总结!这篇博客在2017年11月20日的时候就想写，但是那时候刚刚接触Qt，对Qt一点都不了解，也写不出什么东西！现在是2018年2月8日，随着对Qt开发有了一点理解之后，感觉也是时候把这部分内容好好总结一下！
学习！分享！感谢！

Qt基础学习

qmake

qmake介绍

qmake是创建出来用于为不同的平台和编译器书写Makefile的工具。手写Makefile是比较困难并且容易出错的，尤其是需要给不同的平台和编译器组合写几个Makefile。使用qmake，开发者创建一个简单的项目文件并且运行qmake生成适当的Makefile。qmake会注意所有的编译器和平台的依赖性，可以把开发者解放出来只关心他们的代码。——qmake用户手册

qmake使用

qmake使用存储在项目(.pro)文件中的信息来决定Makefile文件中该生成什么。一个基本的项目文件包含关于应用程序的信息，比如，编译应用程序需要哪些文件，并且使用哪些配置设置。——qmake用户手册

对于具体的项目(.pro)文件内容会专门详细的介绍。

• 生成Makefile
  当你已经创建好了项目文件，就可以使用qmake来生成Makefile了。由.pro文件生成Makefile的命令如下：

// .pro生成Makefile
qmake hello.pro -o Makefile
// 生成Makefile之后就可以编译程序
make

项目(.pro)文件

qmake的概念

qmake是用来为不同的平台的开发项目创建makefile的一个工具。qmake简化了makefile的生成，因此创建一个makefile只需要几行信息的文件。qmake可以供任何一个软件项目使用，而不用管他是不是使用Qt写成的，尽管它包含了为支持Qt开发所拥有的额外的特征。

项目(.pro)文件

一个项目文件是用来告诉qmake关于为这个应用程序创建makefile所需要的细节。例如，一个源文件和头文件的列表、任何应用程序特定配置。例如，一个必需链接的额外库或者一个额外的包含路径、都应该放到项目文件中。

• 注释
  项目(.pro)文件中使用“#”作为注释
• 模板(TEMPLATE)
  模板变量告诉qmake为这个应用程序生成哪种makefile。下面是可供使用的选择：
  
  1. app - 建立一个应用程序的makefile。这是默认值，所以如果模板没有被指定，这个将被使用。示例如下：TEMPLATE = app
  2. lib - 建立一个库的makefile
  3. vcapp - 建立一个应用程序的Visual Studio项目文件
  4. vclib - 建立一个库的Visual Studio项目文件
  5. subdirs - 这是一个特殊的模板，它可以创建一个能够进入特定目录并且为一个项目文件生成makefile，并且为它调用make的makefile。

app模板

app模板告诉qmake为建立一个应用程序生成一个makefile。当使用这个模板时，下面这些qmake的系统变量是被承认的。我们需要在.pro文件中使用这些系统变量来为应用程序指定特定信息。

---

HEADERS：应用程序中所有头文件的列表。
SOURCES：应用程序中所有源文件的列表。
FORMS：应用程序中的所有.ui文件(由Qt设计器生成)的列表。
TARGET：可执行应用程序的名称。默认值为项目文件的名称。
INCLUDEPATH：应用程序所需的额外的包含路径的列表。比如：INCLUDEPATH += $$FFMPEG_INCLUDE，其实$$FFMPEG_INCLUDE中的FFMPEG_INCLUDE是自定义变量，表示ffmpeg的头文件路径
LIBS：指定链接到项目中的库列表。比如：LIBS += $$FFMPEG_LIB/libavcodec.so，表示链接FFmpeg的库目录下的libavcodec.so这个动态库。

---

以上是书写一个项目(.pro)文件经常会用到的一些变量，需要注意的是，如果是在QtCreator中加入的文件，在配置的时候会自动把添加的文件都加入到HEADERS和SOURCES中，所以我们在QtCreator中至少要保证添加的头文件和源文件可用，下面介绍一些不经常用到的系统变量。

---

DESTDIR：放置可执行程序目标的目录，比如：DESTDIR = /opt。(PS：以前一直不知道这个选项，每次都要从QtCreator的build-xxx文件夹下拷贝程序到nfs等目录下，然后下载到开发板上运行，果然还是要多了解一些东西)

CONFIG(release):DESTDIR = $$PWD/../bin
CONFIG(debug, debug|release):DESTDIR = $$PWD/../bin

DEFINES：应用程序所需的额外的包含的预处理程序定义的列表。不太理解这个概念，之后特地搜索了一下，这篇文章中Qt之pro配置详解很好地说明了它的使用方法。感觉以前自己分别编译Ubuntu版本和开发板版本时都是笨拙的把对应的动态链接库给注释掉，然后编译。这个选项就方便很多了！
例如：

DEFINES += USE_MY_STUFF

然后可以在代码中使用：

#ifdef USE_MY_STUFF
    // TODO
#else
    // TODO
#endif

也就是通过指定USE_MY_STUFF这个宏就可以选择使用不同的动态链接库的版本。

---

以上两部分讲述了经常使用和一般使用的系统变量，这里记录一下可能会用到的系统变量。

---

MOC_DIR：指定来自moc的所有中间文件放置的目录
OBJECTS_DIR：指定所有中间文件.o(.obj)放置的目录
RESOURCES：指定资源文件(qrc)的名称，例如，RESOURCES += \
mouse.qrc
如何添加资源文件参考 Qt小程序(一)-添加资源文件

CONFIG变量

config变量指定编译器所要使用的选项和所需要被连接的库。配置变量中可以添加任何东西，但只有下面这些选项可以被qmake识别。
下面这些选项控制着使用哪些编译器标志：

• release - 应用程序将以release模式联编。如果”debug”被指定，它将被忽略。
• debug - 应用程序将以debug模式联编
• warn_on - 编译器会输出尽可能多的警告信息。如果”warn_off”被指定，它将被忽略。
• warn_off - 编译器会输出尽可能少的警告信息。
  下面这些选项定义了所要联编的库/应用程序的类型：
• qt - 应用程序是一个Qt应用程序，并且Qt库将会被连接，也就是其实我们可以使用QtCreator来创建Qt程序，这时候会添加Qt库的支持。我们也可以不使用Qt的库，编写和Qt无关的程序，然后写项目(.pro)文件，来帮我们生成makefile，而不需要我们自己写makefile。有时间可以尝试一下，感觉自己写一个makefile还是比较麻烦的。
• thread - 应用程序是一个多线程应用程序
• x11 - 应用程序是一个x11应用程序或库
  

  ---

其他的一些配置选项可以参考本文的链接地址部分，有更为详细的介绍。

总结

Qt程序的编译执行过程：(1) 创建.pro文件，(2) 由.pro文件生成Makefile文件，(3) Makefile中保存了编译器和链接器的参数选项，还表述了所有源文件之间的关系(源文件需要的特定的包含文件，可执行文件要求包含的目标文件模块及库等)，(4) 创建程序(make)，读取Makefile文件，然后激活编译器，汇编器，资源编译器和链接器等以便产生最后的输出，最后输出生成通常是可执行文件。——QT中的qmake详解

链接地址

qmake用户手册
Qt之pro配置详解