目 录
第1章 NMAKE
1.1 运行NMAKE
nmake其实是nmake.exe，它需要在DOS命令窗口下运行。如下图所示，在DOS命令窗口执行nmake /?，试图获取nmake.exe的帮助信息。
执行命令失败，原因是找不到nmake.exe在哪里，根本无法执行nmake.exe。为此，输入它的全路径名（这里是vc6的nmake.exe全路径名，因为中间有空格所以要加上双引号），如下图所示：
每次运行nmake.exe都要指定它的路径名？这也太麻烦了吧？解决方法有两个：
方法一：把C:\Program Files\Microsoft Visual Studio\VC98\Bin增加到环境变量Path；
方法二：运行nmake之前，首先运行VCVARS32.BAT，如下图所示：
说明：
1、方法一对所有程序都会有影响；
2、方法二运行VCVARS32.BAT也是修改环境变量Path，但是它的影响是局部的，只会影响本进程。当上图所示的DOS窗口关闭后，这种影响也随之消失。因此，推荐使用方法二。
每次打开DOS命令窗口，都要执行C:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32.BAT，是不是挺麻烦的？看看VC++2008开始菜单里的"Visual Studio 2008 命令提示"是怎么做的。它其实是一个快捷方式，其命令如下：
%comspec% /k ""C:\Program Files\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" x86 |
comspec是系统环境变量，运行上面的命令时%comspec%会被替换为该环境变量所代表的字符串，一般就是 c:\windows\system32\cmd.exe。上面命令的实质就是：运行cmd.exe程序，打开DOS命令窗口，然后再运行vcvarsall.bat这个批处理文件。x86是传递给vcvarsall.bat的参数。/k表示运行完vcvarsall.bat之后，DOS命令窗口不自动关闭。现在，就可以在这个DOS命令窗口里运行nmake.exe了。
借鉴VC++2008的做法，若要运行VC++6.0的nmake，可以创建一个快捷方式，让其运行如下命令：
%comspec% /k "C:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32.BAT" |
运行这个快捷方式，即可在弹出的DOS命令窗口里直接运行VC++6.0的nmake.exe了。
1.1.1 NMAKE的实质
NMAKE的实质是一个解释程序，用来执行makefile文件里的命令。
如：运行nmake，它将在当前目录下查找makefile文件，如果找到了就将其载入内存，然后执行该文件里的命令。
也可以指定其它文件，如：
nmake /ftest.mak 或 nmake /f test.mak |
均会把test.mak载入内存，然后执行这个文件里的命令。
使用NMAKE的重点在于编写makefile，执行预期的操作。
1.2 描述块
1.2.1 定义
makefile里，最重要的就是描述块（Description Blocks）。其结构为：
targets（目标） : dependents（依赖项） commands... （命令） |
下面是一个简单的makefile，它由一个描述块构成。
Test : echo 这是一个描述块 |
注意：
1、目标后面不要紧跟冒号，中间应该有一个空格。也就是说上面"Test :"中间的空格不能缺失；
2、命令以一个或多个制表符（09H）或空格符（20H）开头；
3、命令可以没有，也可以有多个。
运行nmake，这个描述块里的命令将被执行，即"echo 这是一个描述块"将被执行。
1.2.2 多个描述块
一个makefile可以有多个描述块，如下所示：
Test.exe : echo 生成exe Test.lib : echo 生成lib |
上面的makefile有两个描述块：Test.exe、Test.lib。运行nmake时，默认只会执行第一个描述块的命令，即"echo 生成exe"会被执行。
若要执行其它描述块的命令，可以给nmake传递一个参数，如：
nmake Test.lib 将执行描述块Test.lib的命令
若要执行多个描述块的命令，也可以给nmake传递参数，如：
nmake Test.lib Test.exe 将依次执行描述块Test.lib、Test.exe的命令
1.2.3 依赖
描述块里，可以指定依赖项。如：
Test.exe : 1.obj echo 生成exe 1.obj : echo 生成obj |
上面的描述块Test.exe依赖于描述块1.obj。当运行nmake时，将执行描述块Test.exe的命令，但Test.exe依赖于1.obj，因此1.obj里的命令将先被执行，然后才会执行块Test.exe的命令。结果就是"echo生成obj"、"echo生成exe"依次被执行。
一个描述块可以有零个到多个依赖项，多个依赖项之间以空格分隔。如下面的描述块Test.exe，它有两个依赖项1.obj、2.obj。
Test.exe : 1.obj 2.obj echo 生成exe |
1.2.4 长文件名
描述块的目标经常就是一个文件名。如果文件名属于长文件名，就应该用双引号。如下所示：
"VeryLongFileName.exe" : "VeryLongFileName.obj" echo生成exe "VeryLongFileName.obj" : echo生成obj |
1.2.5 多目标
下面有两个描述块，其命令是完全相同的：
A : echo A echo B B : echo A echo B |
可以将它们合并在一起，如下所示：
A B : echo A echo B |
上面的描述块就是多目标描述块。多个目标之间用空格分隔。
1.2.6 合并
一个makefile里允许描述块的目标重复，nmake对重复项将做合并处理。此时，要特别注意单冒号与双冒号的区别——单冒号合并依赖项，不合并内容；双冒号合并依赖项，同时合并内容。下面是一个例子：
makefile | 执行描述块ALL的命令顺序 | |
单冒号 | ALL : A echo allA ALL : B echo allB A : echo A B : echo B | 两个ALL被合并为 ALL : A B 合并依赖项 echo allA 不合并内容 执行结果： echo A echo B echo allA 注意：echo allB不会被执行，在这个地方会产生警告。 |
双冒号 | ALL :: A echo allA ALL :: B echo allB A : echo A B : echo B | 两个ALL被合并为 ALL : A B 合并依赖项 echo allA echo allB 合并内容 执行结果： echo A echo allA echo B echo allB |
1.3
宏1.3.1 定义、使用
假定某个makefile的内容如下，使用编译程序 cl.exe 编译三个cpp文件。
ALL : cl /c /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" 1.cpp cl /c /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" 2.cpp cl /c /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" 3.cpp |
可以发现，这三个cpp的编译参数是相同的。如果cpp很多，修改编译参数将会比较麻烦。这里，就可以使用宏。新的makefile内容如下：
CPP_PROJ=/c /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS" ALL : cl $(CPP_PROJ) 1.cpp cl $(CPP_PROJ) 2.cpp cl $(CPP_PROJ) 3.cpp |
CPP_PROJ=/c /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "_MBCS"就是用来定义宏的。编译时，通过$(CPP_PROJ)将这个宏代表的字符串提取出来。
注意：
1、宏的名称是区分大小写的；
2、对于不再需要的宏，可以通过!UNDEF命令取消。
1.3.2 作用域
参考下面的makefile：
Test.exe : 1.obj 2.obj echo 生成exe SOURCE=1.c 1.obj : echo 编译$(SOURCE) SOURCE=2.cpp 2.obj : echo 编译$(SOURCE) |
宏SOURCE有两份定义1.c和2.cpp。对于描述块1.obj而言1.c的定义离其最近，所以在1.obj这个块里$(SOURCE)就是1.c；同理在块2.obj里$(SOURCE)就是2.cpp。
1.3.3 宏替换
宏替换的格式为$(macroname:string1=string2)。具体请参考下面的内容：
CPPFILES=1.cpp 2.cpp OBJFILES=$(CPPFILES:.cpp=.obj) |
首先定义宏CPPFILES，其内容为1.cpp 2.cpp。OBJFILES=$(CPPFILES:.cpp=.obj)表示把CPPFILES里的.cpp替换为.obj（不会改变CPPFILES的值）然后赋给OBJFILES，现在OBJFILES的内容为1.obj 2.obj。
1.3.4 文件名宏
假定某个makefile的内容如下。
C:\Release\Test.exe : 1.obj 2.obj echo $@ echo $* echo $** echo $? echo $< |
在这个描述块里，$@、$?、$<……这些都属于文件名宏。具体如下（来自MSDN）
宏 名 | 说 明 |
$@ | 描述块目标名——路径、文件名、扩展名 这里就是C:\Release\Test.exe |
$$@ | 同上。Valid only as a dependent in a dependency 具体怎么用？ |
$* | 描述块目标名——路径、文件名，不含扩展名 这里就是C:\Release\Test |
$** | 所有依赖项 这里就是1.obj 2.obj |
$? | 比当前目标新的依赖项 这里就是1.obj 2.obj里比Test.exe新的依赖项集合 |
$< | 比当前目标新的依赖项，仅在推断规则下有效 |
$<的用法如下所示：将*.c编译为*.obj时可能就会用到这个推断规则，此时会执行描述块.c.obj，$<就是具体的.c文件。
.c.obj : echo $< |
文件名宏还可以加后缀R、D、F、B，如下面的例子：
C:\Release\Test.exe : echo $@ echo $(@R) echo $(@D) echo $(@F) echo $(@B) |
$@就是C:\Release\Test.exe，至于$(@R)、$(@D)、$(@F)、$(@B)的含义见下表（来自MSDN）
后缀 | 说 明 |
R | 去掉扩展名，即：C:\Release\Test |
D | 去掉文件名和扩展名，即：C:\Release |
F | 去掉前面的目录，即：Test.exe |
B | 去掉前面的目录和扩展名，即：Test |
1.3.5 递归宏
三个递归宏：MAKE、MAKEDIR、MAKEFLAGS。使用它们的例子如下：
ALL : echo $(MAKE) echo $(MAKEDIR) echo /$(MAKEFLAGS) |
注意：使用MAKEFLAGS的固定格式为/$(MAKEFLAGS)
1.3.6 内置宏
内置宏由nmake创建，makefile里可以修改、使用。vc6的内置宏如下表所示（来自MSDN）：
编译器 | 命令宏 | 选项宏 |
Macro Assembler | AS | AFLAGS |
Basic Compiler | BC | BFLAGS |
C Compiler | CC | CFLAGS |
COBOL Compiler | COBOL | COBFLAGS |
C++ Compiler | CPP | CPPFLAGS |
C++ Compiler | CXX | CXXFLAGS |
FORTRAN Compiler | FOR | FFLAGS |
Pascal Compiler | PASCAL | PFLAGS |
Resource Compiler | RC | RFLAGS |
最常用的就是CFLAGS、CPPFLAGS。
1.3.7 环境变量宏
环境变量宏与环境变量之间有着微小的差别，具体请见下一节的内容。
1.4 环境变量
1.4.1 查看
在makefile里，使用set命令可查看环境变量。如下所示
ALL : set |
1.4.2 使用
makefile里使用环境变量的格式为"%%名称%%"。如下面的makefile将显示环境变量OS的内容：
ALL : echo %%OS%% |
1.4.3 环境变量宏
nmake运行时，会为每一个环境变量生成一个宏。如：为环境变量Path、OS……生成宏Path、OS……所以也可以使用"$(名称)"的格式获得环境变量的值，如下面的makefile
ALL : echo $(OS) |
$(OS)取出的是宏OS的值。运行nmake时宏OS被初始化为环境变量OS的值，因此$(OS)取出的就是环境变量OS的值。
明白了这个道理，看看下面的makefile
ALL : set VAR=1 echo $(VAR) echo %%VAR%% |
通过set VAR=1创建了一个环境变量VAR，但是并没有创建宏VAR，因此$(VAR)取不出值。也就是说：makefile内部创建的环境变量无法通过"$(名称)"的格式获取其值。
1.4.4 传递
运行nmake时，可以在命令行里增加环境变量。如：
nmake CFG="Test - DEBUG" VERSION=5.3.1 |
nmake将增加两个环境变量 CFG 和 VERSION，同时根据它们创建宏CFG 和 VERSION。makefile里可以使用$(CFG)和$(VERSION)。
1.5 特殊字符
1.5.1 #
makefile里以#号开头的为注释行，nmake执行时注释行将被忽略。
下面的"#第一个makefile"就是注释行：
#第一个makefile Test : echo 这是一个描述块 |
允许#出现在一行中间，如下所示
STR=123#456 ALL : echo $(STR) |
上面的#456是注释，所以宏STR的值是123，而不是123#456
1.5.2 ^
为了表示如下特殊字符，需要在它们的前面加一个^符号
: ; # ( ) $ ^ \ { } ! @ —
如下面的makefile，宏STR的内容为123#456^789
STR=123^#456^^789 ALL : echo $(STR) |
^和后面的换行符会被解释为换行符，如下面的STR为123^\n。注意：STR=123^的下一行必须为空。
STR=123^
ALL : echo $(STR) |
1.5.3 \
\与后面的换行符会被替换为空格符，如下面的LINK32_OBJS为"StdAfx.obj" "Test.obj" "TestDlg.obj" "Test.res"。
LINK32_OBJS= \ "StdAfx.obj" \ "Test.obj" \ "TestDlg.obj" \ "Test.res" |
说明：
1、\结尾的下一行，行首的空格符、制表符被自动删除；
2、\必须紧跟换行符，如果\后面是空格符或制表符，就起不到连接下一行的作用。
1.5.4 %
两个%号被解释为一个，如：%%OS%%被解释为%OS%，即取环境变量OS的值。
1.5.5 $
两个$号被解释为一个，当然也可以用^$表示一个$。
1.6 规则
首先看下面的makefile
CPP=1.cpp 2.cpp OBJ=$(CPP:.cpp=.obj) ALL : $(OBJ) link $(OBJ) 1.obj : cl /c 1.cpp 2.obj : cl /c 2.cpp |
宏CPP的内容是所有的cpp文件，即1.cpp和2.cpp。宏OBJ=$(CPP:.cpp=.obj)表示宏替换，最终OBJ的内容为1.obj 2.obj。描述块ALL的实际内容如下：
ALL : 1.obj 2.obj link 1.obj 2.obj |
运行nmake时，描述块ALL的命令将被执行。ALL依赖于1.obj 和 2.obj 两个描述块，因此1.obj和2.obj这两个描述块的命令将首先被执行。它们分别编译1.cpp和2.cpp为1.obj和2.obj。最后调用 link 1.obj 2.obj 生成 exe 程序。
如果cpp文件有50个，按照上面的写法岂不是要写50个obj块？有没有更加简单的写法？答案就是使用规则（Rule）。
1.6.1 简单规则
下面是一个使用规则的makefile。.c.obj 就是.c文件编译生成.obj文件的规则；.cpp.obj就是.cpp文件编译生成.obj文件的规则。
CPP=1.c 2.c 3.cpp OBJ=$(CPP:.cpp=.obj) OBJ=$(OBJ:.c=.obj) ALL : $(OBJ) link $(OBJ) 1.obj : echo 1.c .c.obj : echo $< .cpp.obj : echo $** |
执行描述块ALL的命令时，需要1.obj、2.obj、3.obj。
1.obj没有问题，它是一个被明确定义的描述块，echo 1.c 被首先执行。
2.obj没有对应的描述块，这时会在规则里找。现在有两个规则：.c.obj和.cpp.obj。到底选择哪个呢？答案是看2.c和2.cpp哪个存在。如果2.c存在且时间比2.obj要晚就使用.c.obj规则，如果2.cpp存在且时间比2.obj要晚就使用.cpp.obj规则。命令echo $<中的$<是一个文件名宏，它要么是2.c要么是2.cpp。
3.obj与2.obj的处理流程相同，最终echo $**被执行。
1.6.2 预定义规则
预定义规则就是nmake已经定义的规则。上一节中的.c.obj和.cpp.obj就属于预定义规则。
对于预定义规则，makefile里无需再次定义，可直接使用。
下表就是部分预定义规则，节选自MSDN
规则 | 命令 | 缺省命令 |
.asm.exe | $(AS) $(AFLAGS) $*.asm | ml $*.asm |
.asm.obj | $(AS) $(AFLAGS) /c $*.asm | ml /c $*.asm |
.c.exe | $(CC) $(CFLAGS) $*.c | cl $*.c |
.c.obj | $(CC) $(CFLAGS) /c $*.c | cl /c $*.c |
.cpp.exe | $(CPP) $(CPPFLAGS) $*.cpp | cl $*.cpp |
.cpp.obj | $(CPP) $(CPPFLAGS) /c $*.cpp | cl /c $*.cpp |
.cxx.exe | $(CXX) $(CXXFLAGS) $*.cxx | cl $*.cxx |
.cxx.obj | $(CXX) $(CXXFLAGS) /c $*.cxx | cl /c $*.cxx |
1.6.3 自定义规则
下面的makefile创建了.txt.inf规则。一定要注意.SUFFIXES : .txt，它是.txt.inf规则能用起来的关键。
INFS=1.inf 2.inf Test.txt : $(INFS) copy $(INFS: =/B+)/B $(@F)/B .txt.inf : copy $< $(<B).inf .SUFFIXES : .txt |
这个makefile的执行逻辑：
1、Test.txt依赖于1.inf、2.inf；
2、根据规则.txt.inf生成1.inf和2.inf。其实就是执行如下两条命令：
copy 1.txt 1.inf
copy 2.txt 2.inf
3、最后执行copy $(INFS: =/B+)/B $(@F)/B，其实就是：
copy 1.inf/B+2.inf/B Test.txt/B
最终Test.txt的内容就是1.txt和2.txt合并后的内容。
1.6.4 批量规则
批量规则与简单规则的语法区别在于：批量规则最后是双冒号，简单规则最后是单冒号。参考下面的makefile文件
CPP=1.c 2.c 3.c OBJ=$(OBJ:.c=.obj) ALL : $(OBJ) link $** .c.obj: echo $< |
规则.c.obj后面是单冒号，因此echo $<将被执行三次，依次为1.c、2.c、3.c。把单冒号换成双冒号，则echo $<只执行一次，此时的$<内容是1.c 2.c 3.c。
1.6.5 规则中使用路径
可以在规则中加入路径，如：{src\}.c{Temp\}.obj。这样的话，输入文件（*.c）将在src目录里查找，输出文件（*.obj）将在Temp目录里查找、生成。
1.7 命令
1.7.1 命令前缀
命令前缀@表示命令执行时不会显示这条命令。如下面的del 1.txt执行时不会显示这条命令。
ALL : @del 1.txt |
命令前缀-表示命令执行失败时不会退出nmake。如下面的copy 1.txt 2.txt因为1.txt已经被删除，所以copy会失败并返回非零值。nmake发现copy返回值不为零，一般情况下会中止执行的，但是因为copy前面有-号nmake会继续执行下去。
ALL : del 1.txt -copy 1.txt 2.txt echo 复制完毕 |
命令前缀可以混合使用，如下面的copy命令
ALL : del 1.txt -@copy 1.txt 2.txt echo 复制完毕 |
1.7.2 内联文件
参考下面的makefile
OBJ=1.obj 2.obj 3.obj 4.obj \ 5.obj 6.obj 7.obj 8.obj …… ALL : $(OBJ) link $** |
假如obj文件非常多，那么连接命令 link 1.obj 2.obj 3.obj……将会非常长。在Windows里，命令行的长度是有限制的。如何摆脱这一限制呢？答案就是使用内联文件。改进后的makefile：
OBJ=1.obj 2.obj 3.obj 4.obj \ 5.obj 6.obj 7.obj 8.obj …… ALL : $(OBJ) link @<< $** << |
link @<<中的<<指定了一个匿名的内联文件，nmake会在Temp目录生成一个临时文件。link @<<中的@表示把这个临时文件当作响应文件，link从响应文件里读取命令行参数。
$**是写入临时文件的内容，具体的就是 1.obj 2.obj 3.obj 4.obj……注意$**前的空格符或制表符将被忽略
最后的<<不会写入文件，它表示完成写入。
nmake执行完毕后，内联文件默认会被删除掉。下面的makefile通知nmake保留内联文件，同时还指定了内联文件的名称为inline
OBJ=1.obj 2.obj 3.obj 4.obj \ 5.obj 6.obj 7.obj 8.obj …… ALL : $(OBJ) link @<<inline $** <<KEEP |
还可以指定多个内联文件，如下面的makefile
ALL : copy << /B + << /B 1.txt /B 123 << 456 << |
执行nmake之后，将生成1.txt，其内容为"123\r\n456\r\n"。它的执行逻辑如下：
1、copy命令里有两个<<，执行时将创建两个临时文件；
2、123和<<是往第一个临时文件里写入123\r\n；
3、456和<<是往第二个临时文件里写入456\r\n；
4、copy把两个临时文件合并写入1.txt。
1.8 预处理指令
C/C++里有预处理指令#include、#if...#elif...#else...#endif……。makefile里也有预处理指令，它们以!开头。
语 法 | 说 明 |
!ERROR text | 显示错误并终止nmake的运行 |
!MESSAGE text | 显示一条消息 |
!INCLUDE [<]filename[>] | 包含一个文件 |
!IF constantexpression !IFDEF macroname !IFNDEF macroname !ELSE[IF constantexpression |IFDEF macroname | IFNDEF macroname] !ELSEIF !ELSEIFDEF !ELSEIFNDEF !ENDIF | 条件预处理 |
!UNDEF macroname | 删除一个宏 |
658
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
