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


相关推荐

  • 【企业】掌握理查德·费曼学习法，提高学习效率

    【企业】掌握理查德·费曼学习法，提高学习效率

    【企业】掌握理查德·费曼学习法，提高学习效率强大的学习能力，可以让你更好地应对复杂多变的世界！1、理查德·费曼理查德·菲利普斯·费曼（RichardPhillipsFeynman），美国犹太裔理论物理学家，量子电动力学创始人之一，纳米技术之父。1965年获得诺贝尔物理学奖，从没有人怀疑过他超强、早熟的学习能力：小学刚毕业，他就开始学习初等微积分，在中学，他就学习了狭义相对论——要知道爱因斯坦提出狭义相对论的《论动体的电动力…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年5月21日
  • 光猫桥接后如何连接光猫页面「建议收藏」

    光猫桥接后如何连接光猫页面「建议收藏」

    光猫桥接后如何连接光猫页面「建议收藏」1.连接光猫wifi，192.168.1.1进2.网线直连或在局域网内路由器WAN口设置成自动获取IP地址

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年10月8日
  • ”周期天王”20大预言，针针见血，看完整个人通透多了

    ”周期天王”20大预言，针针见血，看完整个人通透多了

    ”周期天王”20大预言，针针见血，看完整个人通透多了周期天王”20大预言，针针见血，看完整个人通透多了东方财富网、投行大师兄 2017-05-0914:07近期，股市个股乏力、债市毫无起色、商品跌跌不休。一行三会大力推进金融去杠杆，再叠加地产调控持续加码与信贷收缩，市场风险偏好显著下降，股、债、商“三杀”频现。无论是美联储3月暂缓加息的佳音，还是法国大选暂无黑天鹅的捷报，都无法振奋我们的市场丝毫。外盘一

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年11月1日
  • Maven安装教程_vmware安装教程

    Maven安装教程_vmware安装教程

    Maven安装教程_vmware安装教程一、安装apache官网下载需要的版本，然后解压缩，解压路径尽量不要有空格和中文Maven–DownloadApacheMavenhttps://maven.apache.org/download.cgi二、配置环境变量新建系统变量变量名：MAVEN_HOME值：你解压的路径eg：D:\xxx\apache-maven-3.8.4编辑系统变量Path打开->新建->路径为：解压缩文件的路径到bin目录eg:D:\xxx\apac

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年8月22日
  • 零基础学Java（3）运算符

    零基础学Java（3）运算符

    零基础学Java（3）运算符运算符运算符用于连接值。Java提供了一组丰富的算术和逻辑运算符以及数学函数。算术运算符在Java中，使用算术运算符+、-、*、/表示加、减、乘、除运算。当参与/运算的两个操作数都是整数时，表示

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年7月29日
  • pycharm2021 激活码_在线激活 idea

    pycharm2021 激活码_在线激活

    (pycharm2021 激活码)本文适用于JetBrains家族所有ide，包括IntelliJidea，phpstorm，webstorm，pycharm，datagrip等。IntelliJ2021最新激活注册码，破解教程可免费永久激活，亲测有效，下面是详细链接哦~https://javaforall.cn/100143.html…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年3月20日

发表回复

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

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