pokefirered/INSTALL.md
2019-04-07 18:41:51 +01:00

2.2 KiB

Prerequisites

Until further notice, this repository requires a baserom.gba file, which must be a legitimate copy of English Pokémon FireRed v1.0. See this article for help on how to verify the checksum.


Linux: Proceed to Installation.

macOS: Get the Xcode command-line tools.

Windows 10 (1709+): Get the Windows Subsystem for Linux.

Windows Vista, 7, 8, 8.1, and 10 (1507, 1511, 1607, 1703): Get Cygwin and include the make, git, gcc-core, gcc-g++, and libpng-devel packages. If you're on Windows 10 1607 or 1703 and use the prerelease version of the Linux subsystem, consider uninstalling it.

Installation

To set up the repository:

git clone https://github.com/pret/pokefirered
git clone https://github.com/luckytyphlosion/agbcc -b new_layout_with_libs

cd ./agbcc
make
make install prefix=../pokefirered
make install-sdk prefix=../pokefirered

cd ../pokefirered
./build_tools.sh

To build pokefirered.gba:

make -j$(nproc)

To confirm it matches the official ROM image while building, do this instead:

make compare -j$(nproc)

Note: If only .c or .s files were changed, 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 -j$(nproc) NODEP=1

Note 2: If the build command is not recognized on Linux, including the Linux environment used within Windows, run nproc and replace $(nproc) with the returned value (e.g.: make -j4). Because nproc is not available on macOS, the alternative is sysctl -n hw.ncpu.