翻译qmake文档 目录

本章原英文文档:http://qt-project.org/doc/qt-5/qmake-common-projects.html

构建常见的项目类型
 
     本章描述如何设置基于Qt的应用程序、库和插件的三种常见项目类型的qmake项目项目文件。虽然所有的项目类型使用大量相同的变量,但是它们中的每一个都使用项目特定的变量来自定义输出文件。
     这里不会描述特定于平台的变量。更多详细修改请查看  Qt for Windows - Deployment 和 Qt for Mac OS X.
绑定一个应用程序
 
     app模板告诉qmake生成将要构建应用程序的Makefile.使用这个模板,可以用下边的任何一个选项添加到CONFIG变量定义来指定应用程序的类型:
 
选项 描述
windows 这个应用程序是一个window Gui应用程序
console 仅限于应用程序模板:这个应用程序是一个windows控制台应用程序
testcase 应用程序是一个自动化测试
 
 
当使用这个模板时,下面的qmake系统变量可以被识别。你可以在.pro文件里使用这些变量指定应用程序相关的信息。
 
HEADERS -应用程序头文件的列表。
SOURCES -应用程序c++源文件的列表。
FORMS - 应用程序UI文件的列表(用Qt Designer创建的)
LEXSOURCES -应用程序Lex 源文件的列表
YACCSOURCES - 应用程序Yacc 源文件的列表
TARGET - 应用程序可执行文件的名称。它默认是项目文件的名称。(如果需要扩展名,会自动添)
DESTDIR - 存放目标可执行程序的文件夹 。
DEFINES - 应用程序需要的额外添加的预处理定义列表。
INCLUDEPATH - 应用程序所需要的额外包含路径列表。
DEPENDPATH - 应用程序所依赖的搜索路径。
VPATH - 用于找到提供文件的搜索路径
DEF_FILE - 只用于windows :应用程序要链接的.def文件
RES_FILE - 只用于windows :应用程序的资源文件。
RES_FILE - 只用于windows :应用程序要链接的资源文件。
     你只需要使用你有值的系统变量。例如,如果你没有额外的 INCLUDEPATH那么就不需要指定它。qmake将会自动添加必须的默认值。一个示例项目文件可能像下边这样
 
TEMPLATE = app
DESTDIR = c:/helloapp
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
DEFINES += USE_MY_STUFF
CONFIG += release
 
     由于这些项都是单值,像模板或目标目录,我们使用“=”;但对于多值我们使用 "+=" 来添加到现有类型项。使用“=”用新值替换变量的值。例如,如果我们这样写DEFINES=USE_MY_STUFF,其它的所有定义都会被删除
构建测试用例
     一个测试用例项目是用于作为一个自动测试运行的app项目。通过添加testcase到CONFIG变量可以把任何app标记为测试用例。
     对于testcase项目,qmake会在生成的Makefile里插入一个检查目标。这个目标将会运行这个应用程序。如果它终止退出代码等于0这个测试被认为通过。
     检查目标会通过自动递归SUBDIRS项目。这意味着它可能会发出一个使检查命令从SUBDIRS项目内部来运行一个完整的测试套件。
     检查目标的运行可能会被一些Makefile变量自定义。这些变量是
 
变量 描述
TESTUNNER 在每个测试命令前添加一个命令或shell片段。例如, use-case 是一个 “timeout" 用于如果它在一个指定的时间内没有完成,将被终止测试。
TESTARGS 每附加到每个测试命令的附加参数。例如,它可能有用的传递附加参数从测试设置输出文件和格式化。(就像 QTestLib支持的 -o filename,format选项)
注意: 当调用make工具而不是在.pro文件里,这些变量必须被设置。大多数make工具支持在命令行直接设置Makefile变量
 
# Run tests through test-wrapper and use xunitxml output format.# In this example, test-wrapper is a fictional wrapper script which terminates# a test if it does not complete within the amount of seconds set by "--timeout".# The "-o result.xml,xunitxml" options are interpreted by QTestLib.
make check TESTRUNNER="test-wrapper --timeout 120" TESTARGS="-o result.xml,xunitxml"
测试用例项目可以在CONFIG选项中使用下面的配置,更进一步的自定义设置。
选项 描述
insignificat_test 在检查期间测试退出代码将被忽略
 
     测试用例会被经常使用 QTest 或 TestCase编写,但这并不需要使用 CONFIG+=testcase 和 make check。 唯一主要的需要是测试程序以零退出代码为成功,用非零退出表示失败。
 
