原文地址:Golang Gin实践 番外 请入门 Makefile
前言
含一定复杂度的软件工程,基本上都是先编译 A,再依赖 B,再编译 C...,最后才执行构建
如果每次都人为编排,又或是每新来一个同事就问你项目 D 怎么构建、重新构建需要注意什么...等等情况,岂不是要崩溃?
我们常常会在开源项目中发现 Makefile,你是否有过疑问?
本章节会简单介绍 Makefile 的使用方式,最后建议深入学习
怎么解决
对于构建编排,Docker 有 Dockerfile ,在 Unix 中有神器 Make ....
Make
是什么
Make 是一个构建自动化工具,会在当前目录下寻找 Makefile 或 makefile 文件。如果存在,会依据 Makefile 的构建规则去完成构建
当然了,实际上 Makefile 内都是你根据 make 语法规则,自己编写的特定 Shell 命令等
它是一个工具,规则也很简单。在支持的范围内,编译 A, 依赖 B,再编译 C,完全没问题
规则
Makefile 由多条规则组成,每条规则都以一个 target(目标)开头,后跟一个 : 冒号,冒号后是这一个目标的 prerequisites(前置条件)
紧接着新的一行,必须以一个 tab 作为开头,后面跟随 command(命令),也就是你希望这一个 target 所执行的构建命令
[target] ... : [prerequisites] ...
[command]
...
...
- target:一个目标代表一条规则,可以是一个或多个文件名。也可以是某个操作的名字(标签),称为伪目标(phony)
- prerequisites:前置条件,这一项是可选参数。通常是多个文件名、伪目标。它的作用是 target 是否需要重新构建的标准,如果前置条件不存在或有过更新(文件的最后一次修改时间)则认为 target 需要重新构建
- command:构建这一个 target 的具体命令集
简单的例子
本文将以 go-gin-example 去编写 Makefile 文件,请跨入 make 的大门
分析
在编写 Makefile 前,需要先分析构建先后顺序、依赖项,需要解决的问题等
编写
.PHONY: build clean tool lint help
all: build
build:
go build -v .
tool:
go tool vet . |& grep -v vendor; true
gofmt -w .
lint:
golint ./...
clean:
rm -rf go-gin-example
go clean -i .
help:
@echo "make: compile packages and dependencies"
@echo "make tool: run specified go tool"
@echo "make lint: golint ./..."
@echo "make clean: remove object files and cached files"
1、在上述文件中,使用了 .PHONY
,其作用是声明 build / clean / tool / lint / help 为伪目标,声明为伪目标会怎么样呢?
- 声明为伪目标后:在执行对应的命令时,make 就不会去检查是否存在 build / clean / tool / lint / help 其对应的文件,而是每次都会运行标签对应的命令
- 若不声明:恰好存在对应的文件,则 make 将会认为 xx 文件已存在,没有重新构建的必要了
2、这块比较简单,在命令行执行即可看见效果,实现了以下功能:
- make: make 就是 make all
- make build: 编译当前项目的包和依赖项
- make tool: 运行指定的 Go 工具集
- make lint: golint 一下
- make clean: 删除对象文件和缓存文件
- make help: help
为什么会打印执行的命令
如果你实际操作过,可能会有疑问。明明只是执行命令,为什么会打印到标准输出上了?
原因
make 默认会打印每条命令,再执行。这个行为被定义为回声
解决
可以在对应命令前加上 @,可指定该命令不被打印到标准输出上
build:
@go build -v .
那么还有其他的特殊符号吗?有的,请课后去了解下 +、- 的用途
小结
这是一篇比较简洁的文章,希望可以让您对 Makefile 有一个基本了解
恭喜你必备技能 +1
参考
本系列示例代码
- go-gin-example
本系列目录
- 连载一 Golang介绍与环境安装
- 连载二 搭建Blog API's(一)
- 连载三 搭建Blog API's(二)
- 连载四 搭建Blog API's(三)
- 连载五 使用JWT进行身份校验
- 连载六 编写一个简单的文件日志
- 连载七 Golang优雅重启HTTP服务
- 连载八 为它加上Swagger
- 连载九 将Golang应用部署到Docker
- 连载十 定制 GORM Callbacks
- 连载十一 Cron定时任务
- 连载十二 优化配置结构及实现图片上传
- 连载十三 优化你的应用结构和实现Redis缓存
- 连载十四 实现导出、导入 Excel
- 连载十五 生成二维码、合并海报
- 连载十六 在图片上绘制文字
- 连载十七 用 Nginx 部署 Go 应用
- 番外 Golang交叉编译
- 番外 请入门 Makefile