1. 全栈程序员必看首页

Windows平台下Makefile学习笔记（一）

全栈程序员-用户IM • • 未分类

Windows平台下Makefile学习笔记（一）作者：朱金灿来源：http://blog.csdn.net/clever101决心学习Makefile，一方面是为了解决编译开源代码时需要跨编译平台的问题（发现一些开源代码已经在使用VS2010开发，但我还没安装VS2010，我想在VS2008下编译这些代码）；另一方面源码在服务器端编译的话，使用IDE的方式编译还是不太方便。本文主要分为三部分：第一部分讲述nam

大家好，又见面了，我是你们的朋友全栈君。

作者：朱金灿

来源：http://blog.csdn.net/clever101

 

        决心学习Makefile，一方面是为了解决编译开源代码时需要跨编译平台的问题（发现一些开源代码已经在使用VS2010开发，但我还没安装VS2010，我想在VS2008下编译这些代码）；另一方面源码在服务器端编译的话，使用IDE的方式编译还是不太方便。

 

       本文主要分为三部分：第一部分讲述namke工具使用makefile的用法；第二部分讲述makefile的主要语法；第三部分讲述自己动手实践学习写makefile文件。第四部分是编写一个工具将vc工程文件转化为Makefile文件。

 

       首先要清楚的是在VS环境下使用Makefile的工具是nmake。因此我们需要弄明白nmake的使用Makefile文件常用命名行用法。nmake使用Makefile文件常用命名行用法是：

 

     

namke /f  makefile /x stderrfile  [macrodefs] [targets]

 

 

 

其中makefile为makefile文件，/x stderrfile为可选参数，即把namke错误存储到文件stderrfile。

 

 

      接着介绍makefile的主要语法。makefile的注释以#开头，如：

 

# this is my first makefile

 

 

 

 

 

Makefile的一个重要组成部分是宏。Makefile中的宏和C语言的中宏类似，其实质就是字符串替换。其语法很简单，如下：

 

macro name =  macro value

 

直译就是宏名 =  宏的值

 

      VS预定义了很多宏，如OUTDIR，你可以在你的Makefile重新定义这些宏以覆盖原来的值。

 

       宏可以使用环境变量，如你的系统有一个OPEN_SOURCE的环境变量，然后你可以这样定义宏：

     THIRD_PARTY  =  $(OPEN_SOURCE)

 

      宏的引用用法是 $(宏名)。

 

接着介绍Makefile的第二个重要组成部分预处理指令。Makefile的预处理指令和C语言的预处理指令类似，其常用指令如下：

!ERROR string      ——    显示错误“string”, 然后停止执行，错误代码为U1050

!MESSAGE string  ——   显示字符串，这个一般用于信息显示C语言的#pragma message

!INCLUDE [<]filename[>] —— 包含makefile。

!IF const ——  如果成立（非零），则处理!F和下一个!ELSE或!ENDIF之间的语句

还有诸如!IFDEF macroname、!IFNDEF macroname、!ELSE、!ELSEIF、!ELSEIFDEF、!ELSEIFNDEF、!ENDIF和C语言的#if之类的指令的意义是一致的，这里就不一一详述了。

 

   Makefile的第三个主要组成部分是描述块。描述块的结构如下：

目标：依赖项

     命令

  

这里略微解释下什么叫目标、依赖项和命令。所谓目标就是用户最终希望得到的结果，也就是nmake需要生成的结果。目标可以是一个文件、目录，也可以什么都不是。如果目标不存在或者目标的时间戳（文件的最后修改时间）比依赖项早，或者目标类型不是文件，nmake将运行描述块中的“命令”。

 

依赖项是指在生成目标所需要使用到的对象。一个目标可以有一个或多个依赖项，也可以没有依赖项。多个依赖项以空格分隔。如果指定的依赖项不存在，则在其他描述块的目标中寻找，但首先需要生成这个目标。

 

命令是nmake在生成目标时所调用的命令。与用户自己在命令行中执行效果是一样的。

 

在使用namke进行程序构建时，nmake采用了时间戳判断机制。在生成一个目标时，会判断目标文件是否存在或目标的最后修改时间是否晚于所有依赖项的最后修改时间。如果所有依赖项的最后修改时间都比目标的最后修改时间晚，则说明当前的目标文件是使用现有的依赖项生成，是最新的，没有必要再进行生成。

   介绍到这里，可能你对Mdakefile的语法细节有了大致的了解，但估计你对Makefile的常用文件结构还不了解。如果缺少对这一层的理解，你还是对如何编写Makefile文件一头雾水。下面介绍一下常用的Makefile文件结构。Makefile文件结构可以是如下的结构：

