乐趣区

golang编译时给包内变量赋值,实现打印版本号及commit

很多命令行程序都可以通过 version 参数输出版本信息,commit,操作系统等信息。下面介绍一种方法实现 golang 编译的命令行程序打印版本号。
docker 打印的版本信息:
$ ~ docker version
Client: Docker Engine – Community
Version: 18.09.2
API version: 1.39
Go version: go1.10.8
Git commit: 6247962
Built: Sun Feb 10 04:12:39 2019
OS/Arch: darwin/amd64
Experimental: false

Server: Docker Engine – Community
Engine:
Version: 18.09.2
API version: 1.39 (minimum version 1.12)
Go version: go1.10.6
Git commit: 6247962
Built: Sun Feb 10 04:13:06 2019
OS/Arch: linux/amd64
Experimental: false
实现方式是利用 go build 的一个参数 -ldflags。输入 go help build,可以看到一个配置项:
-ldflags ‘flag list’ arguments to pass on each go tool link invocation.

这个参数是用来设置 go link(静态链接) 的一些参数,具体有哪些参数可以通过 go tool link –help 查看。
其中 - X 参数可以在编译时给包内的变量赋值,然后我们利用 flag 包设置 version 参数就能实现打印版本号了。
main.go:
package main

import (
“flag”
“log”
“os”
)

var (
Version string
Branch string
Commit string
BuildTime string
lowercase string // 小写也可以
)

func main() {
versionFlag := flag.Bool(“version”, false, “print the version”)
flag.Parse()

if *versionFlag {
log.Printf(“Version: %s\n”, Version)
log.Printf(“Branch: %s\n”, Branch)
log.Printf(“Commit: %s\n”, Commit)
log.Printf(“BuildTime: %s\n”, BuildTime)
log.Printf(“lowercase: %s\n”, lowercase)
os.Exit(0)
}

log.Println(“run main.go”)
}
打包脚本:
#!/usr/bin/env bash

prog=xxx
version=1.1.0
lowercase=ok

# 交叉编译
# CGO_ENABLED=0 GOOS=linux GOARCH=amd64
go build -ldflags “\
-X main.Version=$version \
-X main.Branch=`git rev-parse –abbrev-ref HEAD` \
-X main.Commit=`git rev-parse HEAD` \
-X main.BuildTime=`date -u ‘+%Y-%m-%d_%H:%M:%S’` \
-X main.lowercase=$lowercase \
” -v -o $prog main.go
最终效果:
$ ./xxx -version
2019/04/11 00:59:08 Version: 1.1.0
2019/04/11 00:59:08 Branch: master
2019/04/11 00:59:08 Commit: 29921d9df18543693321e2109ea36462dbb346d3
2019/04/11 00:59:08 BuildTime: 2019-04-10_16:59:07
2019/04/11 00:59:08 lowercase: ok

退出移动版