docker run -it \
  --user "$(id -u):$(id -g)" \
  -v "$(pwd)":/opt/gba \
  devkitpro/devkitarm:20200730 \
  bash -c "cd /opt/gba && make rebuild"

⚠️ Deprecated ⚠️

Modern devkitARM versions don't work anymore since they generate bigger code and doesn't fit in IWRAM. Use the Docker build.

• Choose a folder (from now, GBA_DIR), and use this file structure:
  • gba
    • tools
      • devkitPro
    • projects
      • gba-remote-play
• Install the toolchain:
  • Dev
    • devkitPro: The devkit for compiling GBA roms
      • Use this version if you don't want build problems. It builds exactly the same file uploaded in the Releases section
    • make: The build automation tool
  • Other
    • Git Bash: Linux shell and tools
    • VSCode: The IDE
• Add to ~/.bash_profile:

export GBA_DIR="/c/Work/gba" # <<< CHANGE THIS PATH
export GBARP_OUT_DIR="//192.168.0.199/shared/gba-remote-play/raspi/out" # <<< CHANGE THIS PATH

export DEVKITPRO="$GBA_DIR/tools/devkitPro"
export PATH="$PATH:$GBA_DIR/tools/devkitPro/bin"
export PATH="$PATH:$GBA_DIR/tools/devkitPro/devkitARM/bin"
export PATH="$PATH:$GBA_DIR/tools/devkitPro/tools/bin"

• Recommended plugins: C/C++ Extensions, EditorConfig
• Recommended settings: here

Before compiling, you can comment/uncomment these build parameters in src/BuildConfig.h:

• make clean: Cleans build artifacts
• make build: Compiles and generates a .gba file
• make start: Starts the compiled ROM
• make rebuild: Recompiles (clean+build) a ROM
• make restart: Recompiles and copies the rom to GBARP_OUT_DIR