# 宏定义

……

 

# 描述块

 

        学了这么多，我们来实践一下。首先我们来一个简单的控制台工程——ConsoleTest。一切根据工程向导采用默认设置即可。然后在main函数中添加几句简单代码（这个用于判断我们生成的程序是否成功），具体如下：

 

int _tmain(int argc, _TCHAR* argv[])
{
    printf("Hello World! \n");
	getchar();
	return 0;
}

 

 

 

 

 

 

       然后我们在ConsoleTest文件夹下新建一个makefile.vc。我们开始正式编写一个makefile文件了。这时我们的大脑可能会一片空白，虽然你学了很多makefile语法，但迈出第一步依然是困难，这是正常的反应。好吧，让我们一步步来吧。首先要告诉你makefile的一个基本原则：以终为始，这个似乎和我们平时进行的过程式编程的原则相悖。所谓以终为始，就是你通过makefile文件首先告诉编译器这个工程是想生成一个exe还是一个dll还是一个静态库。然后告诉编译器要生成这个exe之类需要生成哪些obj文件。在这个例子中，我们要生成一个exe，所以我们在makefile文件的第一行就是：

 

 

all:ConsoleTest.exe

 

 

 

 

 

 

 

接下来就是编译器的一般生成过程：编译加链接命令，具体是：

 

# compile
stdafx.obj: stdafx.cpp
    cl -c -D_X86=1 -DWIN32 -D_DEBUG -D_CONSOLE -Istdafx.h stdafx.cpp
   
ConsoleTest.obj: ConsoleTest.cpp stdafx.obj
    cl -c -D_X86=1 -DWIN32 -D_DEBUG -D_CONSOLE -Istdafx.h ConsoleTest.cpp

# link
ConsoleTest.exe: ConsoleTest.obj
link /INCREMENTAL:YES /NOLOGO /subsystem:console /out:ConsoleTest.exe ConsoleTest.obj kernel32.lib

 

 

 

 

 

其中cl语句是VC编译器的编译器的命令行编译，link语句是VC链接器的命令行用法，这里只简单叙述cl和link的用法。

cl的一些常用选项：

-c: 编译但不链接

-D: 定义预处理器，如-D_X86=1：指定在x86平台上编译，-D_DEBUG：定义预处理器_DEBUG，

-I：包含的头文件

cl的最后一个参数是所编译的文件。

 

link的一些常用选项：

/INCREMENTAL:是否启用增量链接，YES为启用，NO为不启用，

/NOLOGO： 取消显示启动版权标志

/SUBSYSTEM：指定子系统，在PC桌面程序上一般是两个选项：console(控制台程序)和WINDOWS(非控制台程序)。

/out: 指定输出的文件。

link最后的参数是需要链接的obj文件和库文件。

 

cl和link的详细用法请参考MSDN和参考文献2《VC命令行编译C++》。

 

我们看到生成的obj文件和ConsoleTest.exe是放到当前的源码文件夹下。一般我们想把它放到debug文件夹下。那么我们该怎么做呢？这时就可以用到makefile中的一个常用部分——宏。我们可以这样定义一个宏，然后创建debug文件夹，具体代码是：

OUTDIR = .\Debug

 

#这里增加了一个输出：$(OUTDIR)

 

all: $(OUTDIR) $(OUTDIR)\ConsoleTest.exe

 

 

 

 

 

 

#假如不存在$(OUTDIR)文件夹，就创建它

 

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

 

 

 

 

 

 

相应地，生成的obj文件和exe文件都需要加上输出文件的路径，具体如下：

 

# compile
$(OUTDIR)\stdafx.obj: stdafx.cpp
    cl -c -D_X86=1 -DWIN32 -D_DEBUG -D_CONSOLE -Istdafx.h /Fo"$(OUTDIR)\\" /Fd"$(OUTDIR)\\" stdafx.cpp 
   
$(OUTDIR)/ConsoleTest.obj: ConsoleTest.cpp $(OUTDIR)\stdafx.obj
    cl -c -D_X86=1 -DWIN32 -D_DEBUG -D_CONSOLE -Istdafx.h /Fo"$(OUTDIR)\\" /Fd"$(OUTDIR)\\" ConsoleTest.cpp

# link
$(OUTDIR)\ConsoleTest.exe: $(OUTDIR)\ConsoleTest.obj
    link /INCREMENTAL:YES /NOLOGO /subsystem:console /out:$(OUTDIR)\ConsoleTest.exe $(OUTDIR)\ConsoleTest.obj kernel32.lib

 

 

 

 

 

这里cl工具增加了两个选项

