跟我一起写Makefile.pdf

第一部分、概述............................................................................................................................... 6 第二部分、关于程序的编译和链接...............................................................................................6 第三部分、Makefile 介绍............................................................................................................7 一、Makefile的规则..............................................................................................................7 二、一个示例...........................................................................................................................8 三、make是如何工作的........................................................................................................9 四、makefile中使用变量....................................................................................................10 五、让make自动推导.......................................................................................................... 11 六、另类风格的makefile....................................................................................................12 七、清空目标文件的规则.....................................................................................................13 第四部分、Makefile 总述..........................................................................................................13 一、Makefile里有什么？....................................................................................................13 1、显式规则。..............................................................................................................14 2、隐晦规则。..............................................................................................................14 3、变量的定义。..........................................................................................................14 4、文件指示。..............................................................................................................14 5、注释。......................................................................................................................14 二、Makefile的文件名........................................................................................................15 三、引用其它的Makefile....................................................................................................15 四、环境变量 MAKEFILES................................................................................................16 五、make的工作方式..........................................................................................................16 第五部分、书写规则.....................................................................................................................17 一、规则举例.........................................................................................................................17 二、规则的语法.....................................................................................................................17 三、在规则中使用通配符.....................................................................................................18 四、文件搜寻.........................................................................................................................19 五、伪目标.............................................................................................................................20 六、多目标.............................................................................................................................22 七、静态模式.........................................................................................................................22 八、自动生成依赖性.............................................................................................................24 第六部分 书写命令 .......................................................................................................................25 一、显示命令.........................................................................................................................26 二、命令执行.........................................................................................................................26 三、命令出错.........................................................................................................................27 四、嵌套执行make..............................................................................................................28 五、定义命令包.....................................................................................................................30 第七部分 使用变量 .......................................................................................................................30 一、变量的基础.....................................................................................................................31 二、变量中的变量.................................................................................................................32 三、变量高级用法.................................................................................................................34 四、追加变量值.....................................................................................................................37 五、override 指示符..........................................................................................................37 六、多行变量.........................................................................................................................38 七、环境变量.........................................................................................................................38 八、目标变量.........................................................................................................................39 九、模式变量.........................................................................................................................40 第八部分 使用条件判断 ...............................................................................................................40 一、示例............................................................................................................................... ..40 二、语法............................................................................................................................... ..42 第九部分 使用函数 .......................................................................................................................43 一、函数的调用语法.............................................................................................................44 二、字符串处理函数.............................................................................................................44 1、subst .......................................................................................................................44 2、patsubst.................................................................................................................45 3、strip.........................................................................................................................45 4、findstring ...............................................................................................................46 5、filter .........................................................................................................................46 6、filter-out .................................................................................................................46 7、sort ..........................................................................................................................47 8、word........................................................................................................................47 9、wordlist ..................................................................................................................47 10、words ....................................................................................................................47 11、firstword ..............................................................................................................48 12、字符串函数实例....................................................................................................48 三、文件名操作函数.............................................................................................................48 1、dir.............................................................................................................................48 2、notdir ......................................................................................................................48 3、suffix .......................................................................................................................49 4、basename..............................................................................................................49 5、addsuffix ................................................................................................................49 6、addprefix ...............................................................................................................49 7、join ...........................................................................................................................50 四、foreach 函数................................................................................................................50 五、if 函数............................................................................................................................50 六、call 函数..........................................................................................................................51 七、origin 函数.....................................................................................................................51 “undefined” .................................................................................................................52 “default” .......................................................................................................................52 “file” ............................................................................................................................... 52 “command line” .........................................................................................................52 “override”....................................................................................................................52 “automatic” .................................................................................................................52 八、shell函数.......................................................................................................................53 九、控制make的函数..........................................................................................................53 1、error ........................................................................................................................53 2、warning ..................................................................................................................54 第十部分 make 的运行..............................................................................................................54 一、make的退出码..............................................................................................................54 二、指定Makefile................................................................................................................54 三、指定目标.........................................................................................................................55 “all”............................................................................................................................... .56 “clean” ..........................................................................................................................56 “install” .........................................................................................................................56 “print” ...........................................................................................................................56 “tar” ............................................................................................................................... 56 “dist” ..............................................................................................................................56 “TAGS” ..........................................................................................................................56 “check” 和“test” ..........................................................................................................56 四、检查规则.........................................................................................................................57 五、make的参数..................................................................................................................57 第十一部分 隐含规则...................................................................................................................61 一、使用隐含规则.................................................................................................................61 二、隐含规则一览.................................................................................................................62 1、编译C程序的隐含规则...........................................................................................63 2、编译C++程序的隐含规则.....................................................................................63 3、编译Pascal程序的隐含规则..................................................................................63 4、编译Fortran/Ratfor程序的隐含规则..................................................................63 5、预处理Fortran/Ratfor程序的隐含规则..............................................................63 6、编译Modula-2 程序的隐含规则...........................................................................63 7、汇编和汇编预处理的隐含规则..............................................................................64 8、链接Object文件的隐含规则.................................................................................64 9、Yacc C程序时的隐含规则.....................................................................................64 10、Lex C 程序时的隐含规则.....................................................................................64 11、Lex Ratfor程序时的隐含规则 ...........................................................................65 12、从C程序、Yacc文件或Lex 文件创建Lint 库的隐含规则..................................65 三、隐含规则使用的变量.....................................................................................................65 1、关于命令的变量。..................................................................................................65 2、关于命令参数的变量..............................................................................................66 四、隐含规则链.....................................................................................................................67 五、定义模式规则.................................................................................................................68 1、模式规则介绍..........................................................................................................68 2、模式规则示例..........................................................................................................69 3、自动化变量..............................................................................................................70 4、模式的匹配..............................................................................................................72 5、重载内建隐含规则..................................................................................................72 六、老式风格的"后缀规则" .................................................................................................73 七、隐含规则搜索算法.........................................................................................................74 第十二部分 使用make更新函数库文件....................................................................................75 一、函数库文件的成员.........................................................................................................75 二、函数库成员的隐含规则.................................................................................................75 三、函数库文件的后缀规则.................................................................................................76 四、注意事项.........................................................................................................................76 第十三部分 后序...........................................................................................................................77 ### Makefile核心概念与实践 #### 第一部分：概述 **Makefile**是一种自动化构建工具，主要用于软件项目的构建过程，能够管理源代码文件的依赖关系，并根据这些依赖关系自动执行编译、链接等任务。 #### 第二部分：关于程序的编译和链接 - **编译**：将源代码转换为机器可理解的指令。 - **链接**：将编译后的对象文件连接起来形成可执行文件。 #### 第三部分：Makefile介绍 1. **Makefile的规则**： - **显式规则**：明确指定了依赖关系。 - **隐式规则**：由Makefile内置的规则完成，无需明确指定。 2. **一个示例**： - 示例通常用于展示如何编写有效的Makefile文件，包括如何设置依赖项和执行特定任务。 3. **make是如何工作的**： - `make`工具读取Makefile文件，解析规则并根据这些规则执行相应的操作。 4. **makefile中使用变量**： - 变量用于简化Makefile文件，通过设定通用路径、编译选项等提高可维护性。 5. **让make自动推导**： - 自动推导指的是Makefile能够自动确定文件之间的依赖关系，从而执行必要的操作。 6. **另类风格的makefile**： - 不同的项目可能采用不同的Makefile编写风格，例如使用递归调用make工具。 7. **清空目标文件的规则**： - 清除（如删除）构建过程中产生的中间文件和可执行文件。 #### 第四部分：Makefile总述 1. **Makefile里有什么？** - **显式规则**：明确指明目标文件及其依赖项。 - **隐式规则**：系统内置的规则，可以自动检测依赖关系。 - **变量的定义**：用于存储路径、文件名等信息。 - **文件指示**：引入其他Makefile文件。 - **注释**：使用`#`进行注释。 2. **Makefile的文件名**： - 默认情况下，`make`会查找名为`Makefile`或`makefile`的文件。 3. **引用其他的Makefile**： - 通过`include`语句来包含其他Makefile文件。 4. **环境变量MAKEFILES**： - 用于指定额外的Makefile文件位置。 5. **make的工作方式**： - `make`读取Makefile文件，解析其中的规则，然后按照规则执行任务。 #### 第五部分：书写规则 1. **规则举例**： - 展示如何定义目标文件和依赖文件。 2. **规则的语法**： - 规则的基本格式是目标、冒号和依赖项列表，后跟tab和命令。 3. **在规则中使用通配符**： - 通配符如`*`可以用来匹配文件名中的任意字符。 4. **文件搜寻**： - 用于查找文件的目录路径。 5. **伪目标**： - 特殊的目标，不对应于实际文件，如`clean`或`install`。 6. **多目标**： - 一个规则可以有多个目标。 7. **静态模式**： - 使用特定模式来匹配目标文件和依赖文件。 8. **自动生成依赖性**： - `make`能够自动检测文件的修改时间来决定是否重新编译。 #### 第六部分：书写命令 1. **显示命令**： - 显示执行的命令。 2. **命令执行**： - 如何执行命令，包括环境变量和命令的传递。 3. **命令出错**： - 处理命令执行失败的情况。 4. **嵌套执行make**： - 在一个Makefile中调用另一个Makefile。 5. **定义命令包**： - 将一系列命令封装在一起。 #### 第七部分：使用变量 1. **变量的基础**： - 定义和使用基本变量的方法。 2. **变量中的变量**： - 在变量中嵌套使用其他变量。 3. **变量高级用法**： - 包括条件变量、函数变量等。 4. **追加变量值**： - 在原有变量基础上添加新的值。 5. **override指示符**： - 覆盖已定义的变量。 6. **多行变量**： - 创建跨越多行的变量。 7. **环境变量**： - 使用外部环境变量。 8. **目标变量**： - 特定于目标的变量。 9. **模式变量**： - 与模式匹配相关的变量。 #### 第八部分：使用条件判断 1. **示例**： - 使用条件判断的例子。 2. **语法**： - 条件判断的具体语法结构。 #### 第九部分：使用函数 1. **函数的调用语法**： - 如何调用函数。 2. **字符串处理函数**： - 包括替换、过滤等函数。 3. **文件名操作函数**： - 对文件名进行操作的函数。 4. **foreach函数**： - 遍历列表中的元素。 5. **if函数**： - 基于条件选择执行分支。 6. **call函数**： - 调用其他函数。 7. **origin函数**： - 查询变量来源。 8. **shell函数**： - 执行shell命令。 9. **控制make的函数**： - 如`error`和`warning`等函数。 #### 第十部分：make的运行 1. **make的退出码**： - 退出状态码表示make执行的结果。 2. **指定Makefile**： - 显式指定Makefile文件。 3. **指定目标**： - 指定make执行的目标任务。 4. **检查规则**： - 检查依赖规则的有效性。 5. **make的参数**： - 传递给make命令的参数。 #### 第十一部分：隐含规则 1. **使用隐含规则**： - Makefile内置的一系列规则，用于自动处理常见任务。 2. **隐含规则一览**： - 列出了不同编程语言的隐含规则。 3. **隐含规则使用的变量**： - 用于配置编译器、链接器等工具的选项。 4. **隐含规则链**： - 规则之间的相互调用。 5. **定义模式规则**： - 更灵活地定义依赖关系。 6. **老式风格的"后缀规则"**： - 一种特殊的规则类型。 7. **隐含规则搜索算法**： - Makefile如何找到正确的规则。 #### 第十二部分：使用make更新函数库文件 1. **函数库文件的成员**： - 函数库文件中的各个组成部分。 2. **函数库成员的隐含规则**： - 如何更新库文件中的成员。 3. **函数库文件的后缀规则**： - 使用后缀规则更新库文件。 4. **注意事项**： - 更新库文件时需要注意的问题。 #### 第十三部分：后序 - 本部分总结了前面提到的所有内容，并提供了一些实用的建议和技巧，帮助读者更好地理解和应用Makefile。