https://github.com/redthing1/dkarm_gba_docker

a docker image for building gba games with devkitarm
https://github.com/redthing1/dkarm_gba_docker

devkitarm docker gameboy-advance gba gba-development

Last synced: 2 months ago
JSON representation

a docker image for building gba games with devkitarm

• Host: GitHub
• URL: https://github.com/redthing1/dkarm_gba_docker
• Owner: redthing1
• Created: 2021-10-01T04:02:38.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-01-06T20:28:36.000Z (6 months ago)
• Last Synced: 2024-04-19T09:56:39.498Z (3 months ago)
• Topics: devkitarm, docker, gameboy-advance, gba, gba-development
• Language: Dockerfile
• Homepage:
• Size: 31.3 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Lists

• awesome-gbadev - dkarm_gba_docker - A Docker image that includes DevkitARM and other GBA SDK tools, packaged together to allow a consistent toolchain configuration and reproducibility in builds. Also can be helpful in ensuring a consistent build environment for continuous integration. (Testing / Other places)
• awesome-gba-dev-zh - dkarm_gba_docker

README

        

# 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)

```sh

make docker-build

```

### Dusk Devkit

```sh

make docker-build-dusk

```

## Usage

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

### Opening a Shell in Your Project

```sh

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](https://github.com/redthing1/duster) with the Dusk flavor:

```sh

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](https://github.com/JeffRuLz/Celeste-Classic-GBA) homebrew ROM:

```sh

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

```

### Varoom3D from Butano

To build [Varoom3D](https://github.com/GValiente/butano) with the Dusk flavor:

```sh

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"

```