/Fo：指定obj文件的放置路径

/Fd：指定pdb文件的放置路径

 

这里需要值得注意的，Windows平台下文件反斜杠应该采用\，而不是跨平台的/，因为我曾把OUTDIR = .\Debug写成OUTDIR = ./Debug,结果造成if not exist不识别$(OUTDIR)而造成语法错误。/在windows平台下的makefile中大多地方可以识别，但在一些地方不能识别(例如if not exist语句)，而\在任何地方都能识别的。

 

还有就是命令语句必须至少空出一格，而不能顶格写。如果if not exist”$(OUTDIR)” mkdir $(OUTDIR)顶格，就会出现错误：

makefile.vc(5) : fatal error U1034: 语法错误 : 缺少分隔符

Stop.

 

    除开命令语句，其它语句都应该顶格写。

 

我们继续完善这个makefile。我们想增加一个清理输出文件的指令，就是常用的clean指令。我们可以在描述块all后面加一个描述块：clean，clean描述块的代码如下：

 

clean:
       if exist $(OUTDIR) del $(OUTDIR)\*.ilk
       if exist $(OUTDIR) del $(OUTDIR)\*.obj
    if exist $(OUTDIR) del $(OUTDIR)\*.exe

 

 

 

 

 

        如果makefile文件中不存在clean这个描述块，而你运行下面的命令：

nmake /f makefile.vc clean

会出现下面的错误提示：

NMAKE : fatal error U1052: 未找到文件“clean”

Stop.

 

       我们继续完善这个makefile。因为现在只能编译debug版本，我们想用户能指定编译debug版本或release版本，用户只需要输入“debug”或“release”来指定。我们想到可以设定一个宏标记来指定，当用户输入正确时就编译相应的版本，错误时就提示使用方法。同时我们想到前面提到nmake工具的命令行用法是：

 

namke /f  makefile /x stderrfile  [macrodefs] [targets]

 

 

 

 

 

其中macrodefs就是允许我们定义一些自定义宏来控制编译输出的。这次我们可以定义两个宏debug和release。具体不再详述，下面列出代码：

 

#设置编译标记，初始化为FALSE
CFGSET     =  FALSE

#定义debug版本的预处理器
CCDEBUG    = -DWIN32 -D_DEBUG -D_CONSOLE

#定义release版本的预处理器
CCNODBG    = -DWIN32 -D_NDEBUG -D_CONSOLE

!IFDEF debug
CC         = $(CCDEBUG)
OUTDIR = .\Debug
CFGSET     =  TRUE
!ELSE IFDEF release
CC         = $(CCNODBG)
OUTDIR = .\Release
CFGSET     =  TRUE
!ENDIF

# 提示用法
#
!IF "$(CFGSET)"== "FALSE"
!MESSAGE Usage: nmake /f Makefile.vc [<config>] [<target>]      
!MESSAGE
!MESSAGE where <config> is one of:
!MESSAGE -  release=1               - build release version
!MESSAGE -  debug=1                 - build debug version
!MESSAGE
!MESSAGE <target> may be:
!MESSAGE -  clean                 - clear output file
!MESSAGE
!MESSAGE
!ERROR please choose a valid configuration instead"
!ENDIF


#这里增加了一个输出：$(OUTDIR)
all: $(OUTDIR) $(OUTDIR)\ConsoleTest.exe

#假如不存在$(OUTDIR)文件夹，就创建它
$(OUTDIR) :
 if not exist "$(OUTDIR)" mkdir $(OUTDIR)
 
clean:
       if exist $(OUTDIR) del $(OUTDIR)\*.ilk
       if exist $(OUTDIR) del $(OUTDIR)\*.obj
       if exist $(OUTDIR) del $(OUTDIR)\*.exe     
   
# compile
$(OUTDIR)\stdafx.obj: stdafx.cpp
    cl -c  $(CC) -Istdafx.h /Fo"$(OUTDIR)\\" /Fd"$(OUTDIR)\\" stdafx.cpp 
   
$(OUTDIR)\ConsoleTest.obj: ConsoleTest.cpp $(OUTDIR)\stdafx.obj
    cl -c  $(CC) -Istdafx.h /Fo"$(OUTDIR)\\" /Fd"$(OUTDIR)\\" ConsoleTest.cpp

# link
$(OUTDIR)\ConsoleTest.exe: $(OUTDIR)\ConsoleTest.obj
    link /machine:x86 /INCREMENTAL:YES /NOLOGO /subsystem:console /out:$(OUTDIR)\ConsoleTest.exe $(OUTDIR)\ConsoleTest.obj kernel32.lib

 

 

 

 

 

 

