nmake工具的用法

[源] = [《Windows 环境下32位汇编语言程序设计（第2版）》]

2.4 make工具的用法

2.4.1 make工具是什么
    在DOS时期编写汇编程序的时候，编译器和链接器基本上不用什么参数，命令只有区

区两条:

      Masm xxx.asm;
      Link xxx.obj;

    只要做个批处理把xxx换成%1，然后在命令行键入asm.bat xxx就万事大吉了，很是方便。Win32编程就不一样了，不管编译器还是链接器都需要加上必要的选项，文件列表也多了起来，如链接器的命令行参数中要列出。bj, lib, res和def等多种文件，又多了资源编译这一步，如果用批处理实现，要加的参数太多太乱，而每次用手工一行行地键入命令的话，

那对程序员来说简直就是一场灾难。当然，一种简单的解决办法就是为每个编程项目单独建立一个批处理，每次改动后，运行批处理把所有模块重新编译一次，但是当程序很庞大的时候，这将花费很长时间，那么该如何处理呢?这时候就要用到make工具来维护代码了，从网上下载Win32汇编的例子程序时，常常发现除了*.asm和*.rc文件外，例子文件包中往往还有一个makefile文件，这就是给make工具用的。

    make工具可以看成是一个智能的批处理工具，它本身并没有编译和链接的功能，而是用类似于批处理的方式—通过调用makefile文件中用户指定的命令来进行编译和链接的。但是，批处理会执行全部命令将全部源文件编译，包括那些不必重新编译的源文件，而make工具则可根据目标文件上一次编译的时间和所依赖的源文件的更新时间自动判断应当编译哪些源文件，对没有更新过的文件不会处理，这样就可以大大提高程序调试的效率。

    举例说明，我们要写一个test.exe文件，生成最后的可执行文件有4个步骤:
    (1)汇编源文件x.asm，其中用到头文件。common.inc，它们经Ml.exe编译成x.obj ;
    (2)汇编源文件y.asm，用到头文件common.inc和y.inc，它们经Ml.exe编译成y.obj ;
    (3)资源脚本文件x.rc，经Rc.exe编译成x.res;
    (4)最后用Link将x.obj, y.obj和x.res链接成test.exe o

    可以看出，当程序调试的时候，如果修改了x.asm，也就是说x.obj的文件时间比x.asm要早，就需要重新进行步骤(1)和(4);如果修改了y.asm或y.inc，那么需要重新执行步骤(2)和(4);如果修改的是x.rc，则步骤(3)和(4)必须重新执行;如果修改的是common.inc,因为x.asm和y.asm都和它有关，所以步骤(1), (2)和(4)都要重新执行;如果同时修改了common.inc和x.rc，那么必须重复全部步骤。在这个例子中，文件的依赖关系就是:

    .test.exe依赖于x.obj, y.obj和x.res;
    .x.res依赖于x.rc;
    .y.obj依赖于y.asm, common.inc和y.inc o
    make可以根据文件的时间正确判断文件的新旧并执行相应的步骤。但make又是如何知道文件之间的依赖关系呢?这需要用户用一个描述文件来指定。前面提到的makefile就是这个描述文件，执行make工具的时候，它会默认用makefile做描述文件名来进行相应的工作，书写描述文件有规定的语法，虽然语法不是很简单，但写好以后就省事多了。
    Microsoft的make工具文件名为nmake.exe，它并不是MASM软件包的一部分，但可以在Visual C+十的Bin目录下找到。Borland公司的make工具文件名是make.exe，它已经包括在TASM 5.0工具包中。两者默认的描述文件名都是makefile，描述文件的语法也大同小异，只是使用时命令行参数有些不同。

