X11のコンパイル (Linux、*BSD)

必要条件

Linux またはその他の Unix バリアントでコンパイルするには、次のことが必要です:

  • GCCまたはClang
  • Python 3 あるいは 2.7 以上
  • SCons ビルドシステム (Python3には3.0以降)
  • pkg-config (以下の依存関係を検出するために使用)
  • X11、Xcursor、Xinerama、XiおよびXRandR開発ライブラリ
  • MesaGL開発ライブラリ
  • ALSA開発ライブラリ
  • PulseAudio開発ライブラリ
  • 任意 - libudev (udev=yes でのビルドに)
  • 任意 - yasm (WebM SIMD最適化のため)

参考

Godotにおける基本的なSconsの使い方については、ビルドシステムの説明を参照してください。

ディストリビューション固有のワンライナー

Alpine Linux
apk add scons pkgconf gcc g++ libx11-dev libxcursor-dev libxinerama-dev libxi-dev libxrandr-dev \
    libexecinfo-dev
Arch Linux
pacman -S --needed scons pkgconf gcc libxcursor libxinerama libxi libxrandr mesa glu libglvnd \
    alsa-lib pulseaudio yasm
Debian / Ubuntu
sudo apt-get install build-essential scons pkg-config libx11-dev libxcursor-dev libxinerama-dev \
    libgl1-mesa-dev libglu-dev libasound2-dev libpulse-dev libudev-dev libxi-dev libxrandr-dev yasm
Fedora
sudo dnf install scons pkgconfig libX11-devel libXcursor-devel libXrandr-devel libXinerama-devel \
    libXi-devel mesa-libGL-devel mesa-libGLU-devel alsa-lib-devel pulseaudio-libs-devel \
    libudev-devel yasm
FreeBSD
sudo pkg install scons pkgconf xorg-libraries libXcursor libXrandr libXi xorgproto libGLU alsa-lib \
    pulseaudio yasm
Gentoo
emerge -an dev-util/scons x11-libs/libX11 x11-libs/libXcursor x11-libs/libXinerama x11-libs/libXi \
    media-libs/mesa media-libs/glu media-libs/alsa-lib media-sound/pulseaudio dev-lang/yasm
Mageia
urpmi scons task-c++-devel pkgconfig "pkgconfig(alsa)" "pkgconfig(glu)" "pkgconfig(libpulse)" \
    "pkgconfig(udev)" "pkgconfig(x11)" "pkgconfig(xcursor)" "pkgconfig(xinerama)" "pkgconfig(xi)" \
    "pkgconfig(xrandr)" yasm
OpenBSD
pkg_add python scons llvm yasm
openSUSE
sudo zypper install scons pkgconfig libX11-devel libXcursor-devel libXrandr-devel libXinerama-devel \
        libXi-devel Mesa-libGL-devel alsa-devel libpulse-devel libudev-devel libGLU1 yasm
Solus
sudo eopkg install -c system.devel scons libxcursor-devel libxinerama-devel libxi-devel \
    libxrandr-devel mesalib-devel libglu alsa-lib-devel pulseaudio-devel yasm

コンパイル

ターミナルを起動し、エンジンソースコードのルートディレクトリに移動し、次のように入力します:

[email protected]:~/godot$ scons -j8 platform=x11

-j (jobs ジョブ) フラグに関する経験則は、GodotのコンパイルにはCPUのコア数だけスレッドを割り当てるべきということです。そこからさらに一つか二つ追加してもいいでしょう。下記にあるSConsコマンドのいずれにも自由に -j オプションを付けてください。

すべてがうまくいけば、結果として得られるバイナリ実行可能ファイルは「bin」サブディレクトリに配置されます。この実行可能ファイルにはエンジン全体が含まれており、依存関係なしで実行されます。実行すると、プロジェクトマネージャが呼び出されます。

注釈

GCCではなくClangを使用してコンパイルする場合は、次のコマンドを使用します:

[email protected]:~/godot$ scons platform=x11 use_llvm=yes

Clangを使うことはOpenBSDの要件のようで、そうしないとフォントが作れません。

注釈

制作に使うGodotをコンパイルするなら、SConsのオプション target=release_debug を追加すれば、より小さくて高速な実行ファイルにすることができます。

If you are compiling Godot with GCC, you can make the binary even smaller and faster by adding the SCons option use_lto=yes. As link-time optimization is a memory-intensive process, this will require about 3 GB of available RAM while compiling.

エクスポートテンプレートの構築

警告

Linuxのバイナリは通常、ビルドしたディストリビューションより古いディストリビューションでは動きません。もし大抵のディストリビューションで動作するバイナリを配布したいなら、Ubuntu 16.04のような古いディストリビューションでビルドするべきでしょう。バーチャルマシンやコンテナを使えば、適切なビルド環境をセットアップできます。

X11(Linux、*BSD)エクスポートテンプレートをビルドするには、次のパラメーターを使用してビルド システムを実行します:

  • (32ビット)
[email protected]:~/godot$ scons platform=x11 tools=no target=release bits=32
[email protected]:~/godot$ scons platform=x11 tools=no target=release_debug bits=32
  • (64ビット)
[email protected]:~/godot$ scons platform=x11 tools=no target=release bits=64
[email protected]:~/godot$ scons platform=x11 tools=no target=release_debug bits=64

注意点として、現在のホスト プラットフォームの反対のビット(64/32)へのクロスコンパイルは、簡単にいくとは限らず、chroot環境が必要になるかもしれません。

標準のエクスポート テンプレートを作成するには、結果のファイルを次の場所にコピーする必要があります:

$HOME/.local/share/godot/templates/[gd-version]/

そして、このように命名されます (Godotでは*BSD の場合も「Linux X11」と見なされます):

linux_x11_32_debug
linux_x11_32_release
linux_x11_64_debug
linux_x11_64_release

ただし、カスタムモジュールまたはカスタムC++ コードを作成する場合は、ここでカスタムエクスポート テンプレートとしてバイナリを構成する必要があります:

../../_images/lintemplates.png

この場合はコピーする必要はなく、Godotのソースフォルダ内にある bin\ ディレクトリに出力されたファイルを指定するだけです。こうすれば、次にビルドした時も、自動的にカスタム テンプレートを参照するようになります。

Using Clang and LLD for faster development

You can also use Clang and LLD to build Godot. This has two upsides compared to the default GCC + GNU ld setup:

  • LLD links Godot significantly faster compared to GNU ld or gold. This leads to faster iteration times.
  • Clang tends to give more useful error messages compared to GCC.

To do so, install Clang and the lld package from your distribution's package manager then use the following SCons command:

[email protected]:~/godot$ scons platform=x11 use_llvm=yes use_lld=yes

It's still recommended to use GCC for production builds as they can be compiled using link-time optimization, making the resulting binaries smaller and faster.