该makefile的用法是：

 

#编译debug版本
nmake /f makefile.vc debug=1
#编译release版本
nmake /f makefile.vc release=1
#清除debug版本
nmake /f makefile.vc debug=1 clean
#清除release版本
nmake /f makefile.vc release=1 clean

 

另外前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。点击跳转到教程。

 

 

 

参考文献：

 

1. MSDN 2008,Microsoft Corporation

2. VC命令行编译C++

3. 精通Windows API,范文庆、周彬彬、安靖编著

      如果你觉得我的博客对你有帮助，请在下面网址中博客之星评选活动投我一票：

http://vote.blog.csdn.net/item/blogstar/clever101（单击候选人介绍下面的投他一票那个按钮）

参与投票有机会获奖：

     最佳贡献奖：通过微博分享活动就有机会获得30元充值卡一张（每周抽选5名）
    幸运奖：凡参与投票用户就有机会获得精美小礼品一份。（每周抽选5名）
    积极参与奖：所有参与投票并符合条件的用户均可获得20个下载积分。

 

 

 

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。

发布者：全栈程序员-用户IM，转载请注明出处：https://javaforall.cn/139475.html原文链接：https://javaforall.cn

【正版授权，激活自己账号】： Jetbrains全家桶Ide使用，1年售后保障，每天仅需1毛

【官方授权 正版激活】： 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

赞 (0)
全栈程序员-用户IM全栈程序员-用户IM
0 0


相关推荐

  • 【PLSQL】package包的使用

    【PLSQL】package包的使用

    【PLSQL】package包的使用

    全栈程序员-用户IM 全栈程序员-用户IM
    2021年12月16日
  • esxi安装ghost win7_【教程】硬盘下Ghost 系统安装教程

    esxi安装ghost win7_【教程】硬盘下Ghost 系统安装教程

    esxi安装ghost win7_【教程】硬盘下Ghost 系统安装教程使用本方法可在没有光驱、光盘、启动U盘等任何系统安装设备的情况下安装Ghost版XP、Win7、Win8/8.1、Win1032位或64位系统！(原版系统不适用)操作步骤：注意：本安装方法适用于你的电脑能正常启动至桌面，或能启动系统的安全模式，也就是说不管原电脑的系统有任何问题，只要能进桌面，就能重装系统！(EFI+GPT除外)(1)请提前下载GHOST备份还原工具(下称硬盘安装器)与系统GHO…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年6月25日
  • 电子基本元件介绍-电容「建议收藏」

    电子基本元件介绍-电容「建议收藏」

    完成电阻的介绍后，接下来对电容进行介绍。0定义电容器（Capacitor，电路中常用C来表示）。两个相互靠近的导体，中间夹一层不导电的绝缘介质，这就构成了电容器。当电容器的两个极板之间加上电压时，电容器就会储存电荷。电容器的电容量在数值上等于一个导电极板上的电荷量与两个极板之间的电压之比。电容器的电容量的基本单位是法拉(F)。电容器往往用于调谐、旁路、耦合、滤波等电路中起着重要的作用。晶体管收音机的调谐电路要用到它，彩色电视机…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年4月12日
  • QT学习—使用多线程的两种方法（子类化QThread+子类化QObject）

    QT学习—使用多线程的两种方法（子类化QThread+子类化QObject）

    QT学习—使用多线程的两种方法（子类化QThread+子类化QObject）第一种方法：摘要Qt多线程方法1继承QThread1写一个继承于QThread的线程2QThread的几个函数quitexitterminate函数3正确的终止一个线程4如何正确启动一个线程41正确的启动一个全局线程和UI一直存在的线程42如何启动一个局部线程用完即释放的线程继承QThread的一些总结使用QObject实现多线的方法见：http://blog.csdn.net/czyt…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年5月8日
  • 虚拟服务器 emule,emule服务器

    虚拟服务器 emule,emule服务器

    虚拟服务器 emule,emule服务器emule服务器内容精选换一换生产站点服务器为SUSE操作系统，对该云服务器创建容灾演练后，发现容灾演练云服务器的网卡名称与生产站点服务器的网卡名称不一致。示例：操作系统为NovellSUSELinuxEnterpriseServer12SP364bit的生产站点服务器，挂载有5张网卡。登录生产站点服务器，查询网卡名称为eth0~eth4，如图1所示。创远程桌面协议(Remote…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年6月15日
  • <span>关于事务的隔离级别和处理机制的理解</span>

    关于事务的隔离级别和处理机制的理解

    关于事务的隔离级别和处理机制的理解

    全栈程序员-用户IM 全栈程序员-用户IM
    2021年11月25日

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号