原英文文档: http://qt-project.org/doc/qt-5/qmake-tutorial.html
本教程教讲授qmake基础知识。这个手册里的其它专题包含更详细的使用qmke信息。
从简单开始
假设你已经完成了应用程序的基本实现,并且你创建了下边的文件:
hello.cpp hello.h main.cpp
qt分布的目录 examples/qmake/tutorial 中,你可以找到这些文件。你只需要知道的另一件事是这个程序的安装程序是用Qt写的。首先,用你最喜欢的文本编辑工具,在examples/qmake/tutorial目录下建立hello.pro文件,第一件你需要做的事就是要添加一些代码,告诉qmak
哪些源文件和头文件是项目的一部分。
我们先把源文件添加到项目中,想要这样做你需要使用SOURCES变量。只需要用SOURCES +=新起一行再把hello.cpp写它后边。写完后的效果是这样:
SOURCES += hello.cpp
我们把项目里的每一个源文件都重复这样做,直到我们以如下方式结束:
SOURCES += hello.cpp SOURCES += main.cpp
如果你喜欢使用Make-like语法,一口气列出所有的文件,你可以使用使用换行符,就像下边一样
SOURCES = hello.cpp \ main.cpp
现在已经列出项目里所有的源文件,头文件也必需添加.添加头文件除了使用名称为HEADERS的变量外和添加源文件的方式是一样的。
这样做后,你的项目文件看起来应该是这样的:
HEADERS += hello.h SOURCES += hello.cpp SOURCES += main.cpp
Target名称是自动设置的。它和项目名称是一样的,但会根据相关平台相添加后缀名,举个例子,如果这个项目文件叫hello.pro,这个目标在window平台上是hello.exe,在Unix平台上是hello。如果你想用不同的名字可以在项目文件里设置:
TARGET = helloworld
最后一步是设置CONFIG变量。因为这是Qt应用程序,我们需要把qt添加到CONFIG行,这样qmake会把相关的库连接,可以确保moc和uic构建行能包含到生成的Makefile里。
完成的项目文件应该像下面一样:
CONFIG += qt HEADERS += hello.h SOURCES += hello.cpp SOURCES += main.cpp
现在你可以为你的应用程序用qmake生成Makefile,在命令行里你项目目录下,写入命令行:
qmake -o Makefile hello.pro
然后根据你用的编译器输入make或者nmake.
对于使用Visual Studio用户,qmake也可以生成.dsp或者.vcproj,例如 :
qmake -tp vc hello.pro
可调试应用程序
release版本的应用程序不包含任何debug符号和debug信息,开发期间给应用程序生成debug版本的相关信息是非常有用的。在项目文件里的CONFIG变量加上debug就可以轻松实现。
例如:
CONFIG += qt debug HEADERS += hello.h SOURCES += hello.cpp SOURCES += main.cpp
像之前一样使用qmake生成makefile,当你在debug环境下运行应用程序的时候你会得到很有用的信息
添加平台特有的源文件
写几个小时的代码后,你也许会开始为你的应用程序编写特定平台的部分,并坚持对不同的平台编写不能的代码。现在你有两个新文件要包含到项目中:hellowin.cpp和hellounix.cpp。当我们想把这两个文件放到Makefile里,不能只把这些文件添加到SOURCES变量。所以,我们需要做的是根据qmake运行的当前平台用使用相应的作用域进行处理。
将一个简单的作用域添加到依赖于windows平台的文件,就像下边这样:
win32 { SOURCES += hellowin.cpp }
所以如果qmake运行于window平台,它将把hellowin.cpp添加到源文件列表。如果qmake运行于其它平台,它会被简单的忽略。现在剩下需要做的事就是创建一个特定于Unix文件的作用域。
当你做完这些,你的项目看起来应该是这样的:
CONFIG += qt debug HEADERS += hello.h SOURCES += hello.cpp SOURCES += main.cpp win32 { SOURCES += hellowin.cpp } unix { SOURCES += hellounix.cpp }
就像之前一个使用qt生成Makefile
如果一个文件不存在,停止 qmake
如果某个文件不存在,你也许不希望生成Makefile。我们可以用exists()方法检查一个文件是否存在。用error()方法我们可以停止正在运行的qmake.这和作用域的工作方式是一样的。用这个方法简单的替换作用域条件。像下面一样检查main.cpp文件:
!exists( main.cpp ) { error( "No main.cpp file found" ) }
“!”是用来否定测试。像这样, exists(main.cpp)如果是ture那么这个文件存在,如果!exists(main.cpp)是ture那么这个文件不存在。
CONFIG += debug HEADERS += hello.h SOURCES += hello.cpp SOURCES += main.cpp win32 { SOURCES += hellowin.cpp } unix { SOURCES += hellounix.cpp } !exists( main.cpp ) { error( "No main.cpp file found" ) }
像之前一样使用qmake生成makefile。如果你临时重命名main.cpp,你将看到错误信息,qmake也会停止运行
多条件检查
假设你使用windows系统,当你运行程序的时候,想在命令行里看到qDebug()语句输出。要想看到输出,你必需用适当的控制台设置构建你的应用程序。我们可以简单的把console加入到CONFIG行,window平台的makefile里包含这个设置。然而,假设我们只想运行在window平台时并且debug已经添加到CONFIG行时才把console添加CONFIG行。这需要两个嵌套的作用域。先创建一个作用域,在它里面再创建另一个。把需要处理的设置放在第二个作用域里,像这样:
win32 { debug { CONFIG += console } }
嵌套作用域可以使用冒号:连接在一起。最终的项目文件像下边一样:
CONFIG += debug HEADERS += hello.h SOURCES += hello.cpp SOURCES += main.cpp win32 { SOURCES += hellowin.cpp } unix { SOURCES += hellounix.cpp } !exists( main.cpp ) { error( "No main.cpp file found" ) } win32:debug { CONFIG += console }
就是这样,你现在已经完成了qmake的教程,准备好开始为你的开发项目编写项目文件吧。