Eclipse CDT Hello World工程makefile分析

1. 工程文件分析

使用eclipse新建一个Hello World工程，假设工程名称是hello，此时eclipse在工程目录下新建了一个名为hello的文件夹：

hello/

    .cproject

    .project

    src/

        hello.c

先build该工程，然后Clean该工程，清除生成的目标码，这时hello文件夹下只多了eclipse为工程生成的makefile文件，其文件结构为：

hello/

    .cproject

    .project

    Debug/

        src/

            subdir.mk

        makefile

        objects.mk

        sources.mk

    src/

        hello.c

2. sources.mk文件

该文件中定义了makefile文件中使用的各种变量，最主要的就是SUBDIRS变量，它指示了工程中所有包含源文件的子目录，其内容如下：

[html] view
plaincopy

################################################################################   

# Automatically-generated file. Do not edit!   

################################################################################   

  

O_SRCS :=   

C_SRCS :=   

S_UPPER_SRCS :=   

OBJ_SRCS :=   

ASM_SRCS :=   

OBJS :=   

C_DEPS :=   

EXECUTABLES :=   

  

# Every subdirectory with source files must be described here   

SUBDIRS := \   

src \  

3 objects.mk文件

[html] view
plaincopy

################################################################################   

# Automatically-generated file. Do not edit!   

################################################################################   

  

USER_OBJS :=   

  

LIBS :=   

4 src/subdir.mk文件

该文件针对src目录下的所有.c文件修改C_SRCS、OBJS和C_DEPS变量，并定义文件夹下所有.c文件的编译规则。如这里的src/%.o: ../src/%.c，就是针对src文件夹里的每个.c文件，在makefile所在文件夹（即Debug）里生成src文件夹及同名的.o文件。

Eclipse cdt会在所有包含源文件的文件夹下都生成这么一个subdir.mk文件，所有Debug下存放.o的文件夹结构与存放.c文件的完全相同。

[html] view
plaincopy

################################################################################   

# Automatically-generated file. Do not edit!   

################################################################################   

  

# Add inputs and outputs from these tool invocations to the build variables   

C_SRCS += \   

../src/hello.c   

  

OBJS += \   

./src/hello.o   

  

C_DEPS += \   

./src/hello.d   

  

  

# Each subdirectory must supply rules for building sources it contributes   

src/%.o: ../src/%.c   

    @echo 'Building file: $<'   

    @echo 'Invoking: GCC C Compiler'   

    gcc -O0 -g3 -Wall -c -fmessage-length=0 -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@:%.o=%.d)" -o "$@" "$<"   

    @echo 'Finished building: $<'   

    @echo ' '  

5 makefile文件

makefile文件include包含了上面介绍的几个文件，下面是makefile文件的内容：

[html] view
plaincopy

################################################################################   

# Automatically-generated file. Do not edit!   

################################################################################   

  

-include ../makefile.init   

  

RM := rm -rf   

  

# All of the sources participating in the build are defined here   

-include sources.mk   

-include src/subdir.mk   

-include subdir.mk   

-include objects.mk   

  

ifneq ($(MAKECMDGOALS),clean)   

ifneq ($(strip $(C_DEPS)),)   

-include $(C_DEPS)   

endif   

endif   

  

-include ../makefile.defs   

  

# Add inputs and outputs from these tool invocations to the build variables   

  

# All Target   

all: hello   

  

# Tool invocations   

hello: $(OBJS) $(USER_OBJS)   

    @echo 'Building target: $@'   

    @echo 'Invoking: GCC C Linker'   

    gcc  -o "hello" $(OBJS) $(USER_OBJS) $(LIBS)   

    @echo 'Finished building target: $@'   

    @echo ' '   

  

# Other Targets   

clean:   

    -$(RM) $(OBJS)$(C_DEPS)$(EXECUTABLES) hello   

    -@echo ' '   

  

.PHONY: all clean dependents   

.SECONDARY:   

  

-include ../makefile.targets  

这里有必要说明以下MAKECMDGOALS 变量，make 在执行时设置的一个特殊变量，该变量记录了命令行参数指定的目标列表，没有通过参数指定终极目标时此变量为空。该变量仅限于用在特殊场合(比如判断)，在 Makefile 中最好不要对它进行重新定义。

而strip 函数可以用来去掉字符串中的空格(包括 [TAB] 等不可显示字符)，这些空格的位置可以位于字符串中字符单词的前面，中间以及后面。去掉的结果是用一个空格代替多个原来的多个空格。

所以这个makefile中make目标不为clean，并且C_DEPS包含有效字符时才会-include $(C_DEPS)

在这个工程中，C_DEPS为./src/hello.d，所以make all时要包含该文件，可src下并没有改文件呀？执行make后，发现在src下多了hello.d文件，内容是：

[html] view
plaincopy

src/hello.d src/hello.o: ../src/hello.c   

它是怎么来的呢？内容为何是这样呢？这就需要搞明白src文件夹里subdir.mk中的这条命令了：

[html] view
plaincopy

gcc -O0 -g3 -Wall -c -fmessage-length=0 -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@:%.o=%.d)" -o "$@" "$<"  

-fmessage-length=0：默认情况下，GNU工具链编译过程中，控制台输出的一行信息是不换行的，这样，当输出信息过长时(如编译错误时的信息)，会导致你无法看到完整的输出信息，加入-fmessage-length=0后，输出信息会根据控制台的宽度自动换行，这样就能看全输出信息了。 

-MF FILE：与-M或-MM一起使用，指定依赖关系写到什么文件中，如果没有-MF选项，则默认写到预处理输出中。当与-MD或-MMD一起使用时，-MF指定的文件会覆盖默认依赖输出文件。

-M：输出源文件的依赖关系，其中隐含了-E和-w选项。

-MM：与-M类似，但忽略系统头文件。

-MD：除了未隐含-E选项外，等价于-M -MF file。

-MMD：与-MD类似，但忽略系统头文件。

-MP：为依赖的头文件添加伪目标，目的是当删除头文件后如果makefile没有更新，则提示错误。典型的输出如：

        test.o: test.c test.h 

        test.h:

-MT：改变依赖规则目标，在这个Hello工程makefile中，如果去掉-MT"$(@:%.o=%.d)"，那么输出的hello.d文件内容是：

[html] view
plaincopy

src/hello.d src/hello.o: ../src/hello.c   

根据以上分析，我们知道第一次执行make all时并不会包含hello.d文件，因为那时它还不存在，hello.d也正是这次执行才生成的；以后再次执行make all时，会将hello.d内容包括到makefile中，make会根据依赖关系有选择性的进行编译和链接操作。

6  make all

在命令行下面进入Debug目录，执行make all命令，将会看到下面输出：

[html] view
plaincopy

Building file: ../src/hello.c  

Invoking: GCC C Compiler  

gcc -O0 -g3 -Wall -c -fmessage-length=0 -MMD -MP -MF"src/hello.d" -MT"src/hello.d" -o "src/hello.o" "../src/hello.c"  

Finished building: ../src/hello.c  

   

Building target: hello  

Invoking: GCC C Linker  

gcc  -o "hello"  ./src/hello.o     

Finished building target: hello  

其中上面一段是对源文件的编译，规则在src/subdir.mk中定义；后面一段声明目标文件，规则直接在makefile文件中定义。

7  其他
除了上面分析的内容，makefile文件还有下面几项:

-include ../makefile.init

-include ../makefile.defs

.PHONY: dependents

-include ../makefile.targets

版权声明：本文为博主原创文章，未经博主允许不得转载。