DevkitARM GBA for Docker

This repository provides a Docker image for building GBA games with DevkitARM. It offers multiple flavors:

• Base Image: What most users typically need.
• Dusk Image: Enhanced with additional tools and utilities for a range of projects.

Included Packages

Base Devkit (default)

• Build tools: devkitarm, git, make, c, c++, wget, curl
• DevkitARM package: gba-dev

Dusk Addons (only in dusk flavor)

• Asset packers: crunch, Tiled2GBA
• Programming languages: Nelua, D

Building the Docker Image

You can build the Docker images using the provided Makefile targets:

Base Devkit (recommended)

make docker-build

Dusk Devkit

make docker-build-dusk

Usage

To open a shell inside the container with the current directory mounted:

Opening a Shell in Your Project

docker run -it --rm -v $(pwd):/source --user "$(id -u):$(id -g)" dkarm_base:local -l -c bash

Examples

Duster (with dusk flavor)

To build duster with the Dusk flavor:

docker run -it --rm -v $(pwd):/source dkarm_dusk:local -l -c "pushd . && git submodule update --init --recursive && cd src/DusterGBA && make clean && make build && popd"

Celeste classic

To build the Celeste Classic homebrew ROM:

docker run -it --rm -v $(pwd):/source --user "$(id -u):$(id -g)" dkarm_base:local -l -c "make"

Varoom3D from Butano

To build Varoom3D with the Dusk flavor:

docker run -it --rm -v $(pwd):/source --user "$(id -u):$(id -g)" -e LIBBUTANOABS=/source/butano dkarm_dusk:local -l -c "cd /source/games/varooom-3d/ && make -j2"