【原创】分享NMake模板，全自动化的Makefile

[老邓]

2009-10-09更新：NMaker编写完成：http://topic.csdn.net/u/20091006/00/98203b78-394d-4f76-83c1-42ade61c586c.html
摘要：本文告诉你如何自动化管理一个Makefile工程，自动化到你在初始化设置后，不再需要手工修改Makefile就可以随意的向工程增删文件，且保持良好的文件依赖关系。

给个图先：

也许，IDE让我们忘记了NMake，然而，有的时候，她还是必需的。
近期研究Eclipse CDT，越来越被其强大的代码编辑功能、强大的智能提示所折服。于是，坚定了脱离Code::Blocks工程管理，转而使用nmake管理工程的理念！
实践：编写一个易用的Makefile模板，证明写Makefile也是一件很简单的事！

先发布在此，后续会不断完善。
欢迎批评指正！

简介：一共需要三个文件，一个工具。
其中文件Config.mk用于配置编译器，CPU类型；文件Depends.mk通过工具NMaker.exe实现自动化的文件依赖；文件Makefile中可灵活的由用户自由定制，以及决定是否使用预编译头文件；工具NMaker.exe用于自动生成文件的依赖及文件的编译链接配置文件Depends.mk，也正因为如此，称之为“全自动化”Makefile。

优点：在模板基础上略加修改Config.mk和Makefile，此后文件依赖、加入编译的工作交给工具NMaker.exe完成。从此，编写Makefile将是一件轻松、愉快的工作，享受强大的定制能力，方便的编译能力，快捷的调试能力吧！

说明：目前暂不提供NMaker.exe，原因是还需完善功能。等时间成熟，会发布在：http://blog.qpsoft.com

补充：此模板如果配合Eclipse CDT，将会发现非常的方便。从编译、调试、运行都非常轻易的完成。要从Debug转向Release，只需要修改Config.mk，将DEBUG = 1修改为DEBUG = 0即可，其他配置类似，详情见后面提供的模板。由于Config.mk由不同Makefile共享，所以修改一处，即可应用到包含该配置的所有工程。
可以添加任意target来达到特定目的：

Config.mk文件：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

# 输出目录
ROOT = D:\DengYC\Projects\NMaker

# 工程类型
DEBUG = 1
UNICODE = 1
CPU = X86

# 编译选项，只读！
CC = cl
CFLAGS = /nologo /c /W4 /Zc:forScope /Zc:wchar_t /EHsc

!IF "$(DEBUG)" == "1"
CFLAGS = $(CFLAGS) /Od /Ob0 /MTd /ZI /D"_DEBUG"
!ELSE
CFLAGS = $(CFLAGS) /O2 /Ob1 /MT /Zi /D"NDEBUG"
!ENDIF

!IF "$(UNICODE)" == "1"
CFLAGS = $(CFLAGS) /D"_UNICODE" /D"UNICODE"
!ENDIF

CFLAGS = $(CFLAGS) /Fo"$(OUT)\\"  /Fd"$(OUT)\$(TARGET).pdb"

# 链接选项，只读！
LK = link
LFLAGS = /NOLOGO /MANIFEST:NO /MACHINE:$(CPU)

!IF "$(DEBUG)" == "0"
LFLAGS = $(LFLAGS) /OPT:REF /OPT:ICF
!ENDIF

LFLAGS = $(LFLAGS) /DEBUG /PDB:"$(OUT)\$(TARGET).pdb" /OUT:"$(BIN)"
LFLAGS = $(LFLAGS) kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib \
	shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib

# 编译资源，只读！
RC = rc
!IF "$(DEBUG)" == "1"
RFLAGS = /nologo /l 0x804 /D"_DEBUG"
!ELSE
RFLAGS = /nologo /l 0x804 /D"NDEBUG"
!ENDIF

Depends.mk文件：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

OBJS = \
	"$(OUT)\Main.obj" \
	"$(OUT)\Parser.obj" \

SRC=.\Main.cpp
"$(OUT)\Main.obj" : $(SRC) "$(OUT)" "$(PCH)"

