https://github.com/godotengine/build-containers

Godot engine build containers
https://github.com/godotengine/build-containers

Last synced: 6 days ago
JSON representation

Godot engine build containers

• Host: GitHub
• URL: https://github.com/godotengine/build-containers
• Owner: godotengine
• Created: 2019-01-07T20:47:11.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2024-08-21T16:03:50.000Z (4 months ago)
• Last Synced: 2024-12-08T21:09:14.707Z (13 days ago)
• Language: Shell
• Size: 77.3 MB
• Stars: 215
• Watchers: 15
• Forks: 69
• Open Issues: 17
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Godot engine build containers

This repository contains the Dockerfiles for the official Godot engine builds.

These containers should help you build Godot for all platforms supported on

any machine that can run Docker containers.

The in-container build scripts are in a separate repository:

https://github.com/godotengine/godot-build-scripts

## Introduction

These scripts build a number of containers which are then used to build final

Godot tools, templates and server packages for several platforms.

Once these containers are built, they can be used to compile different Godot

versions without the need of recreating them.

The `upload.sh` file is meant to be used by Godot Release Team and is not

documented here.

## Requirements

These containers have been tested under Fedora 36 (other distros/releases may work too).

The tool used to build and manage the containers is `podman` (install it with `dnf -y podman`).

We currently use `podman` as root to build and use these containers. Documenting a workflow to

configure the host OS to be able to do all this without root would be welcome (but back when we

tried we ran into performance issues).

## Usage

The `build.sh` script included is used to build the containers themselves.

The two arguments can take any value and are meant to convey what Godot branch

you are building for (e.g. `4.3`) and what Linux distribution the `Dockerfile.base`

is based on (e.g. `f40` for Fedora 40).

Run the command using:

    ./build.sh 4.3 f40

The above will generate images using the tag '4.3-f40'.

You can then specify it in the `build.sh` of

[godot-build-scripts](https://github.com/godotengine/godot-build-scripts).

### Selecting which images to build

If you don't need to build all versions or you want to try with a single target OS first,

you can comment out the corresponding lines from the script:

    podman_build linux

    podman_build windows

    podman_build web

    podman_build android

    ...

## Image sizes

These are the expected container image sizes, so you can plan your disk usage in advance:

    REPOSITORY                         TAG                SIZE

    localhost/godot-fedora             4.3-f40            1.01 GB

    localhost/godot-linux              4.3-f40            2.80 GB

    localhost/godot-windows            4.3-f40            2.46 GB

    localhost/godot-web                4.3-f40            2.41 GB

    localhost/godot-android            4.3-f40            4.29 GB

    localhost/godot-osx                4.3-f40            4.78 GB

    localhost/godot-ios                4.3-f40            5.49 GB

In addition to this, generating containers will also require some host disk space

(up to 10 GB) for the dependencies (Xcode).

## Toolchains

These are the toolchains currently in use for Godot 4.3 and later:

- Base image: Fedora 40

- SCons: 4.8.0

- Linux: GCC 13.2.0 built against glibc 2.28, binutils 2.40, from our own [Linux SDK](https://github.com/godotengine/buildroot)

- Windows:

  * x86_64/x86_32: MinGW 11.0.1, GCC 14.1.1, binutils 2.41

  * arm64: llvm-mingw 20240619, LLVM 18.1.8

- Web: Emscripten 3.1.64

- Android: Android NDK 23.2.8568313, build-tools 34.0.0, platform android-34, CMake 3.22.1, JDK 17

- macOS: Xcode 15.4 with Apple Clang (LLVM 16.0.0), MacOSX SDK 14.5

- iOS: Xcode 15.4 with Apple Clang (LLVM 16.0.0), iPhoneOS SDK 17.5