Nintendo 3DS Compilation / Development Guide¶
You need the homebrew Nintendo 3DS SDK libctru and DevkitARM toolchain installed.
If you are running windows you will need to install MSYS2 and point it to your devkitARM installation like this:
1 2 3 4 5 6
The custom bannertool is needed if you want to compile .cia builds due to a broken wav encoder in the windows version of bannertool included with RetroArch.
Before building RetroArch you will have to load MSYS2 and launch
RetroArch3DSEnv.sh, then proceed as you would for linux.
The working bannertool can be compiled from the sources here using MSYS2.
Clone RetroArch's repository from GitHub
For subsequent builds you only need to pull the changes from the repo
To update your local copy from the repository run git pull
Building RetroArch separately¶
First, you need to compile Salamander. To compile Salamander (for 3DS) run:
Second, to compile RetroArch (for 3DS) run:
RetroArch on 3DS is statically linked. With statically linked RetroArch, each executable is a separate libretro core instead of the core being separately loaded from a single executable. A pre-existing libretro library needs to be present in the root directory in order to link RetroArch 3DS. This file needs to be called 'libretro_ctr.a'.
After a few seconds/minutes you should be able to find a retroarch_ctr.elf and retroarch_ctr.dol file under that directory.
Building RetroArch in bulk¶
Instead of building each core one by one, you can build all cores as a batch task. Run from the main 'retroarch' directory:
Make sure that all the libretro cores that you want to compile are inside the 'dist-scripts' directory.
Once inside this directory, run :
This process will also automate the packaging process for you.
The easiest way to fetch all the cores is to use libretro-super. Run
The easiest way to build all the cores (for 3DS) is to use libretro-super. Run
In case you only want to build one and/or more cores instead of all, you can specify the cores you want to build after the first command in no particular order. E.g.:
Once finished, you can find the libretro cores inside directory