UGBA template

1. Preparation

This is a template of how to integrate libugba and UMOD Player in your own project by adding them as submodules. Check UGBA Testing for examples of what the library can do.

You can add files to the data folder, graphics to the graphics folder, and music and SFX files to the audio folder. You'll need to adjust the asset conversion scripts accordingly.

Before building this template, check the libugba repository and install the dependencies that the readme mentions.

2. Build for host

Just run the following commands:

git clone --recurse-submodules https://github.com/AntonioND/ugba-template
cd ugba-template
bash assets.sh
mkdir build
cd build
cmake .. -DBUILD_GBA=OFF
make -j`nproc`

3. Build for GBA

This will fetch all the code and convert the assets,

git clone --recurse-submodules https://github.com/AntonioND/ugba-template
cd ugba-template
bash assets.sh

This will build the GBA and host targets at the same time with devkitPro:

mkdir build
cd build
cmake ..
make -j`nproc`

This will build the GBA and host targets at the same time without devkitPro:

mkdir build
cd build
cmake .. -DUSE_DEVKITARM=OFF
make -j`nproc`

To override the autodetected location of the cross compiler, you can add -DARM_GCC_PATH=/path/to/folder/ to the cmake command.