美文网首页
makefile教程

makefile教程

作者: alonwang | 来源:发表于2021-10-15 21:06 被阅读0次

    基于Make 命令教程 - 阮一峰的网络日志 (ruanyifeng.com)总结,可以将make看作一个自顶向下的构建工具

    一个makefile例子

    # 文件名就是makefile,没有后缀
    # 如果存在b.txt和c.txt,就把两者内容输出到a.txt
    a.txt: b.txt c.txt
        cat b.txt c.txt > a.txt
    

    在makefile相同目录下执行make可查看效果

    makefile文件名默认Makefilemakefile.也可以指定文件: make -f rules.txt或者make --file=rules.txt

    makefile语法定义

    <target> : <prerequisites> 
    [tab]  <commands>
    

    如果前置条件满足,执行命令构建目标

    • 目标是必须的
    • 前置条件和命令对可选的,但是两个必须至少存在一个 (只有目标没有前置条件和命令也是可以的,只不过没有意义

    目标

    目标可以是文件,也可以是某个操作的名字

    clean:
        rm *.o
    

    运行make clean可以执行这个操作:

    • 如果文件存在,会输出执行的指令rm *.o

    • 如果当前目录不存在.o文件,make会报错提示

      rm *.o
      rm: *.o: No such file or directory
      make: *** [clean] Error 1
      

    如果make检测到当前目录中存在clean文件,就不会执行clean操作,因此最好标明clean是个操作

    .PHONY: clean
    clean:
        rm *.o temp
    
    • makefile未指定文件时,默认寻找Makefile or makefile
    • make没有执行目标时,默认运行Makefile的第一个目标

    前置条件

    前置条件通常是一组文件名,用空格分割,指定了目标是否重新构建的标准:只要有一个前置文件不存在,或者有过更新(前置文件的修改时间晚于目标文件),目标就需要重新构建

    result.txt: source.txt
        cp source.txt result.txt
    

    如果当前目录没有source.txt,make会首到makefile的下面去寻找有没有生成source.txt的目标

    result.txt: source.txt
        cp source.txt result.txt
    source.txt:
        echo "this is the source" > source.txt
    

    命令

    命令行首默认必须是一个tab键!!!,如果测试过程有报错记得检查下,如果想替换,可用.RECIPEPREFIX替换(对整个文件生效 (The .RECIPEPREFIX is only supported since 3.82

    .RECIPEPREFIX = >
    all:
    > echo Hello, world
    

    每条命令都在单独的shell中执行,这些shell没有关联,也没有继承关系

    var-lost:
        export foo=bar
        echo "foo=[$$foo]"
    

    解决办法就是通过写成一行

    var-kept:
        export foo=bar; echo "foo=[$$foo]"
    

    或者用反斜杠转义

    var-kept:
        export foo=bar; \
        echo "foo=[$$foo]" \
    

    最后一个办法是加上.ONESHELL:命令 (同上

    .ONESHELL:
    var-kept:
        export foo=bar; 
        echo "foo=[$$foo]"
    

    语法

    # 表示注释

    正常情况下,make会打印每条命令,即使注释也会打印,在命令前面加@可以关闭打印

    test:
        # 这是测试
        @# 这是测试,不会打印出来
    

    通配符

    用来指定一组符合条件的文件名,与bash类似 * ? [...]

    允许对文件名进行模式匹配,匹配符是%

    下面的命令将 file1.c 编译为file1.o

    %.o: %.c
    

    允许使用 = 自定义变量

    txt = Hello world
    test:
        @echo $(txt)
    

    调用shell变量,需要两个$$,因为make命令会使$转义

    变量支持引用

    v1 = $(v2)
    

    为了区分生效时间,分成四类 gnu make - What is the difference between the GNU Makefile variable assignments =, ?=, := and +=? - Stack Overflow

    VARIABLE = value
    # 在执行时扩展,允许递归扩展。
    
    VARIABLE := value
    # 在定义时扩展。
    
    VARIABLE ?= value
    # 只有在该变量为空时才设置值。
    
    VARIABLE += value
    # 将值追加到变量的尾端。
    
    

    内置变量

    $(CC)指向当前编译器

    $(MAKE)指向当前make工具

    详细如表 https://www.gnu.org/software/make/manual/html_node/Implicit-Variables.html

    自动变量

    1. @ 代指当前目标, 比如make foo, `@`就指 foo

    2. $< 代指第一个前置条件

    3. $? 代指比目标更新的所有前置条件 空格分割

    4. $^ 代指所有前置条件

    5. $* 代指匹配符%匹配的部分

    6. $(@D)$(@F)指向目标的目录名和文件名

    7. $(<D)$(<F) 指向 $<de 的目录名和文件名

    https://www.gnu.org/software/make/manual/html_node/Automatic-Variables.html

    判断和循环 与bash相同

    ifeq ($(CC),gcc)
      libs=$(libs_for_gcc)
    else
      libs=$(normal_libs)
    endif
    

    函数格式

    $(function arguments)
    # 或者
    ${function arguments}
    

    内置函数

    https://www.gnu.org/software/make/manual/html_node/Functions.html

    1. shell函数

      srcfiles := $(shell echo src/{00..99}.txt)
      
    2. wildcard 函数

      srcfiles := $(wildcard src/*.txt)
      
    3. subst函数 文本替换

      $(subst from,to,text)
      

    相关文章

      网友评论

          本文标题:makefile教程

          本文链接:https://www.haomeiwen.com/subject/hmxvoltx.html