mirror of https://github.com/ethereum/go-ethereum
build: improve cross compilation setup (#22804)
This PR cleans up the CI build system and fixes a couple of issues. - The go tool launcher code has been moved to internal/build. With the new toolchain functions, the environment of the host Go (i.e. the one that built ci.go) and the target Go (i.e. the toolchain downloaded by -dlgo) are isolated more strictly. This is important to make cross compilation and -dlgo work correctly in more cases. - The -dlgo option now skips the download and uses the host Go if the running Go version matches dlgoVersion exactly. - The 'test' command now supports -dlgo, -cc and -arch. Running unit tests with foreign GOARCH is occasionally useful. For example, it can be used to run 32-bit tests on Windows. It can also be used to run darwin/amd64 tests on darwin/arm64 using Rosetta 2. - The 'aar', 'xcode' and 'xgo' commands now use a slightly different method to install external tools. They previously used `go get`, but this comes with the annoying side effect of modifying go.mod. They now use `go install` instead, which is the recommended way of installing tools without modifying the local module. - The old build warning about outdated Go version has been removed because we're much better at keeping backwards compatibility now.pull/22811/head
parent
b8040a430e
commit
effaf18523
@ -0,0 +1,149 @@ |
||||
// Copyright 2021 The go-ethereum Authors
|
||||
// This file is part of the go-ethereum library.
|
||||
//
|
||||
// The go-ethereum library is free software: you can redistribute it and/or modify
|
||||
// it under the terms of the GNU Lesser General Public License as published by
|
||||
// the Free Software Foundation, either version 3 of the License, or
|
||||
// (at your option) any later version.
|
||||
//
|
||||
// The go-ethereum library is distributed in the hope that it will be useful,
|
||||
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
// GNU Lesser General Public License for more details.
|
||||
//
|
||||
// You should have received a copy of the GNU Lesser General Public License
|
||||
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
package build |
||||
|
||||
import ( |
||||
"fmt" |
||||
"log" |
||||
"os" |
||||
"os/exec" |
||||
"path/filepath" |
||||
"runtime" |
||||
"strings" |
||||
) |
||||
|
||||
type GoToolchain struct { |
||||
Root string // GOROOT
|
||||
|
||||
// Cross-compilation variables. These are set when running the go tool.
|
||||
GOARCH string |
||||
GOOS string |
||||
CC string |
||||
} |
||||
|
||||
// Go creates an invocation of the go command.
|
||||
func (g *GoToolchain) Go(command string, args ...string) *exec.Cmd { |
||||
tool := g.goTool(command, args...) |
||||
|
||||
// Configure environment for cross build.
|
||||
if g.GOARCH != "" && g.GOARCH != runtime.GOARCH { |
||||
tool.Env = append(tool.Env, "CGO_ENABLED=1") |
||||
tool.Env = append(tool.Env, "GOARCH="+g.GOARCH) |
||||
} |
||||
if g.GOOS != "" && g.GOOS != runtime.GOOS { |
||||
tool.Env = append(tool.Env, "GOOS="+g.GOOS) |
||||
} |
||||
// Configure C compiler.
|
||||
if g.CC != "" { |
||||
tool.Env = append(tool.Env, "CC="+g.CC) |
||||
} else if os.Getenv("CC") != "" { |
||||
tool.Env = append(tool.Env, "CC="+os.Getenv("CC")) |
||||
} |
||||
return tool |
||||
} |
||||
|
||||
// Install creates an invocation of 'go install'. The command is configured to output
|
||||
// executables to the given 'gobin' directory.
|
||||
//
|
||||
// This can be used to install auxiliary build tools without modifying the local go.mod and
|
||||
// go.sum files. To install tools which are not required by go.mod, ensure that all module
|
||||
// paths in 'args' contain a module version suffix (e.g. "...@latest").
|
||||
func (g *GoToolchain) Install(gobin string, args ...string) *exec.Cmd { |
||||
if !filepath.IsAbs(gobin) { |
||||
panic("GOBIN must be an absolute path") |
||||
} |
||||
tool := g.goTool("install") |
||||
tool.Env = append(tool.Env, "GOBIN="+gobin) |
||||
tool.Args = append(tool.Args, "-mod=readonly") |
||||
tool.Args = append(tool.Args, args...) |
||||
|
||||
// Ensure GOPATH is set because go install seems to absolutely require it. This uses
|
||||
// 'go env' because it resolves the default value when GOPATH is not set in the
|
||||
// environment. Ignore errors running go env and leave any complaining about GOPATH to
|
||||
// the install command.
|
||||
pathTool := g.goTool("env", "GOPATH") |
||||
output, _ := pathTool.Output() |
||||
tool.Env = append(tool.Env, "GOPATH="+string(output)) |
||||
return tool |
||||
} |
||||
|
||||
func (g *GoToolchain) goTool(command string, args ...string) *exec.Cmd { |
||||
if g.Root == "" { |
||||
g.Root = runtime.GOROOT() |
||||
} |
||||
tool := exec.Command(filepath.Join(g.Root, "bin", "go"), command) |
||||
tool.Args = append(tool.Args, args...) |
||||
tool.Env = append(tool.Env, "GOROOT="+g.Root) |
||||
|
||||
// Forward environment variables to the tool, but skip compiler target settings.
|
||||
// TODO: what about GOARM?
|
||||
skip := map[string]struct{}{"GOROOT": {}, "GOARCH": {}, "GOOS": {}, "GOBIN": {}, "CC": {}} |
||||
for _, e := range os.Environ() { |
||||
if i := strings.IndexByte(e, '='); i >= 0 { |
||||
if _, ok := skip[e[:i]]; ok { |
||||
continue |
||||
} |
||||
} |
||||
tool.Env = append(tool.Env, e) |
||||
} |
||||
return tool |
||||
} |
||||
|
||||
// DownloadGo downloads the Go binary distribution and unpacks it into a temporary
|
||||
// directory. It returns the GOROOT of the unpacked toolchain.
|
||||
func DownloadGo(csdb *ChecksumDB, version string) string { |
||||
// Shortcut: if the Go version that runs this script matches the
|
||||
// requested version exactly, there is no need to download anything.
|
||||
activeGo := strings.TrimPrefix(runtime.Version(), "go") |
||||
if activeGo == version { |
||||
log.Printf("-dlgo version matches active Go version %s, skipping download.", activeGo) |
||||
return runtime.GOROOT() |
||||
} |
||||
|
||||
ucache, err := os.UserCacheDir() |
||||
if err != nil { |
||||
log.Fatal(err) |
||||
} |
||||
|
||||
// For Arm architecture, GOARCH includes ISA version.
|
||||
os := runtime.GOOS |
||||
arch := runtime.GOARCH |
||||
if arch == "arm" { |
||||
arch = "armv6l" |
||||
} |
||||
file := fmt.Sprintf("go%s.%s-%s", version, os, arch) |
||||
if os == "windows" { |
||||
file += ".zip" |
||||
} else { |
||||
file += ".tar.gz" |
||||
} |
||||
url := "https://golang.org/dl/" + file |
||||
dst := filepath.Join(ucache, file) |
||||
if err := csdb.DownloadFile(url, dst); err != nil { |
||||
log.Fatal(err) |
||||
} |
||||
|
||||
godir := filepath.Join(ucache, fmt.Sprintf("geth-go-%s-%s-%s", version, os, arch)) |
||||
if err := ExtractArchive(dst, godir); err != nil { |
||||
log.Fatal(err) |
||||
} |
||||
goroot, err := filepath.Abs(filepath.Join(godir, "go")) |
||||
if err != nil { |
||||
log.Fatal(err) |
||||
} |
||||
return goroot |
||||
} |
Loading…
Reference in new issue