1 简介
go程序可用通过交叉编译的方式在一个平台输出多个平台可运行的二进制包。
交叉编译示意图:
两个方式分别为使用cgo的交叉编译和不使用cgo的交叉编译。无需CGO时,直接使用Go的跨平台支持编译。
设置环境变量如GOOS
, GOARCH
, CGO_ENABLED
来执行编译,例如CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build
。
Mac上交叉编译至Linux和Windows,Linux反之,Windows亦然,需相应调整环境变量。
-
支持的环境列表
bashgo tool dist list aix/ppc64 android/386 android/amd64 android/arm android/arm64 darwin/amd64 darwin/arm64 dragonfly/amd64 freebsd/386 freebsd/amd64 freebsd/arm freebsd/arm64 freebsd/riscv64 illumos/amd64 ios/amd64 ios/arm64 js/wasm linux/386 linux/amd64 linux/arm linux/arm64 linux/loong64 linux/mips linux/mips64 linux/mips64le linux/mipsle linux/ppc64 linux/ppc64le linux/riscv64 linux/s390x netbsd/386 netbsd/amd64 netbsd/arm netbsd/arm64 openbsd/386 openbsd/amd64 openbsd/arm openbsd/arm64 openbsd/mips64 plan9/386 plan9/amd64 plan9/arm solaris/amd64 windows/386 windows/amd64 windows/arm windows/arm64
2 编译步骤
设置MAC,LINUX,WINDOWS 编译环境和执行编译。
1.Mac Mac下编译Linux, Windows平台的64位可执行程序:
go
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build test.go
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build test.go
参数介绍:
bash
$CGO_ENABLED:0表示关闭CGO
$GOOS:目标平台(编译后要运行的目标平台)的操作系统
(darwin、freebsd、linux、windows)
$GOARCH:目标平台(编译后要运行的目标平台)的体系架构
(386、amd64、arm)分别对应(32位、64位、ARM平台)的架构
2.Linux Linux下编译Mac, Windows平台的64位可执行程序:
go
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build test.go
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build test.go
3.Windows Windows下编译Mac, Linux平台的64位可执行程序:
cmd:
ini
set GOARCH=amd64
go env -w GOPATH=amd64
set GOOS = linux
go env -w GOOS=linux
还原:
ini
set GOARCH=amd64
go env -w GOARCH=cmd64
set GOOS=windows
go env -w GOOS=windows
3 带cgo交叉编译步骤
-
设置环境信息
iniexport CFLAGS="-arch arm64 -miphoneos-version-min=9.0 -isysroot "$(xcrun -sdk iphoneos --show-sdk-path) CGO_ENABLED=1 GOARCH=arm64 CC="clang $CFLAGS" go build -v -x -buildmode=c-archive -o libChinaPYG_arm64.a
这会同时生成libChinaPYG_arm64.a、libChinaPYG_arm64.h两个文件,直接嵌入到C代码中正常使用。
编译 darwin/arm64 的 example 命令就是:
ruby
CC=/usr/local/go/misc/ios/clangwrap.sh GOOS=darwin GOARCH=arm64 CGO_ENABLED=1 go build
编译 darwin/arm 的 example 命令是:
ruby
CC=/usr/local/go/misc/ios/clangwrap.sh GOOS=darwin GOARCH=arm CGO_ENABLED=1 go build
-
linux交叉编译windows:
bashCGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -trimpath -o bin/main.exe ./cmd/dend-server/main.go CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o bin/main.exe ./cmd/dend-server/main.go
4 构建测试支持
Go 提供易于使用的支持,用于通过" go test -coverprofile=... <pkg_target>"命令在包单元测试级别收集覆盖率配置文件。
从 Go 1.20 开始,用户现在可以为更大的集成测试收集覆盖率配置文件:更重量级、更复杂的测试,执行给定应用程序二进制文件的多次运行。
对于单元测试,收集覆盖率概况和生成报告需要两个步骤:go test -coverprofile=...运行,然后调用go tool cover {-func,-html}生成报告。
对于集成测试,需要三个步骤:构建步骤、运行步骤(可能涉及从构建步骤多次调用二进制文件),最后是报告步骤,如下所述。
构建用于覆盖率分析的二进制文件,要构建用于收集覆盖率配置文件的应用程序,请-cover在调用go build应用程序二进制目标时传递标志。
请参阅下面的示例go build -cover调用部分。然后可以使用环境变量设置运行生成的二进制文件以捕获覆盖率配置文件(请参阅下一节运行)。
- 如何为检测选择包
在给定的" go build -cover"调用期间,Go 命令将选择主模块中的包进行覆盖率分析;默认情况下,不会包含提供给构建的其他包(go.mod 中列出的依赖项,或作为 Go 标准库一部分的包)。
例如,这是一个玩具程序,包含一个主包、一个本地主模块包greetings和一组从模块外部导入的包,包括(除其他外)rsc.io/quote和fmt(完整程序的链接)。
go
$ cat go.mod
module mydomain.com
go 1.20
require rsc.io/quote v1.5.2
require (
golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c // indirect
rsc.io/sampler v1.3.0 // indirect
)
$ cat myprogram.go
package main
import (
"fmt"
"mydomain.com/greetings"
"rsc.io/quote"
)
func main() {
fmt.Printf("I say %q and %q\n", quote.Hello(), greetings.Goodbye())
}
$ cat greetings/greetings.go
package greetings
func Goodbye() string {
return "see ya"
}
$ go build -cover -o myprogram.exe .
$
如果您使用" -cover"命令行标志构建此程序并运行它,配置文件中将恰好包含两个包:main和mydomain.com/greetings;其他依赖包将被排除在外。
想要更好地控制包含哪些包以进行覆盖的用户可以使用" -coverpkg"标志进行构建。例子:
shell
$ go build -cover -o myprogramMorePkgs.exe -coverpkg=io,mydomain.com,rsc.io/quote .
$
在上面的构建中,选择了 main 包mydomain.com以及rsc.io/quote和io包进行分析;因为 mydomain.com/greetings没有具体列出,所以它将被排除在配置文件之外,即使它位于主模块中。
5 运行覆盖检测的二进制文件
用""构建的二进制-cover文件在执行结束时将配置文件数据文件写到通过环境变量指定的目录中GOCOVERDIR。例子:
shell
$ go build -cover -o myprogram.exe myprogram.go
$ mkdir somedata
$ GOCOVERDIR=somedata ./myprogram.exe
I say "Hello, world." and "see ya"
$ ls somedata
covcounters.c6de772f99010ef5925877a7b05db4cc.2424989.1670252383678349347
covmeta.c6de772f99010ef5925877a7b05db4cc
$
请注意写入目录的两个文件somedata:这些(二进制)文件包含覆盖率结果。有关如何从这些数据文件生成人类可读结果的更多信息,请参阅以下有关报告的部分。
如果GOCOVERDIR未设置环境变量,覆盖检测的二进制文件仍将正确执行,但会发出警告。
6 小结
大多数程序使用内置的构建方法即可,可参考以下几点:
markdown
1 你的程序没有用到 CGO 的 Golang 程序,直接用编译器自带的跨平台特性即可全平台编译;
2 用到了 CGO 需要发布到ARM平台的Golang程序,推荐自己配置ARM交叉编译环境;
3 用到了 CGO 需要发布到Win/Linux/Mac平台的Golang程序,推荐用使用go-ui-crossbuild 。