SRC=.\Parser.cpp
"$(OUT)\Parser.obj" : $(SRC) "$(OUT)" "$(PCH)"

.\Main.cpp : \
	".\Parser.h"\
	
.\Parser.cpp : \
	".\Parser.h"\
	

Makefile文件：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

.SILENT:
!INCLUDE "Config.mk"

TARGET = NMaker
OUT = $(ROOT)\$(TARGET)
BIN = $(OUT)\$(TARGET).exe

CFLAGS = $(CFLAGS) /D"_CONSOLE"

USEPCH = 1
!IF "$(USEPCH)" == "1"
PCH = $(OUT)\$(TARGET).pch
CFLAGS_PCH = $(CFLAGS) /Fp"$(PCH)" /Yc"StdAfx.h"
CFLAGS = $(CFLAGS) /Fp"$(PCH)" /Yu"StdAfx.h"
!ENDIF

all : "$(BIN)"

clean :
	rmdir /S /Q "$(OUT)"
	
debug :
	windbg.bat $(BIN)

run :
	$(BIN)

"$(OUT)" :
	if not exist "$(OUT)" mkdir "$(OUT)"

all : "$(BIN)"
	copy /B /V /Y $(BIN) $(ROOT) >nul
	copy /B /V /Y $(OUT)\$(TARGET).pdb $(ROOT) >nul
	echo NOTICE: '$(TARGET)' Build Finished.

.c{$(OUT)}.obj::
	$(CC) @<<
	$(CFLAGS) $< 
<<

.cpp{$(OUT)}.obj::
	$(CC) @<<
	$(CFLAGS) $<
<<

!INCLUDE "Depends.mk"

"$(BIN)" : "$(OUT)" $(OBJS) "$(OUT)\StdAfx.obj" "$(OUT)\Version.res"
	$(LK) @<<
	$(LFLAGS) $(OBJS) "$(OUT)\StdAfx.obj" "$(OUT)\Version.res"
<<

"$(OUT)\StdAfx.obj"	"$(PCH)" : .\StdAfx.h "$(OUT)"
!IF "$(USEPCH)" == "1"
	$(CC) @<<
	$(CFLAGS_PCH) .\StdAfx.cpp
<<
!ENDIF

SRC=.\Version.rc
"$(OUT)\Version.res" : $(SRC) "$(OUT)"
	$(RC) $(RFLAGS) /Fo"$(OUT)\Version.res" $(SRC)

那么，如果涉及到一个工程中有多个Makefile，需要构建不同的DLL、Lib、Plugins，那又该如何？
简单：只需要修改Makefile即可。
为节省篇幅，以下示例只包含了Makefile中的不同之处供参考。

DLL工程部分示例：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

.SILENT:
!INCLUDE "..\Config.mk"

TARGET = dllname
OUT = $(ROOT)\$(TARGET)
BIN = $(OUT)\$(TARGET).dll
LFLAGS = $(LFLAGS) /DLL

Lib工程部分示例：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

.SILENT:
!INCLUDE "..\Config.mk"

TARGET = libname
OUT = $(ROOT)\$(TARGET)
BIN = $(OUT)\$(TARGET).lib
LK = link /LIB
LFLAGS = /NOLOGO /MACHINE:$(CPU) /OUT:"$(BIN)"

Windows工程部分示例：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

.SILENT:
!INCLUDE "..\Config.mk"

TARGET = wingui
OUT = $(ROOT)\$(TARGET)
BIN = $(OUT)\$(TARGET).exe
PCH = $(OUT)\$(TARGET).pch
CFLAGS_PCH = $(CFLAGS) /Fp"$(PCH)" /Yc"StdAfx.h"
CFLAGS = $(CFLAGS) /Fp"$(PCH)" /Yu"StdAfx.h"

当构建一个大型工程时，在最上级目录中只需要定义进入各目录的Makefile，如下图所示：

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

.SILENT:

all :
	cd "$(MAKEDIR)\win"
	$(MAKE) /nologo /$(MAKEFLAGS)
	cd "$(MAKEDIR)"
	
	cd "$(MAKEDIR)\cmd"
	$(MAKE) /nologo /$(MAKEFLAGS)
	cd "$(MAKEDIR)"
	
	cd "$(MAKEDIR)\dll"
	$(MAKE) /nologo /$(MAKEFLAGS)
	cd "$(MAKEDIR)"
	
	cd "$(MAKEDIR)\lib"
	$(MAKE) /nologo /$(MAKEFLAGS)
	cd "$(MAKEDIR)"

clean :
	cd "$(MAKEDIR)\win"
	$(MAKE) /nologo /$(MAKEFLAGS) clean
	cd "$(MAKEDIR)"
		
	cd "$(MAKEDIR)\cmd"
	$(MAKE) /nologo /$(MAKEFLAGS) clean
	cd "$(MAKEDIR)"
	
	cd "$(MAKEDIR)\dll"
	$(MAKE) /nologo /$(MAKEFLAGS) clean
	cd "$(MAKEDIR)"
	
	cd "$(MAKEDIR)\lib"
	$(MAKE) /nologo /$(MAKEFLAGS) clean
	cd "$(MAKEDIR)"

[老邓]

来个wxWidgets的例子，其中WX这个环境变量可以在Eclipse里建立，也可以在系统环境变量里添加。如果只要Eclipse添加，则不能在命令行编译。

#----------------------------------------------
# Copyright (C) QPSOFT.COM All rights reserved. 
#----------------------------------------------

.SILENT:
!INCLUDE "Config.mk"

TARGET = CaiPiao
OUT = $(ROOT)\$(TARGET)
BIN = $(OUT)\$(TARGET).exe

CFLAGS = $(CFLAGS) /D"__WXMSW__" /D"wxUSE_UNICODE" /I"$(MAKEDIR)" /I"$(WX)" 
LFLAGS = $(LFLAGS) /LIBPATH:"$(WX)" wxqp.lib
 
USEPCH = 0
!IF "$(USEPCH)" == "1"
PCH = $(OUT)\$(TARGET).pch
CFLAGS_PCH = $(CFLAGS) /Fp"$(PCH)" /Yc"StdAfx.h"
CFLAGS = $(CFLAGS) /Fp"$(PCH)" /Yu"StdAfx.h"
!ENDIF

all : "$(BIN)"

clean :
	rmdir /S /Q "$(OUT)"
	
debug :
	windbg.bat $(BIN)

run :
	$(BIN)

"$(OUT)" :
	if not exist "$(OUT)" mkdir "$(OUT)"
	if not exist "$(OUT)\gui" mkdir "$(OUT)\gui"
	
all : "$(BIN)"
	copy /B /V /Y $(BIN) $(ROOT) >nul
	copy /B /V /Y $(OUT)\$(TARGET).pdb $(ROOT) >nul
	echo NOTICE: '$(TARGET)' Build Finished.

.c{$(OUT)}.obj::
	$(CC) @<<
	$(CFLAGS) /Fo$(OUT)\ $< 
<<

.cpp{$(OUT)}.obj::
	$(CC) @<<
	$(CFLAGS) /Fo$(OUT)\ $<
<<

!INCLUDE "Depends.mk"

"$(BIN)" : "$(OUT)" $(OBJS) "$(OUT)\StdAfx.obj" "$(OUT)\Version.res"
	$(LINK) @<<
	$(LFLAGS) $(OBJS) "$(OUT)\StdAfx.obj" "$(OUT)\Version.res"
<<

"$(OUT)\StdAfx.obj" "$(PCH)" : ".\StdAfx.h" "$(OUT)"
!IF "$(USEPCH)" == "1"
	$(CC) @<<
	$(CFLAGS_PCH) /Fo$(OUT)\ ".\StdAfx.cpp"
<<
!ENDIF

"$(OUT)\Version.res" : ".\Version.rc" "$(OUT)"
	$(RC) $(RFLAGS) /Fo"$(OUT)\Version.res" ".\Version.rc"

[失落的凡凡]

顶

[wxgiter]

学习～～

[whg01]

接分

[全球全网精准引流软件SaaS平台]

接~接~接~

[mLee79]

