qmake常用语法
一、注释:

  用“#”注释,表示到行尾均为注释。

二、include:

  包含别的文件,例如:include xx.pri。类似于c++的#include。。。

三、平台宏:

  win32/macx/unix/linux-g++等,分别对应于windows、mac、unix、linux等系统。

四、作用域:

  作用域和“if”语句很像,如果某个条件为真,作用域中的设置就会被处理,例如:

 

debug{
    TARGET = XXd
  }
  release{
    TARGET = XX
  }

  上面代码的意思是:如果是debug版本,可执行程序的名字是xxd,否则就是xx。可以这样写:

 

debug:TARGET = xxd
  release:TARGET = XX

  作用域也可以嵌套使用,例如:

win32{
    debug{
      TARGET = xxwd
    }
  }

  也可以这样写:

win32:debug{
    TARGET = xxwd
  }

  还可以加上else语句:

debug{
    TARGET = xxd
  }else{
    TARGET = xx
  }

 五、Qt+=: 添加额外的模块支持,例如Qt -= QtCore;Qt += network,phonon,xml,thread

二,关键字:操作符

1、“=”操作符:

  分配一个值给一个变量。例如:TARGET = myapp,这将会删掉原来对TARGET的任何设置,并将变量TARGET的值设置为myapp。

2、“+=”操作符:

  向一个变量的值的列表中添加一个值。例如:DEFINES += QT_DLL,把QT_DLL添加到makefile的预处理定义的列表中。

3、“-=”操作符:

  从变量的列表中移除一个值。例如:DEFINES -= QT_DLL,把QT_DLL从Makefile的预处理定义列表中移除。

4、“*=”操作符:

  仅仅在一个值不存在于一个变量的值的列表中的时候,把它添加进去。例如:DEFINES *= QT_DLL,只用在QT_DLL没有被定义在预处理定义的列表中时,它才会被添加进去。

5、“~=”操作符:

  将会替换任何与指定的值的正则表达式匹配的任何值。例如:DEFINES ~= s/QT_[DT].+/QT,将会用QT来替代任何以QT_D或QT_T开头的变量中的QT_D或QT_T。

三,关键字:常用变量

一、TEMPLATE变量:

  生成Makefile采用的模板。以下是可供选择的模板:

  app:建立一个应用程序Makefile,这个也是默认值,没有指定模板是默认是这个。

  lib:建立一个库的Makefile。

  vcapp:建立一个应用程序的visual studio项目文件。

  vclib:建立一个库的visual studio项目文件。

  subdirs:创建一个能够进入子目录并且为之生成为它调用make的Makefile。需要在后面用SUBDIRS=XX来指定那些子目录。

1、app模板:

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

  HEADERS:需要包含的头文件的列表。

  SOURCES:需要的源文件的列表。

  FORMS:需要的.ui文件的列表。

  LEXSOURCES:所有lex源文件的列表。

  YACCSOURCES:所有yacc源文件的列表。

  TARGET:可执行应用程序的名称。默认值为项目文件的名字。

  DESTDIR:放置可执行程序目标的目录。

  OBJECTS_DIR:放置obj中间文件的目录。

  MOC_DIR: moc转换文件路径。

  RCC_DIR: 资源文件路径。

  UI_DIR:ui文件转换的路径。

  RESOURCES:需要包含的资源文件。

  LIBS:依赖库的路径和名称 -L{xxdirxx} -l{xxnamexx}。

  LIBEXT: 产生lib的后缀。

  DEFINES:应用程序所需的额外的宏定义列表。

  INCLUDEPATH:应用程序所需的额外的包含路径列表。

  DEPENDPATH:应用程序所依赖的搜索路径。

  VPATH:寻找补充文件的搜索路径。

  DEF_FILE:只有Windows需要:应用程序所要连接的.def文件。

  RC_FILE:只有Windows需要:应用程序的资源文件。

  RES_FILE:只有Windows需要:应用程序所要连接的资源文件。

  TRANSLATIONS: 多国语言支持文件。

  INSTALLS: 要安装的文件。

  target.path: 安装的路径。

  详细请参考Qt帮助条目:qmake Variable Reference。

2、lib模板:

  lib模板告诉qmake为建立一个库而生成makefile。当使用这个模板时,除了“app”模板中提到系统变量,还有一个VERSION是被支持的。你需要在为库指定特定信息的.pro文件中使用它们。

  VERSION:目标库的版本号,例如:1.2.3。

3、subdirs模板:

  subdirs模板告诉qmake生成一个makefile,它可以进入到特定子目录并为这个目录中的项目文件生成makefile并且为它调用make。这个模板只有一个系统变量SUBDIRS可以被识别。

  SUBDIRS:这个变量中包含了所要处理的含有项目文件的子目录的列表。这个项目文件的名称是和子目录同名的,这样qmake就可以发现它。例如,如果子目里是“subapp”,那么在这个目录中的项目文件应该被叫做subapp.pro。

 

二、CONFIG变量:

  配置变量,指定了编译器所要使用的选项和所需要链接的库。

1、控制编译器标志的选项:

  release:应用程序将以release模式连编,如果“debug”被指定,它将被忽略。

  debug:应用程序将以debug模式连编。

  warn_on:编译器会输出尽可能多的警告信息,如果“warn_off”被指定,它将被忽略。

  warn_off:编译器会输出尽可能少的警告信息。

