Wikibooks

Go/クロスコンパイル

< Go


Goにおけるクロスコンパイル

編集

はじめに

編集

クロスコンパイルとは、開発しているマシンとは異なるターゲット環境（オペレーティングシステムやCPUアーキテクチャ）向けに実行ファイルを生成するプロセスです。Goは強力なクロスコンパイル機能を持ち、複数のプラットフォーム向けのバイナリを簡単に作成できます。

Goのクロスコンパイルの利点

編集
  • 開発環境に依存せず：WindowsマシンでLinux向けのバイナリを作成できる
  • シンプルな設定：環境変数の設定だけで異なるターゲット向けにビルド可能
  • ネイティブバイナリの生成：依存関係のないスタンドアロンの実行ファイルを生成

クロスコンパイルの基本

編集

Goでクロスコンパイルを行うには、GOOSとGOARCHの2つの環境変数を設定します。

  • GOOS: ターゲットのオペレーティングシステム
  • GOARCH: ターゲットのCPUアーキテクチャ

主なGOOS値

編集
  • windows: Windows
  • linux: Linux
  • darwin: macOS
  • freebsd: FreeBSD
  • android: Android

主なGOARCH値

編集
  • amd64: 64-bit x86 (Intel/AMD)
  • 386: 32-bit x86
  • arm: ARM
  • arm64: 64-bit ARM
  • ppc64: 64-bit PowerPC
  • s390x: IBM System z

クロスコンパイルの実行方法

編集

コマンドラインでの実行例

編集 
# Linux 64-bit (amd64) 向けにビルド
env GOOS=linux GOARCH=amd64 go build -o myapp-linux-amd64 main.go

# Windows 64-bit 向けにビルド
GOOS=windows GOARCH=amd64 go build -o myapp-windows-amd64.exe main.go

# macOS 64-bit 向けにビルド
GOOS=darwin GOARCH=amd64 go build -o myapp-darwin-amd64 main.go

# Raspberry Pi (ARM) 向けにビルド
env GOOS=linux GOARCH=arm go build -o myapp-linux-arm main.go

Windows環境での実行例

編集

Windows環境では、コマンドの記述方法が少し異なります： 

# CMD
set GOOS=linux
set GOARCH=amd64
go build -o myapp-linux-amd64 main.go

# PowerShell
$env:GOOS="linux"
$env:GOARCH="amd64"
go build -o myapp-linux-amd64 main.go

高度なクロスコンパイル設定

編集

ARM向けのビルドでARMバージョンを指定

編集

ARMアーキテクチャには様々なバージョンがあります。GOARM環境変数を使ってバージョンを指定できます： 

env GOOS=linux GOARCH=arm GOARM=7 go build -o myapp-armv7 main.go

CGOと依存関係

編集

デフォルトでは、クロスコンパイル時にCGO_ENABLED=0が設定され、Cライブラリへの依存を避けるよう構成されます。特定の場合にはCGOを有効化する必要があります： 

env CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build main.go

ただし、CGOを有効にする場合は、ターゲットプラットフォーム向けのCコンパイラが必要になります。

マルチプラットフォームビルドの自動化

編集

シェルスクリプトを使用した例

編集 
#!/bin/bash
BINARY_NAME=myapp
PLATFORMS=("windows/amd64" "linux/amd64" "darwin/amd64")

for platform in "${PLATFORMS[@]}"
do
    platform_split=(${platform//\// })
    GOOS=${platform_split[0]}
    GOARCH=${platform_split[1]}
    
    output_name=$BINARY_NAME'-'$GOOS'-'$GOARCH
    if [ $GOOS = "windows" ]; then
        output_name+='.exe'
    fi
    
    echo "Building for $GOOS/$GOARCH..."
    env GOOS=$GOOS GOARCH=$GOARCH go build -o $output_name
    
    if [ $? -ne 0 ]; then
        echo "Error building for $GOOS/$GOARCH"
    fi
done

Makefileを使った例

編集 
.PHONY: build-all

BINARY_NAME=myapp
PLATFORMS=linux/amd64 linux/arm windows/amd64 darwin/amd64

build-all:
	$(foreach platform,$(PLATFORMS), \
		$(eval GOOS = $(word 1,$(subst /, ,$(platform)))) \
		$(eval GOARCH = $(word 2,$(subst /, ,$(platform)))) \
		$(eval EXTENSION = $(if $(filter windows,$(GOOS)),.exe,)) \
		$(shell GOOS=$(GOOS) GOARCH=$(GOARCH) go build -o $(BINARY_NAME)-$(GOOS)-$(GOARCH)$(EXTENSION) main.go) \
	)

goreleaser を使用する方法

編集

大規模なプロジェクトでは goreleaser ツールを使うとクロスコンパイルとリリースプロセスが簡単になります： 

# .goreleaser.yml
builds:
  - env:
      - CGO_ENABLED=0
    goos:
      - linux
      - windows
      - darwin
    goarch:
      - amd64
      - arm64
      - arm
    goarm:
      - 6
      - 7

よくある問題と解決策

編集

CGO依存の問題

編集

エラー: cgo: C compiler "gcc" not found: exec: "gcc": executable file not found in %PATH%

解決策: CGOを無効にする 

env CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build main.go

ビルド時のネイティブライブラリ依存

編集

問題: プログラムがOS固有のライブラリに依存している場合

解決策:

  • 可能な限りGoのネイティブライブラリを使用する
  • 条件付きコンパイルでOS別の実装を分ける
// +build windows

package main

import "syscall"

// Windowsでのみ使用される関数

実行権限のエラー

編集

問題: Linuxバイナリがパーミッションエラーで実行できない

解決策: バイナリに実行権限を与える 

chmod +x ./myapp-linux-amd64

実用的なクロスコンパイル事例

編集

Webサーバーの例

編集 
package main

import (
    "fmt"
    "net/http"
    "os"
    "runtime"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello from Go! Running on %s/%s\n", runtime.GOOS, runtime.GOARCH)
    })
    
    port := os.Getenv("PORT")
    if port == "" {
        port = "8080"
    }
    
    fmt.Printf("Server starting on port %s...\n", port)
    err := http.ListenAndServe(":"+port, nil)
    if err != nil {
        fmt.Printf("Error starting server: %s\n", err)
    }
}

このサーバーをさまざまなプラットフォームでビルドし、それぞれで同じ機能を提供できます。

まとめ

編集

Goのクロスコンパイル機能は、さまざまなプラットフォーム向けのアプリケーション開発を非常に簡単にします。主な利点は：

  1. 開発環境に依存せず、あらゆるプラットフォーム向けのバイナリを生成できる
  2. 環境変数の設定だけで簡単にクロスコンパイルができる
  3. 依存関係のないスタンドアロンバイナリの生成が可能

この機能を活用することで、アプリケーションの配布と展開が大幅に簡素化され、Goプログラムの移植性が向上します。

"https://ja.wikibooks.org/w/index.php?title=Go/クロスコンパイル&oldid=272211" より作成