Skip to content

Latest commit

 

History

History
37 lines (27 loc) · 1.26 KB

README.md

File metadata and controls

37 lines (27 loc) · 1.26 KB
Raw

GBA Makefile Template

This repository provides a solid template Makefile for GBA development with devkitARM, supporting C, C++, and Assembly.

Note that this template requires GNU Make 4.3. Most systems should have it, however LTS Linux distros like Debian 10 or Ubuntu 20.04 might not. Check with make --version.

Usage

  • Modify the options inside Makefile to suit your needs, and run make.
  • To get verbose output, run make V=1 or make VERBOSE=1.
  • To run a clean build, run make -B

build.mk contains all of the build code, and you usually don't need to touch it at all.

Features

  • Soundbank creation with mmutil
  • Graphics processing with grit
  • Binary conversion with bin2s
  • Use of relative and symlinked file paths (e.g. ../etc/hi.c)
  • Creating a multiboot build by adding _mb suffix to project name
  • *.iwram.*, *.arm.*, and *.thumb.* filenames override ARM/THUMB code
  • Building with LTO
  • Building a static library
  • Specifying title, game code, etc. for gbafix
  • Running ROM in mGBA (by default) via make run. Custom runner via make RUNNER=... run
  • Automatic .gitignore creation in build directory

License

This repository is licensed under the CC0 1.0 Universal License.