nmake 功能太弱智。。。 用 GNU make 啊。。。。

[fox000002]

其实用 cmake 不错，不用管 Makefile 了

[mstlq]

nmake……
上一次用来做正经事，已经是3年前了……
期待楼主所谓“时机成熟”的一刻……

[mLee79]

重新写了下 Makefile， 现在可以自动生成依赖关系, 仍在：http://x4c.googlecode.com/svn/demo/xmk/Makefile 下.
你可以 svn co http://x4c.googlecode.com/svn/demo/xmk/ 然后:

make .dep
make all
touch test.h ; make all
make all-plat
touch test.h ; make all-plat

当然如果你没有 gcc ， 是没有办法 make .dep 的，这时候目标文件仅随对应的 .c 的修改重新编译。。
当然这是个不复杂的工作，自己写个简单的预处理，感觉还是容易的。。 LZ的 NMaker 应该就是干这件事。。

这样你完全不用修改 Makefile , 只要把源文件拷贝过来就直接可以 make 了。。。
当然你也可以改成支持 .cpp .l .y .res .idl 等等的版本。。。 同样，生成一个 .a 一个 .exe 也完全是个人习惯， 你可以改成只生成 .exe 的， 同样的改成生产 .so .dll 等的也不错。。。。
当然，改成把所有的临时文件放在一个指定的目录下更好，如果有功能强大点的shell，比如在 linux 下或者安装了 cygwin ，这个任务也很简单， WIN的shell功能太弱，可能搞起来就稍微麻烦点。。。。

[wshcdr]

MK

[老邓]

[Quote=引用 30 楼 mlee79 的回复:]
重新写了下 Makefile， 现在可以自动生成依赖关系[/Quote]
co代码，并且读了你写的Makefile，对GCC来说，非常理想！
另，对GCC，应该不用单独生成.dep的，《跟我学写Makefile》中的例子是直接得到依赖关系用于编译。
当然，你生成.dep后的编译速度要快一些，但操作起来步骤上也要繁琐一些。

我写NMaker的目的，就是为了实现类似GCC的功能。

我用make 3.81，mingw4.4.1测试你的代码，发现错误：

E:\xmk>make .dep
'[' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
rm -f .deplist
process_begin: CreateProcess(NULL, rm -f .deplist, ...) failed.
make (e=2): 系统找不到指定的文件。
make: *** [.deplist] Error 2

使用nmake也是有其自身优势的。
如果不考虑跨平台项目的话，nmake是VC自带的，不像make，还需要单独下载。
从性能上来说，我认为nmake要优于make。

[风消云散Fly]

学习了

[老邓]

想解决不同目录的源码生成的obj放在不同目录中，用nmake，只能每编译一个文件就调用一次编译器！
这会对编译速度产生影响！

mLee79，如何编写，才能使得make支持一次编译多个文件呢？

[老邓]

解决分目录编译obj了，详见1楼。

[太乙]

用automake不好么？？

[老邓]

[Quote=引用 36 楼 hqin6 的回复:]
用automake不好么？？
[/Quote]
这是nmake，automake只用于GNU Make

[老邓]

UP！寻找共同爱好者！！

[linwy728]

学习了，呵呵

[老邓]

玩了近二十天的Eclipse CDT，实在受不了了。
速度问题！太慢了，文件少还好，文件多了，机器配置跟不上，很慢。
完成没实现的函数，竟然用了40秒，我倒！
用回CodeBlocks了。

[老邓]

[Quote=引用 40 楼 loaden 的回复:]
玩了近二十天的Eclipse CDT，实在受不了了。
速度问题！太慢了，文件少还好，文件多了，机器配置跟不上，很慢。
完成没实现的函数，竟然用了40秒，我倒！
用回CodeBlocks了。
[/Quote]
继续使用Eclipse CDT，找到了CDT提速大法，越用越爽！
http://topic.csdn.net/u/20091005/00/8a522f58-280d-4a30-ae01-d226b1fc918e.html

另，NMaker发布了，可以在Eclipse CDT里自动化管理工程了。
http://www.qpsoft.com/blog/nmaker/