2、控制需要连接的库的选项:

  qt:应用程序是一个Qt应用程序,并且Qt库将会被链接。

  thread:应用程序是一个多线程程序。

  x11:应用程序是一个x11应用程序或者库。

  windows:只用于app模板,应用程序是一个windows下的窗口应用程序。

  console:只用于app模板,应用程序是一个windows下的控制台应用程序。

  dll:只用于lib模板,库是一个共享库。

  staticlib:只用于lib模板,库是一个静态库。

  plugin:只用于lib模板,库是一个插件,这将会使dll选项生效。

  例如:CONFIG += qt debug,使用qt库的应用程序,debug版本。

3、注意事项:必须使用“+=”,不要使用“=”,否则原来的设置会被清除。

 

三、变量用法:

1、自定义变量:

  MY_VARIABLE = value

  定义了一个变量MY_VARIABLE,并将值设置为value。

2、变量值的传递:

  可以通过在其它任何一个变量的变量名前加$$来把这个变量的值分配给当前的变量。例如:

  MY_DEFINES = $$DEFINES  

  现在MY_DEFINES变量包含了项目文件在这点时DEFINES变量的值。这也和下面的语句一样:

  MY_DEFINES = $${DEFINES}

四,关键字:常用函数

这里列出的不全,最好还是看Qt的帮助主题:qmake Function Reference

1、contains( variablename, value ):
  如果value存在于一个被叫做variablename的变量的值的列表中,那么成功,否则失败。例如:

 

contains( CONFIG, thread ) {
    DEFINES += QT_THREAD_SUPPORT
  }

  如果thread存在于CONFIG变量的值的列表中时,那么QT_THREAD_SUPPORT将会被加入到DEFINES变量的值的列表中。

2、count( variablename, number ):
  如果number与一个被叫做variablename的变量的值的数量一致,那么成功,否则失败。例如:

 

count( DEFINES, 5 ) {
    CONFIG += debug
  }

3、dirname(file):

  返回指定文件的目录名称。例如:

  

FILE = /etc/X11R6/XF86Config
   DIRNAME = $$dirname(FILE) #/etc/X11R6

4、error( string ):

  这个函数输出所给定的字符串,然后会使qmake退出。例如:

  error(An error has occurred in the configuration process.)

5、exists( filename ):

  如果指定文件存在,那么函数成功,否则失败。例如:

 

exists( /local/qt/qmake/main.cpp ) {
    SOURCES += main.cpp
  }

  如果/local/qt/qmake/main.cpp存在,那么main.cpp将会被添加到源文件列表中。

  注意可以不用考虑平台使用“/”作为目录的分隔符。

6、find( variablename, substr ):

  这将会放置variablename中所有匹配substr的值。substr也可以是正则表达式,而因此将被匹配。

  MY_VAR = one two three four
  MY_VAR2 = $$join(MY_VAR, " -L", -L) -Lfive
  MY_VAR3 = $$member(MY_VAR, 2) $$find(MY_VAR, t.*)

  MY_VAR2将会包含“-Lone -Ltwo -Lthree -Lfour -Lfive”,并且MYVAR3将会包含“three two three”。

7、include(filename):

  包含文件。

8、infile( filename, var, val ):

  如果filename文件(当它被qmake自己解析时)包含一个值为val的变量var,那么这个函数将会返回成功。你也可以不传递第三个参数(val),这时函数将只测试文件中是否分配有这样一个变量var。

9、isEmpty( variablename ):

  这和使用count( variablename, 0 )是一样的。如果叫做variablename的变量没有任何元素,函数返回成功否则失败。例如:

 

isEmpty( CONFIG ) {
    CONFIG += qt warn_on debug
  }

10、join( variablename, glue, before, after ):

  这将会在variablename的各个值中间加入glue。如果这个变量的值为非空,那么就会在值的前面加一个前缀before和一个后缀after。只有variablename是必须的字段,其它默认情况下为空串。如果你需要在glue、before或者after中使用空格的话,你必须提供(引用?)它们。

11、member( variablename, position ):

  返回函数的值列表中指定位置的值。如果变量值列表并不存在指定的位置,这将会返回一个空串。variablename是唯一必须的字段,如果没有指定位置,则默认为列表中的第一个值(position默认为0)。

12、message( string ):

  这个函数只是简单地在控制台上输出消息。

      message( "This is a message" )

  文本“This is a message”被输出到控制台上并且对于项目文件的处理将会继续进行。

13、replace(string, old_string, new_string):

  用讲string中的old_string用new_string代替,例如:

  MESSAGE = This is a tent.

  message($$replace(MESSAGE, tent, test))

  prints the message:

  This is a test.

14、system( command ):

  特定指令被执行并且如果它返回一个1的退出值,那么函数成功否则失败。例如:

 

system( ls /bin ) {
    SOURCES += bin/main.cpp
    HEADERS += bin/main.h
  }

  所以如果命令ls /bin返回1,那么bin/main.cpp将被添加到源文件列表中并且bin/main.h将被添加到头文件列表中。

15、warning(string):

  这个函数一直返回成功,并且会输出指定字符串给用户,跟message是同义词。