构建库
 
lib模板告诉qmqke生成一个将要构建一个库的makefile。当使用这个模板,除了app模板支持的的系统变量,也支持VERSION变量。在你的.pro文件里使用这些变量指定这个库的相关信息。     
     当使用lib模板时,下边的选项可以添加到CONFIG变量来确定构建库的类型:
选项 描述
dll 这个库是一个共享库(dll).
staticlib 这个库是一个静态库。
plugin 这个库是一个插件。
也可以定义下边的选项用来提供库的附加信息。
 VERSION - 目标库的版本号。如例 2.3.1
     库的目标文件名是依赖于平台的。例如,在X11和Mac OS X,库的名字将用lib作为前缀。在windows平台,文件名没有前缀。
     构建插件
     使用lib库来构建插件,就像前一章描述的一样。这用来告诉qmake为工程生成一个Makefile, 将为每一个平台构建一个适当的插件,通常以库的形式。与普通的库一样,VERSION变量指定插件的信息。

 VERSION - 目标库的版本号. 如 2.3..
构建Qt Designer 插件
使用一组特定的配置设置来构建Qt Designer插件,这些配置依赖于系统对Qt的配置。为了方便,通过在QT变量里添加designer来启动这些设置。例如:

QT +=  widgets designer
基于插件项目的更多示例,请查看 Qt Designer Examples
在Debug和Release模式下构建和安装
有时,它是必要在debug和release两种模式下构建一个项目。尽管CONFIG变量可以同时保存debug和release两个选项,但是只有最后指定的选项会被应用。
在两种模式下构建
     为了启动项目在两种模式下均构建,你必须把 debug_and_release 选项添加到CONFIG变量:
CONFIG += debug_and_release

CONFIG(debug, debug|release) {
TARGET = debug_binary
} else {
TARGET = release_binary
}
上面的代码片段作用域修改在每个模式下的构建目标用来确保结果目标拥有不同的名字。为目标提供不同的名字确保两者不会被彼此覆盖。
当使用qmake处理项目文件时。它将会生成一个makefile规则,用以允许项目在两种模式下构建。可以通过下面的方式调用:
make all
在项目文件里可以把build_all选项添加到CONFIG变量,用来确保项目默认是在两种模式下生成:
CONFIG += build_all

这样允许Makefile可以使用默认的规则处理
make

在两种模式下安装
build_all选项确保在安装规则被调用时将安装指向的两个目标版本:
make install
也可以根据目标平台自定义构建目标的名字。例如,一个库或插件可以在windows和Unix平台使用不同的命名习惯。
CONFIG(debug, debug|release) {
mac: TARGET = $$join(TARGET,,,_debug)
win32: TARGET = $$join(TARGET,,d)
}
在上面代码片段的默认行为是修改在debug模式下进行构建生成的目标名字。可以把else语句添加到作用域用于在release模式下做同样的事。目标名字未被修改,保持原样。

