翻译qmake文档(三) Creating Project Files

简介: 翻译qmake文档 目录   原英文文档:http://qt-project.org/doc/qt-5/qmake-project-files.html   创建项目文件      项目文件包含qmake构建你的应用程序,库文件,或插件需要的所有信息。
 
 
创建项目文件
     项目文件包含qmake构建你的应用程序,库文件,或插件需要的所有信息。通常,你会在项目文件里使用一系列的声明指定资源,但是对简单程序构造的支持,允许你为不同的平台或环境描述不同的构建过程。
项目文件元素
     qmake使用的项目文件格式可以支持简单和复杂的构建系统使用。简的项目文件使用简单的声明样式,定义标准的变量,用于指出项目中使用的头文件和源文件。复杂的项目可以使用控制流程结构来调整构建过程。
 
     下面的章节描述了在项目文件里使用不同类型的元素。
变量
     在项目文件里,变量是用于保存字符串的列表。在简单的项目里,这些变量通知qmake使用相关的配置信息,或者提供文件名和路径在构建过程使用。
     qmake在每个项目文件中查找某些变量,并使用这些内容用于确定什么要写到 makefile里。举例,在 HEADERSSOURCES里的变量列表用于告诉qmake在相同目录里的头文件和源文件做为项目文件。
     变量也可以在内部保存临时变量列表,现有变量列表可以被新值覆盖或扩展。
     下面的代码片段说明了值列表是如何赋值给变量的:
 
HEADERS = mainwindow.h paintwidget.h

 

 
在变量里的值列表是通过下边的方式进行扩展的:
 
SOURCES = main.cpp mainwindow.cpp \
          paintwidget.cpp
CONFIG += console

 

 
注意:第一个赋值语句只包含指定在同一行里的值是HEADERS变量。第二个赋值语句把SOURCES里不同行的值用反斜杠(\)分开。
      CONFIG变量是另一个当生成Makefile时qmake用来使用的特殊变量 。这里讨论了它 General Configuration .在上面的代码片段,console被添加到CONFIG已经存在的值列表里。
      下边的表格列了了常用的变量并描述了他们的内容。完整的变量列表及它们的描述,请查看 Variables
 
变量 描述
CONFIG 通用的项目配置选项。
DESTDIR 将要存放可执行文件和二进制文件的目录。
FORMS user interface compiler(uic)处理过的UI文件列表。
HEADERS 当构建项目时被使用的头文件(.h)名称列表。
QT 在项目中使用的Qt模块列表
RESOURCES 在最终项目中包含的资源文件(.qrc)列表。更多资源文件的详细信息查看   The Qt Resource System 。
SOURCES 在构建项目时使用的源文件(.cpp)列表。
TEMPLATE 项目使用的模板。这个决定构建过程输出的是否是一个应用程序、库、或者生成一个插件
 
     可以通过在变量名前附加$$读取变量的内容。这样可以把一个变量的内容赋值给另一个变量。
 
TEMP_SOURCES = $$SOURCES

 

 
     $$操作符被广泛的应用于内置函数,用于操作字符串和值的列表。更多详细信息,请查看, qmake Language
 
空格
 
通常,在变量赋值中用空格分隔值。指定变量中包含空格,你必需用双引号包围变量
DEST = "Program Files"
 
引号文本被视为一个单独的值保存在变量里。类似的方法用来处理包含空格的路径,特别是在windows平台定义 INCLUDEPATHLIBS变量时:
 
win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

 

注释
可以在项目文件里添加注释。注释以#字符开始持续到这一行的结尾。例如:
 
# 注释通常开始于一行的头部,但它
# 也可以在这同行内容的后边

 

要在赋值变量时包含#字符,必需使用内置的 LITERAL_HASH变量的内容
 
内置函数和控件流
 
qmake 提供了大量的内置函数允处理变量内容。在简单的项目文件里最常用的是 include()函数,这个函数用一个文件名做为参数。 给定的文件的内容包含在在项目文件的地方使用include函数。include()函数经常用于包含其它项目文件
include(other.pro)

 

可以通过作用域( scopes)支持条件结构语句。这种行为和编程语言里的if一样
win32 {
    SOURCES += paintwidget_win.cpp
}

 

 
     只有条件为true的时候花括号里的任务才会被执行。在这个例子里,必须设置 CONFIG的Win32选项。只有在windows系统上才会自动处理,左边的大括号必须和条件在同一行
     变量上更复杂的操作通常封面要循环提供的内置函数比如 find()unique()和  count()。提供的这些功能,和其它操作字符串和路径,提供用户输入,以及调用扩展工具。使用这些函数更详细的内容,请查看  qmake Language 。所有函数和它们的描述列表,请查看  Replace Functions 和  Test Functions.
 
项目模板
     TEMPLATE变量,是用来定义项目将要构建的类型。如果它没有在项目文件里声明,qmake会假定构建应用程序,并且将为此生成一个适当的Makefile(或者等价的文件)。
     
     下表简要说明了项目类型变量和成描述qmake生成的每一个文件:
模板 qmake输出
app (default) makefile生成一个应用程序
lib makefile生成一个库
aux makefile什么也不生成。如果没有编辑器需要调用创建目标。例如你的项目是用解释型语言编写的。
注意:这个模板类型只适用于基于Makefile的生成器。特别是,它不会与vcxproj和Xcode生成器一起工作。
subdirs Makefile规则包含使用SUBDIRS变量指定的子文件。每一个子目录必须包含它自己的项目文件。
vcapp Visual Studio项目文件 生成一个应用程序
vclib
Visual Studio项目文件生成一个库
vcsubdirs
Visual Studio解决方案文件要在子目录生成项目
 
