tmake使用指南.docx

tmake使用指南tmake是一个很好用的生成和管理makefile的工具，他是由Trolltech这家公司开发的，用perl写成。Trolltech这家公司的主打产品大家都知道是Qt。如果不是用tmake来管理makefile的话，那将会是一件痛苦的事情，虽然有autoconf等工具，但毕竟还是十分繁杂的，现在tmake将我们完全从繁琐的生成makefile的过程中解脱出来，只要很简单的步骤就可以生成makefile了。其实tmake原本写了使用在Qt上的，只不过不用Qt,我们也可以享受到他的好处，perl在这里面充分体现了他的强大，我一直以为，perl是一个很好的用于系统管理的语言。如果你会perl的话，你可以自己试着修改tmake。 由于tmake是基于perl的，所以请你确认你的机子上安装了perl。tmake在windows和unix上都有支持。而且它是免费的。本文以linux为平台讲述。 好了，下面我开始介绍tmake的安装1。确认你有perl5以后的版本并安装了（windows用户可选）2。在linux上解压tmake tar.gz，在windows上解压.zip文件。3。设置好tmake路径参数（参见下文）4。加入tmake/bin去你的执行路径。下面是一些例子：Unix Bourne shell: TMAKEPATH=/local/tmake/lib/linux-g+ PATH=$PATH:/local/tmake/bin export TMAKEPATH PATHUnix C shell: setenv TMAKEPATH /local/tmake/lib/linux-g+ setenv PATH $PATH:/local/tmake/binMicrosoft Windows: set TMAKEPATH=c:tmakelibwin32-msvc set PATH=%PATH%;c:tmakebin在上面设置的路径里面有各种平台支持文件和tmake执行文件。tmake支持的平台有： AIX, Data General, FreeBSD, HPUX, SGI Irix, Linux, NetBSD, OpenBSD, OSF1/DEC, SCO, Solaris, SunOS, Ultrix, Unixware and Win32UNIX用户请注意：tmake默认的是perl安装在/usr/bin下面，如果你的不是的话，请修改tmake文件第一行的参数。下面我们开始学习tmake的使用：我假设你有一个小的qt程序，他由一个C+ header和两个source file组成。首先，你要创建一个tmake工程文件，如：HEADERS = hello.hSOURCES = hello.cpp main.cppTARGET = hello下面我们来产生makefiletmake -o Makefile最后我们执行make命令编译hello这个程序。Makefile模板Tmake发行版本中有以下三个模板App.t用来创建生成发布使用程序的makefileLib.t用来创建生成libraries的makefileSubdirs.t用来创建目标文档在目录中的makefileTmake.conf这个configuration文件包含了编译选项和各种资源库我们上面创建的工程文件并没有包含进模板或者配置选项。默认的模板是app.t，默认的配置是“qt warn_on release“。 下面这个配置文件和上面的功能上是一样的TEMPLATE = appCONFIG = qt warn_on releaseHEADERS = hello.hSOURCES = hello.cpp main.cppTARGET = helloMakefile配置选项配置选项可以用在app.t和lib.t中，他们用来指示使用什么编译选项和连接什么库文件。他们有以下几个：1控制编译选项的release用来生成最优化编译（用于发布的软件），如果选了”debug”，此选项忽略debug调试时使用该选项，打开debug功能warn_on打开警告选项，产生比正常情况下多的警告。如果选了”warn_off”，此选项忽略warn_off关闭警告选项2控制程序/库文件类型的qt如果是生成qt程序，打开他（改选项是默认支持的）opengl 不说也知道是编OPENGL时用的thread 用来支持线程X11 用来支持X11windows 支持WINDOWSconsole 同样是WINDOWS下的控制台程序dll 生成动态连接库时使用staticlib 生成静态连接库时使用举个例子：假如我们的hello程序需要qt和opengl支持，并且还要打开debug，那么我们的配置就该是这样的TEMPLATE = appCONFIG = qt opengl debug（注意本行的改变）HEADERS = hello.hSOURCES = hello.cpp main.cppTARGET = hello应用程序模板（app.t）此模板支持以下选项HEADERS头文件SOURCES原程序文件TARGET目标文件DESTDIR放置目标文件的目录DEFINES告知C预处理编译器打开“-D“选项INCLUDEPATH设置库文件路径（-I选项）DEPENDPATH设置相关搜索路径DEF_FILEWINDOWS专用：连接一个.def文件RC_FILEWINDOWS专用：使用.rc文件（编译为.res）RES_FILEWINDOWS专用：连接.res文件库模板（lib.t）该模板让你编译创建一个动态或静态库。Lib.t支持和app.t相同的选项，同时还支持一个app.t不支持的选项：VERSION。VERSION 是一个版本号。例如：1.40，版本号对于动态库是十分重要的。Subdirs模板（subdirs.t）当你的程序文件太多时，你可以使用它。他将你所列出的文件夹全部包括进去，并进行编译。工程文件的语法工程文件十分好写，你可以随意添加或删减各个选项。设置一个选项如下：HEADERS = gui.h xml.h url.h如果你的选项不能再一行内写完的话，你可以使用来分割他例如：HEADERS = gui.h xml.h url.h工程文件使用空白来分割各个元素，这也就表明你不能将带有空格的元素用在工程文件中（除了INCLUDEPATH选项，他使用“；”来分割元素）。例如：INCLUDEPATH = C:Program FilesDBLibInclude;C:qtincludeTmake支持变量扩展，使用”$”来扩展工程变量ALLFILES = $HEADERS $SOURCES你可以赋值给工程变量，也可以添加变量例如：A = abcX = xyzA += def# A = abc defX *= xyz# X = xyzB = $A# B = abc defB -= abc# B = defX /= s/y/Y/# X = xYz*=操作符添加值给变量（如果变量没有该值的话）。/= 执行规则表达式。当然了，你还可以在命令行下赋值（运行tmake时）。例如，如果你想要打开debug选项的话，可以这样tmake CONFIG+=debug 当你想对不同平台进行编译时使用unix:或者win32:标志符SOURCES = common.cpp # common for all platformsunix:SOURCES += unix.cpp # additional sources for Unixwin32:SOURCES += win32.cpp # additional sources for Windowsunix:LIBS += -lm # on Unix we need the math lib而且，你可以设置平台编译器相关选项，方法如下linux-g+:TMAKE_CFLAGS = -fno-rtti同时你还可以自定义模板，不过那要你对tmake比较了解才行。运行tmake写了那么多的如何创建工程文件的东东，下面到了如何运行tmake的时候了。Tmake的使用方法如下：tmake 选项 project files or project settings选项:-e expr执行perl表达式，忽略模板文件-nodepend不产生关联信息-o file指定输出文件（常用）-t file制定模板文件（覆盖工程文件中的模板变量）-unix强制使用unix模式-v打开debug和warn_on选项-win32强制使用win32模式默认的工程文件后缀名为”.pro”,默认的模板文件后缀为”.t”.如果你不指定他们的话，tmake会自动为你加上这是一个基本的使用方式：(工程文件是hello)tmake hello o Makefile下面是打开debug的使用方式：tmake hello “CONFIG+=debug” o Makefile这是指定TMAKEPATH地用法：tmake TMAKEPATH=/local/tmake/lib/hpux-g+ -o Makefile这是执行PERL表达式的用法（打印头文件和源文件名）tmake hello e Expand(“HEADERS”,”SOURCES”)请注意：所有的命令行变量设置请放到工程文件后面，否则工程文件将会覆盖他们。其他小工具progenprogen为你创建工程文件，使用方法如下：progen n hello o 如果没有指定.cpp或.h文件的话，progen或搜索所有在当前目录和他的子目录的所有文件（除了moc_*.cpp）用法：progen 可选项 C/C+ 头文件和源文件可选项：-lower将文件名小写（在windows下比较有用）-n name定义工程名（即目标名）-o file定义输出文件-t file制定模板文件高级话题如果你还想要制定特殊的选项或者想添加makefile规则的话，那么就请继续往下看罢如果你想要平台关联的设置的话，你可以在工程文件中这样写solaris-cc:TMAKE_CC = /opt/bin/CC_5.0solaris-cc:TMAKE_CFLAGS = -ptsunix:TMAKE_LIBS = -lXextwin32:INCLUDEPATH = c:myincludewin32-borland:DEFINES = NO_BOOL创建自己的模板如果你懂perl的话，那么对你来说tmake就没有什么限制了。不过首先你要了解一下tmake是如何工作的。模板处理当你运行tmake时，他首先读取tmake.conf文件，这个配置文件和工程文件的语法是一样的。然后tmake读取工程文件并且设置从工程文件中读取的变量。例如：HEADERS,SOURCES等等。所有的变量都存储在一个名叫project的全局散列数组中。例如，在处理完后$project“SOURCES”包含了”hello.cpp main.cpp”。当tmake.conf和工程文件都读完了后，tmake开始一行一行的读取模板文件并执行任何他发现的perl脚本l在”#$”后该行的所有字符都被认为时perl脚本l从”#$”到”#$”的所有字符也被认为是perl脚本l“#!”后的该行全部是注释l其他的直接被输出例子：#! This is a comment which will be removed.This text will appear in the output.#$ $text = The header file(s) are: . $projectHEADERS;# This text also appears in the output.#$ $a = 12; $b = 13; $text = $a * $b;#$Thats all.输出语句： This text will appear in the output. The header file(s) are: hello.h # This text also appears in the output. 156Thats all.将tmake与Lex和yacc联合使用标准的tmake模板知道如何处理C和C+文件，但也许你还要处理其他的文件并要将它们连接进入你的工程中。一个典型的例子是当你建造一个分析器时你要处理lex和yacc文件。分析模板： #! #! parser.t: This is a custom template for building a parser #! #$ IncludeTemplate(app.t); # Lex/yacc programs and options LEX =flex YACC =#$ $text = ($is_unix ? yacc -d : byacc -d); # Lex/yacc files LEXIN =#$ Expand(LEXINPUT); LEXOUT =lex.yy.c YACCIN =#$ Expand(YACCINPUT); YACCOUT =y.tab.c YACCHDR =y.tab.h PARSER =#$ Expand(PARSER); # Process lex/yacc files $(LEXOUT): $(LEXIN) $(LEX) $(LEXIN) $(PARSER): $(YACCIN) $(LEXOUT) $(YACC) $(YACCIN) #$ $text = ($is_unix ? -rm -f : -del ) . $(PARSER); #$ $text = ($is_unix ? -mv : -ren ) . $(YACCOUT) $(PARSER);分析模板加入一些用于建造lex和yacc部分的规则。这个模板可用于unix或window