Linux | macOS | Windows 10 (build 18917+) | Windows 10 (1709+) | Windows Vista, 7, 8, 8.1, and 10 (1507, 1511, 1607, and 1703) |
---|---|---|---|---|
none | Xcode Command Line Tools package | Windows Subsystem for Linux 2 | Windows Subsystem for Linux | MSYS2 (see below) |
The prerelease version of the Linux subsystem available in the 1607 and 1703 releases of Windows 10 is obsolete so consider uninstalling it.
Make sure that the build-essential
, git
, and libpng-dev
packages are installed. The build-essential
package includes the make
, gcc-core
, and g++
packages so they do not have to be obtained separately. MSYS2 does not include libpng-dev
so it must be built from source.
Install the devkitARM toolchain of devkitPro and add its environment variables. For Windows versions without the Linux subsystem, the devkitPro graphical installer includes a preconfigured MSYS2 environment, thus the steps below are not required.
export DEVKITPRO=/opt/devkitpro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
As an alternative to installing devkitARM, for Linux users only, install the GNU Arm Embedded Toolchain. For Debian/Ubuntu-based distributions, this can be accomplished with sudo apt install gcc-arm-none-eabi binutils-arm-none-eabi
. For Arch Linux, this can be accomplished with pacman -S arm-none-eabi-gcc arm-none-eabi-binutils
.
To set up the repository:
git clone https://github.com/pret/pokepinballrs
git clone https://github.com/pret/agbcc
cd ./agbcc
./build.sh
./install.sh ../pokepinballrs
cd ../pokepinballrs
make tools
Place a copy of the original ROM in the pokepinballrs
directory, and name it baserom.gba
. This is necessary because this is an incomplete disassembly.
To build pokepinballrs.gba and confirm it matches the official ROM image:
make compare
-
If the base tools are not found on macOS in new Terminal sessions after the first successful build, run
echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile
once to prevent the issue from occurring again. Verify that thedevkitarm-rules
package is installed as well; if not, install it by runningsudo dkp-pacman -S devkitarm-rules
. -
If the repository was previously set up using Cygwin, delete the
.exe
files in the subfolders of thetools
folder except foragbcc
and try building again. Learn the differences between MSYS2 and Cygwin.
After the first build, subsequent builds are faster. You can further speed up the build:
This significantly speeds up the build on modern machines.
By default make
only runs a single thread. You can tell make
to run on multiple threads with make -j
. See the manfile for usage (man make
).
The optimal value for -j
is the number of logical cores on your machine. You can run nproc
to see the exact number.
$ nproc
8
If you have 8 cores, run: make -j8
-j
on its own will spawn a new thread for each job. A clean build will have thousands of jobs, which will be slower than not using -j at all.
If you've only changed .c
or .s
files, you can turn off the dependency scanning temporarily. Changes to any other files will be ignored, and the build will either fail or not reflect those changes.
make NODEP=1