Skip to main content
Version: 2.2.x

使用方式

具体参数,使用 gf build -h 查看帮助

仅限于交叉编译使用到 GoFrame 框架的项目,支持绝大部分常见系统的直接交叉编译。

内置编译变量

build 命令自动嵌入编译变量,这些变量用户可自定义,并且在运行时通过 gbuild 组件获取。使用 gf build 的项目将会默认嵌入以下变量(参考 gf -v):

  • 当前 Go 版本
  • 当前 GoFrame 版本
  • 当前 Git Commit(如果存在)
  • 当前编译时间

编译配置文件

build 支持同时从命令行以及配置文件指定编译参数、选项。 GoFrame 框架的所有组件及所有生态项目都是使用的同一个配置管理组件,默认的配置文件以及配置使用请参考章节 配置管理。以下是一个简单的配置示例供参考(以 config.yaml 为例):

gfcli:
build:
name: "gf"
arch: "all"
system: "all"
mod: "none"
packSrc: "resource,manifest"
version: "v1.0.0"
output: "./bin"
extra: ""

配置选项的释义同命令行同名选项。

名称默认值含义示例
name与程序入口 go 文件同名生成的可执行文件名称。如果是 windows 平台,那么默认会加上 .exe 后缀gf
arch当前系统架构编译架构,多个以 , 号分隔,如果是 all 表示编译所有支持架构386,amd64,arm
system当前系统平台编译平台,多个以 , 号分隔,如果是 all 表示编译所有支持平台linux,darwin,windows
path./bin编译可执行文件存储的目录地址./bin
modgo build -mod 编译选项,不常用none
cgo0是否开启 CGO,默认是关闭的。如果开启,那么交叉编译可能会有问题。0
packSrc需要打包的目录,多个以 , 号分隔,生成到 internal/packed/build_pack_data.gopublic,template
packDstinternal/packed/build_pack_data.go打包后生成的 Go 文件路径,一般使用相对路径指定到本项目目录中
version程序版本,如果指定版本信息,那么程序生成的路径中会多一层以版本名称的目录v1.0.0
output输出的可执行文件路径,当该参数指定时, namepath 参数失效,常用于编译单个可执行文件./bin/gf.exe
extra额外自定义的编译参数,会直接传递给 go build 命令
varMap自定义的内置变量键值对<br />gfcli:<br /> build:<br /> name: "gf"<br /> arch: "all"<br /> system: "all"<br /> mod: "none"<br /> cgo: 0<br /> varMap:<br /> k1: v1<br /> k2: v2<br />

编译时的内置变量可以在运行时通过 gbuild构建信息-gbuild 获取。

使用示例

$ gf build
2020-12-31 00:35:25.562 start building...
2020-12-31 00:35:25.562 go build -o ./bin/darwin_amd64/gf main.go
2020-12-31 00:35:28.381 go build -o ./bin/freebsd_386/gf main.go
2020-12-31 00:35:30.650 go build -o ./bin/freebsd_amd64/gf main.go
2020-12-31 00:35:32.957 go build -o ./bin/freebsd_arm/gf main.go
2020-12-31 00:35:35.824 go build -o ./bin/linux_386/gf main.go
2020-12-31 00:35:38.082 go build -o ./bin/linux_amd64/gf main.go
2020-12-31 00:35:41.076 go build -o ./bin/linux_arm/gf main.go
2020-12-31 00:35:44.369 go build -o ./bin/linux_arm64/gf main.go
2020-12-31 00:35:47.352 go build -o ./bin/linux_ppc64/gf main.go
2020-12-31 00:35:50.293 go build -o ./bin/linux_ppc64le/gf main.go
2020-12-31 00:35:53.166 go build -o ./bin/linux_mips/gf main.go
2020-12-31 00:35:55.840 go build -o ./bin/linux_mipsle/gf main.go
2020-12-31 00:35:58.423 go build -o ./bin/linux_mips64/gf main.go
2020-12-31 00:36:01.062 go build -o ./bin/linux_mips64le/gf main.go
2020-12-31 00:36:03.502 go build -o ./bin/netbsd_386/gf main.go
2020-12-31 00:36:06.280 go build -o ./bin/netbsd_amd64/gf main.go
2020-12-31 00:36:09.332 go build -o ./bin/netbsd_arm/gf main.go
2020-12-31 00:36:11.811 go build -o ./bin/openbsd_386/gf main.go
2020-12-31 00:36:14.140 go build -o ./bin/openbsd_amd64/gf main.go
2020-12-31 00:36:17.859 go build -o ./bin/openbsd_arm/gf main.go
2020-12-31 00:36:20.327 go build -o ./bin/windows_386/gf.exe main.go
2020-12-31 00:36:22.994 go build -o ./bin/windows_amd64/gf.exe main.go
2020-12-31 00:36:25.795 done!