翻译qmake文档(四) Building Common Project Types的更多相关文章

  1. 翻译qmake文档 目录

    利用空闲时间把qmke的文档翻译出来,翻译水平有限,有些地方翻译的不好,请谅解, 如果您能指出来,我会很感激并在第一时候做出修改. 翻译qmake文档(一) qmake指南和概述 翻译qmake文档( ...

  2. 翻译qmake文档(三) Creating Project Files

    翻译qmake文档 目录   原英文文档:http://qt-project.org/doc/qt-5/qmake-project-files.html   创建项目文件 项目文件包含qmake构建你 ...

  3. 翻译qmake文档(一) qmake指南和概述

    翻译qmake文档 目录 英文文档连接: http://qt-project.org/doc/qt-5/qmake-manual.html http://qt-project.org/doc/qt-5 ...

  4. 翻译qmake文档(二) Getting Started

    翻译qmake文档 目录 原英文文档: http://qt-project.org/doc/qt-5/qmake-tutorial.html         本教程教讲授qmake基础知识.这个手册里 ...

  5. 翻译qmake文档 目录(四篇)

    http://www.cnblogs.com/li-peng/p/4026133.html

  6. 中文翻译:pjsip文档(四)之ICE Session的使用方法

    1:pjsip教程(一)之PJNATH简介 2:pjsip教程(二)之ICE穿越打洞:Interactive Connectivity Establishment简介 3:pjsip教程(三)之ICE ...

  7. Google翻译PDF文档

    Google翻译PDF文档 翻译软件虽多如牛毛,但有关整段/全文翻译,堪用的软件极少, 涉及专业技术的文献.胜任翻译工作的人力稀缺.少不了project师讴心沥血. 由于多是PDF格式.即使要翻译个概 ...

  8. c#中操作word文档-四、对象模型

    转自:http://blog.csdn.net/ruby97/article/details/7406806 Word对象模型  (.Net Perspective) 本文主要针对在Visual St ...

  9. 【swupdate文档 四】SWUpdate:使用默认解析器的语法和标记

    SWUpdate:使用默认解析器的语法和标记 介绍 SWUpdate使用库"libconfig"作为镜像描述的默认解析器. 但是,可以扩展SWUpdate并添加一个自己的解析器, ...

随机推荐

  1. 烂泥:apache密码生成工具htpasswd的应用

    本文由秀依林枫提供友情赞助,首发于烂泥行天下. 1. htpasswd的作用与安装 2. htpasswd命令详解 3. htpasswd的实例 4. htpasswd的应用 一.htpasswd的作 ...

  2. mysql 性能优化方案 (转)

    网 上有不少mysql 性能优化方案,不过,mysql的优化同sql server相比,更为麻烦与复杂,同样的设置,在不同的环境下 ,由于内存,访问量,读写频率,数据差异等等情况,可能会出现不同的结果 ...

  3. Windows Azure HDInsight 使用技巧

    Windows Azure HDInsight是一个面向大数据的PaaS服务,是PaaS版本的Hadoop.HDInsight是微软与Hortonworks合作的产物.可以理解为Hortonworks ...

  4. MMORPG大型游戏设计与开发(客户端架构 part2 of vgui)

    这一节我将讲解vgui的基础系统部分,也是该库提供给外部使用的一些重要接口.作为UI部分比较重要的部分,该节有着至关重要的部分,如果没有看到上一节内容,请留意下面的连接.我们现在可以猜想一下在客户端U ...

  5. java基础算法之冒泡排序

    接触冒泡算法还是大一了,学习C语言的冒泡算法.现在唯一记得就是冒泡与选择了.出来刚刚工作的时候觉的算法基本没撒用处,现在发现这些都是很好的基础.因此自己也准备重新拾起这些知识. 冒泡排序 泡排序是一种 ...

  6. Jetty使用攻略

    jetty作为一款小型的web容器用处很大,因为其小巧强大,经常作为嵌入式的组件处理http交互. Jetty 作为一个独立的 Servlet 引擎可以独立提供 Web 服务,但是它也可以与其他 We ...

  7. hdu-5493 Queue(二分+树状数组)

    题目链接: Queue Time Limit: 4000/2000 MS (Java/Others)    Memory Limit: 65536/65536 K (Java/Others)Total ...

  8. GitHub 下载文件夹

    工具 TortoiseSVN 步骤 1.打开要下载的项目,选中要下载的文件夹,右键 选择 复制链接地址 2.把链接中的 tree/master 改成 trunk ,(trunk是master分支,可以 ...

  9. 微软云Azure Website 远程调试

    微软云Azure Website 远程调试 是可以的 但是只有48小时,要在后台开启,所以还是很麻烦的啊! 但是安全性提高了,不得不承认哦

  10. 使用C#向后台ACCESS数据库添加数据

    Microsoft Office Access是由微软发布的关系数据库管理系统.它结合了 MicrosoftJet Database Engine 和 图形用户界面两项特点,是 Microsoft O ...