2.4.2 nmake的用法

    在命令行键入nmake /?可以显示帮助信息，nmake的语法如下:
    nemake[选项][/f描述文件名][/x输出信息文件名1[宏定义][目标]
    说明如下:
    ./f参数—如果描述文件名不使用默认的makefile，可以用/f参数指定。
    ./x参数—如果想把屏幕输出的信息存到一个文件中，可以用/x参数指定(用DOS下的管道操作符nmake>文件名的方法无效)。
    .宏定义—可以用新的定义覆盖描述文件中的宏定义。
    .目标—指定建立描述文件中描述的某个文件，如上面的例子中默认是生成最后的test.exe文件，也可以用nmake x.res指定更新x.res文件。
    nmake常用的选项如表2.8所示。


    表2.8 nmake的常用选项:


/A 不检测文件时间，强制更新所有文件
/B 文件时间相等时也要更新文件
/D make时显示文件新旧信息
/N 显示make时要执行的命令，但并不真正执行
   /P一个比较有用的选择，make时显示详细的信息


    由于nmake的应用是基于文件时间的，当计算机的时钟不准确或文件拷贝到另一台计算
机后文件时间有些偏差，那么文件的更新可能会不正确，这时最好用//A选项强制把所有文件
更新一遍。在平时使用的时候，以makefile当做建立的描述文件名，那么仅键入不加参数的

nmake命令就可以完成所有工作了。

2.4.3描述文件的语法
    make工具最主要也是最基本的功能就是通过描述文件来描述源程序之间的相互关系并
自动维护编译工作，而描述文件需要按照某种语法进行编写，文件中需要说明如何编译各个
源文件并链接生成可执行文件，并要求定义源文件之间的依赖关系，为了更方便使用，文件
中同时可以用一些宏定义。描述文件一般需要包含以下内容:
    .注释
    .宏定义
    .显式规则
    .隐含规则
    在这里，首先为2.4.1节中有关test.exe的例子写出一个描述文件，再逐步介绍各部分的
书写语法。为了方便使用，一般都把描述文件的文件名取为默认文件名:makefile。这个例子
的makefile文件如下(注意前面括号里的是行号，不是文件的真正内容):

#nmake工具的描述文件例子
EXE = Test .exe
OBJS = x .obj \
      y .obj
RES=x.res
#指定输出文件
#需要的目标文件
#需要的资源文件
LINK_FLAG = /subsystem:windows
ML_FLAG = /c /coff
#链接选项
#编译选项
#定义依赖关系和执行命令
$(EXE):$(OBJS)$(RES)
      Link$(LINK_FLAG) /out:$(EXE)$(OBJS)$(RES)
$(OBJS):Common.inc
y.obj:y.inc
#定义汇编编译和资源编译的默认规则
.asm.obj:
      ml$(ML_ FLAG){1}lt;
.rc.res:
      rc{1}lt;
#清除临时文件
clean:
      del*.obj
      del*.res

1.注释和换行
    makefile中的注释是以#号开头一直到行尾的字符，当nmake工具处理到这些字符的时候，它会完全忽略#号及其后面的全部字符。
    当一行的内容过长的时候，可以用换行符来继续，makefile的换行符是\，如例子中的第三行和第四行可以合并为:

        OBJS = x. obi y. obi#需要的目标文件

    在使用换行符的时候要注意在“\”后面不能再加上其他字符，包括注释和空格，否则nmake检测到“\”不在一行的最后，就不会把它当成换行符解释，从而出现错误。

2.宏定义

    makefile中允许使用简单的宏定义指代源文件及其相关编译信息，可以把宏称为变量，在整个描述文件中，只要符合下面语法的行就是宏定义:
    变量名 = 变量内容
    如上面例子文件中的第2到第8行就是宏定义，在引用宏时只需在变量前加$符号，但是
要注意的是，如果变量名的长度超过一个字符，在引用时就必须加圆括号()，下面都是有效
的宏引用:

$(LINK FLAG)
$(EXE)
$A
$ (A)

其中最后两个引用是完全一致的。
    宏定义的使用可以使makefile的使用更灵活:首先可以使文件便于修改，比如把第8行和第18行中ml的选项部分写成宏定义，以后要改变编译选项的时候，只要直接在makefile文件头部改变宏定义就可以了，不必阅读修改整个makefile文件;其次，当不止一个地方用到同一个文件的时候，把文件名定义为宏定义可以减少错误，增加可读性，同时也可以便于修改;最大的好处是可以直接在命令行中用新的宏定义覆盖，比如在命令行中键入:
nmake ML_ FLAG=”/c /coff /F1，，

那么这时就会以新的//c /coff /Fl定义代替makefile中定义的/c /coff，在这种使用中要注意两个问题:一是宏名称要区分大小写，MLes FLAG和nil-flag是不一样的;二是定义值中有空格的时候要用双引号引起来(没有空格时可以不用双引号，如ML_FLAG=/c)，这使临时使用不同的参数编译文件时可以不必修改makefile。

3.显式规则

    makefile中包含有一些规则，这些规则定义了文件之间的依赖关系和产生命令，一个规则的格式是这样的:
目标文件:依赖文件;命令    (方法1)
或
目标文件:依赖文件          (方法2)
    命令
    在规则定义和命令行中，不能包含注释，例子中的第11和12行把宏定义展开后就是:
      test .exe: x.obj y.obj x.res
          Link /subsystem:windows /out:test .exe x.obj y.obj x.res
    这里的目标文件就是test.exe，它依赖于3个文件x.obj, y.obj和x.res，如果有必要，产生目标文件的命令就是下面的Link命令。规则可以用两种方法，用方法2的时候，命令可以从第二行开始，第一行的“;”省略，但是这时命令前面必须有一个Tab字符，否则nmake无法区分这究竟是命令还是别的定义。
    在同一个规则中，目标文件可以有多个，依赖文件也可以有多个，同时命令也可以由多个命令行组成，当然这时候就必须用第二种方法定义了，否则无法在同一行中写入多条命令。
    我们也可以用和上例中类似的方法定义其他规则，如x.obj或x.res的生成方法，但nmake如何知道哪个是最终要make的文件呢?实际上nmake默认将整个描述文件的第一条规则中的目标文件认为是最终文件，如果我们把11, 12行放到第13行后面，那么x.obj和y.obj的建立规则就成了第一条规则，nmake建立了x.obj和x.obj之后就不理会test.exe的建立了，所以我们必须把最终需要生成的文件放在第一条规则定义。当然，在nmake的命令行参数中可以指定要make的目标，如我们只需生成x.res文件，那么不必修改makefile将x.res的描述规则移动到最前面，而是直接在命令行键入以下命令即可:
      nmake x.res
    参数中也可以同时带好几个目标文件名，nmake会一一处理，如果指定的目标文件没有
对应的规则，nmake会返回一个出错信息:
fatal error U1073:don't know how to make 'xxx文件'
    当用户要求nmake去建造一个目标时，make会去找到这个目标的依赖规则，这时规则中定义的命令并不会立刻被执行，而是首先要做一些事情:nmake先去检查依赖文件是否是另一条规则的目标文件，如果是，则先处理这一条规则;如果不是，nmake再检查各个依赖文件的时间，看这些文件有没有比目标文件更新的，如果没有，nmake会决定不再重新建造目标文件，并给出提示:'xxx文件’is up-to-date，如果依赖文件有比目标文件更新的，才执行命令。
    所以一个顺序下来，所有的目标文件，以及它们的依赖文件，以及依赖文件的依赖文件都会被检查并更新，总而言之，一个目标文件的建立包含了顺序正确的指令链接，这个链接结构是树状的，目标文件是根，一级级扩展到多个文件，我们要求的是nmake去建立链接中处于根部的那个文件，nmake会根据链接结构从目标开始向初始状态前进，最后慢慢回来，在这个过程中执行建立每个文件所必需的命令，一直到最终目标建立完成。
    目标也可以没有依赖文件，而且目标也可以不是一个真正存在的文件，如例子第23行到第25行中的clean是一个目标，但我们并不是要生成一个clean文件，而是希望在文件调试完毕后用nmake来清除临时文件，当我们键入nmake clean的时候，工作目录下并没有clean这个文件，那么nmake就会去执行clean定义中的命令，因为nmake把每一个不存在的目标当做是一个过时的目标，如此一来，就会删除中间过程中的文件*.obj和*.res o    指出了目标文件全名的规则称为显式规则，但有些类别的文件的编译方法可以是雷同的，如从asm文件产生obj文件的命令总是用m1，从rc文件产生res文件的命令总是用rc.

对于每个文件都写一条规则有些多余，这时候就要用到隐含规则。

4.隐含规则

隐含规则可以为某一类的文件指出建立的命令，它具体定义了如何将带一个特定扩展名
的文件转换成具有另一种扩展名的文件，定义的格式是:
.源扩展名.目标扩展名:;命令     (方法1)

或
.源扩展名.目标扩展名:           (方法2)
      命令

    隐含规则的语法和显式规则相似，也是用“:”隔开，在“;”下面书写命令，也可以不用“;”而将命令写在第二行，同理，这时命令之前要加一个Tab字符。
    隐含规则不能有依赖文件，所以“:”下面没有内容，例子中的第17, 18行定义了从asm文件建立。bj文件的隐含规则，第19和20行定义了从rc文件建立res文件的隐含规则，隐含规则中无法指定确定的输入文件名，因为输入文件名是泛指的有相同扩展名的一整类文件，这时候就要用到几个特殊的内定宏来指定文件名，这些宏是$@，$*，$?和$<，它们的含义如下:
    .$@—全路径的目标文件。
    .$*—除去扩展名的全路径的目标文件。
    .$?—所有源文件名。
    .$<—源文件名(只能用在隐含规则中)。
    所以第19, 20行中的rc $<用于x.rc的时候就是rc x.rc，而用于y.rc时就是rc y.rc了。
    读者可以注意到一些显式规则没有命令行，如第13行的“$(OBJS): Common.inc”指出了所有的obj文件都依赖于Common.inc文件，第14行的“y.obj: y.inc”则指出了y.obj除了依赖第13行的规则外，还依赖于y.inc。但是第13行和第14行的两条规则都没有指出产生这些obj文件的命令，所以nmake处理的时候会到隐含规则中去找命令行，最后会用第18行的“ml $(ML_FLAG) $<”命令去产生这些。bj文件。