Golang Makefile示例深入讲解使用
目录
- 从入门示例开始
- makefile语法详解
- 再来一个完整示例
- 总结
Makefile提供有效方式实现自动化构建任务,与Java中的Maven类似。Makefile主要应用场景为使用目标(标签)运行不同任务。
需要提醒的是,make工具仅在Unix环境上使用,如果是Windows,需要安装linux环境依赖(如:mingw)执行make命令。
从入门示例开始
假设我们有一个main.go程序,构建文件需要使用命令:
go build main.go
运行程序使用命令为:
go build -o main.out main.go
./main.out
下面使用单个Makefile文件(文件命名为Makefile,首字母大写,没有扩展名),内容如下:
BINARY_NAME=main.out
build: go build -o ${BINARY_NAME} main.gorun: go build -o ${BINARY_NAME} main.go ./${BINARY_NAME}clean: go clean rm ${BINARY_NAME}
现在可以运python行build 和 run 任务:
make build
make run
如果需要增加缺省标签,可以使用all标签:
BINARY_NAME=main.out
## 缺省任务,不要换行
all: build testbuild: go build -o ${BINARY_NAME} main.gotest: go test -v main.gorun: go build -o ${BINARY_NAME} main.go ./${BINARY_NAME}clean: go clean rm ${BINARY_NAME}
这时直接运行make命令,则执行build test两个任务。当然我们还可以定义其他复杂任务,假如项目有多个依赖,需要通过go get package-name
命令安装,我们可以定义deps目标,实现自动安装所有相关依赖,举例:
deps:
go get github.com/gorilla/websocket
运行命令:make deps
则自动安装相关依赖。
makefile语法详解
通过上面简单示例大概了解Makefile的用途,下面介绍其基本语法,首先介绍几个术语:目标、依赖、任务以及变量。
- 目标(Target): T开发者_Python入门argets 是Makefile中的主要组件. make命令通过目标的名称执行任务。上面示例中的 build, run, and build_and_clean称为目标,目标是具体执行具体任务的接口。
- 依赖(Dependencies): 目标可以包括依赖任务,在运行当前目标之前执行的目标为依赖目标。举例,build_and_clean 有两个依赖: build run。 注意,依赖不要换行写,和目标在一行。
- 任务(Recipe): Recipe是运行目标时实际执行的一条或多条命令。如果是多个命令,则每条命令需为单独一行,且每条命令前使用tab进行缩进,不是空格。
- 变量(Variables): 大多数脚本都支持变量,Makefile也支持变量,当在不同目标中使用相同配置时,使用变量可以让脚本更通用、以维护。定义变量使用等号:
variable_name=hello-world
, 引用变量使用${variable_name}
变量举例:
x = foo
y = $(x) barx = laterall: echo $(y)
这里all为默认目标,执行make命令输出结果:
echo later bar
later bar
再来一个完整示例
下面我们通过稍微复杂的示例来说明Makefile的用法,go代码很简单,但需要编译不同平台的可执行文件。首先定义main.go文件:
package main import "fmt" func main() { fmt.Println("hello world") }
要运行项目,正常需要构建并运行二进制文件:
go build main.go
如果需要指定操作系统及输出文件,下面是MAC平台:
GOARCH=amd64 GOOS=darwin go build -o hello-world main.go
如果希望创建多个OS平台,需要运行多次命令:
GOARCH=amd64 GOOS=darwin go build -o hello-world-darwin main.go
GOARCH=amd64 GOOS=linux go build -o hello-world-linux main.goGOARCH=amd64 GOOS=window go build -o hello-world-windows main.go
上http://www.devze.com面命令可以使用Makefile,在项目根目录下创建Makefile文件:
BINARY_NAME=hello-world
build: GOARCH=amd64 GOOS=darwin go build -o ${BINARY_NAME}-darwin main.go GOARCH=amd64 GOOS=linux go build -o ${BINARY_NAME}-linux main.go GOARCH=amd64 GOOS=window go build -o ${BINARY_NAME}-windows main.gorun: ./${BINARY_NAME}build_and_run: build runclean: go clean rmpython ${BINARY_NAME}-darwin rm ${BINARY_NAME}-linux rm ${BINARY_NAME}-windows
现在可以简单运行make命令:
make run
make build
也可以运行组合命令:
make build_and_run
最后还可以运行清理命javascript令:
make clean
这些命令非常方便,有助于开发过程流水线。开发团队成员可以使用相同命令,减少操作不一致造成错误,提升构建效率。
下面扩展上面的示例,增加一些自动化任务,包括测试、覆盖率测试、代码检查以及管理依赖。具体内容如下:
BINARY_NAME=hello-world
build: GOARCH=amd64 GOOS=darwin go build -o ${BINARY_NAME}-darw编程客栈in main.go GOARCH=amd64 GOOS=linux go build -o ${BINARY_NAME}-linux main.go GOARCH=amd64 GOOS=window go build -o ${BINARY_NAME}-windows main.gorun: ./${BINARY_NAME}build_and_run: build runclean: go clean rm ${BINARY_NAME}-darwin rm ${BINARY_NAME}-linux rm ${BINARY_NAME}-windowstest: go test ./...test_coverage: go test ./... -coverprofile=coverage.outdep: go mod downloadvet: go vetlint: golangci-lint run --enable-all
现在可以简单执行下列任务:
make test
make test_coveragemake depmake vetmake lint
注意:我们使用了外部包golangci-lint,需要使用 go mod ,确保在go.mod文件中增加相应依赖。
总结
Golang是开发大型项目的流行语言。较大的项目会有多人协作,并且需要持续的自动化构建。通过自动化开发、测试和发布等任务来简化构建过程,会带来更快、更可靠、更简单的开发体验。
到此这篇关于Golang Makefile示例深入讲解使用的文章就介绍到这了,更多相关Go Makefile内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!
精彩评论