查看  Building Common Project Types 在编写使用项目模板和库模板项目的项目文件时的建议。
     当使用subdirs模板时,qmake生成一个makefile用来检查每一个子目录,处理在子目录里找到的工程文件,并执行平台的make 工具生成新的Makefile。SUBDIRS变量被用于包含所有要被处理的子目录的列表。
 
 
常规配置
      CONFIG变量指定项目应该配置的选项和功能。
     可以在release模式或debug模式或两种模式一起构建项目。如果debug和release一同指定,最后一个指定的生效。如果你指定 debug_and_release 选项用来构建项目的debug和release两个版本,qmake会生成包含构建两个版本规则的Makefile。可以通过以下方式调用:
 
make all

 

 
添加 build_all选项到 CONFIG变量,在规则构建项目时使用这个默认值。
 
     注意:每一个在CONFIG里指定的变量都可以用做条件作用域。你可以使用内置的 CONFIG()方法测试某个配置选项是否存在。例如,下边的代码展示使用这个方法做为域的条件测试是否只有opengl选项被使用
 
CONFIG(opengl) {
    message(Building with OpenGL support.)
} else {
    message(OpenGL support is not available.)
}

 

这允许为release和debug 定义不同的配置 构建。更详细的信息,请查看 Using Scopes
 
下边的选项定义要构建的项目类型。
注意:一些选项只有在相关平台上使用时才会生效。
 
选项 描述
qt 这个项目是Qt应用程序需要连接Qt库。你可以为用QT变量控制应用程序所需的所有额外的Qt模块。这个值是默认添加的,但是你可为非qt项目用qmake删除它。
x11 项目是一个X11应用程序或库。如果目标使用Qt那么这个值是不需要的。
 
     应用程序和库项目模板为你提供了更专业的配置选项用来调整生成过程。选项更详细的解释在 Building Common Project Types
 
     例如,如果你的应用程序使用Qt库并且你想在debug模式下构建项目。你的项目文件将包含下边的代码:
 
CONFIG += qt debug

 

 
     注意:你必需使用"+=",不能使用"=",不然qmake将不能为使用Qt的配置确定哪些设置是你的应用程序需要的。
 
声明Qt库
 
     如果 CONFIG变量包含qt值,开启qmake对Qt应用程序的支持。这样就可以微调你的应用程序使用的Qt模块。通过 QT的变量可以用于声明需要的额外的模块。例如我们可以也下面的方式启用 XML和network模块:
 
QT += network xml
注意:QT默认包含core和gui模块,所以上边的声明把network和XML模块添加到了默认列表。下边的赋值删除了默认模块,这将导致应用程序的源码在编译的时候出现错误:
 
QT = network xml # This will omit the core and gui modules.
如果你想构建没有gui模块的项目,你需要用 "-=" 操作删除它。默认情况下,QT包含core和gui。下面的代码将导致最小的Qt项目构建:
 
QT -= gui # Only the core module is used.
 
你可以添加到QT变量的Qt模块列表,请查看 QT
 
配置功能
 
     qmake可以提供在功能文件(.prf)里指定的额外的配置功能。这些额外的功能经常为在构建过程使用的自定义工具提供支持。为了能将功能添加到构建过程,把功能的名字(功能文件名的词干)追加到CONFIG变量后边
     例如,用下边的代码qmake可以配置构建过程利用pkg-config提供的外部库。如D-Bus和ogg库。
 
 
CONFIG += link_pkgconfig

PKGCONFIG += ogg dbus-1

 

 
关于添加新特性更详细的信息,请查看  Adding New Configuration Features.

声明其它库
 
     除了Qt支持的库,你可以把其它的库添加到工程里,你必需在工程文件里指定它们。
     qmake可以查找库所在的路径,及特定库链接可以被添加到 LIBS变量的值列表。你可以指定库的路径或者,或者使用UNIX样式符号指定库和路径。
     例如,下边的代码显示如何指定库:
 
LIBS += -L/user/local/lib -lmath

 

包含头文件的路径也可以使用相同的方式添加到  INCLUDEPATH 变量
 
例如,添加几个用于查找头文件的路径
 
INCLUDEPATH = c:/msdev/include d:/stl/include

 


 
 
 
 
目录
相关文章
clion中cpp文件显示This file does not belong to any project ,code insight features might not work【解决方案】
clion中cpp文件显示This file does not belong to any project ,code insight features might not work【解决方案】
clion中cpp文件显示This file does not belong to any project ,code insight features might not work【解决方案】
|
3月前
|
开发工具 git
成功解决:fatal: detected dubious ownership in repository at ‘E:/workspace/CSMarket‘。如何使用git工具通过命令行的形式
这篇文章分享了作者在使用Git工具初始化本地仓库时遇到的权限问题,提供了通过命令行解决Git仓库权限问题的方案,并介绍了如何使用Git命令行初始化项目、添加文件、提交以及关联远程仓库的步骤。
成功解决:fatal: detected dubious ownership in repository at ‘E:/workspace/CSMarket‘。如何使用git工具通过命令行的形式
|
存储 编解码 编译器
iOS项目Project 和 Targets配置详解
最近开始学习完整iOS项目的开发流程和思路,在实际的项目开发过程中,我们通常需要对项目代码和资料进行版本控制和管理,一般比较常用的SVN或者Github进行代码版本控制和项目管理。
798 0
|
Java Android开发
eclipse中提示change project compliance and jre to 1.7
eclipse中提示change project compliance and jre to 1.7
107 0
eclipse中提示change project compliance and jre to 1.7
|
Java Android开发
eclipse project修改 output folder
eclipse project修改 output folder
126 0
|
Android开发
解决bug:在eclipse中导入Android项目时报错: “invalid resource directory name bin/res/crunch”
解决bug:在eclipse中导入Android项目时报错: “invalid resource directory name bin/res/crunch”
554 0