Forked from cuibonobo/nds_vscode_template
Develop Nintendo 3DS homebrew in the Visual Studio Code development environment.
Before this template will work, we need to install the compiler toolchian and the necessary extensions for the development environment.
devkitPro provides a set of compilers and tools so that we can create programs that are compatible with the ARM 9 and ARM 11 processors in the Nintendo 3DS.
Follow the instructions on the Getting Started page.
Install a copy of Visual Studio Code if you don't have it already, and also install the following extensions:
The C++ source code for your Nintendo 3DS program will go into the source directory.
The main.cpp file in this template is from the devkitpro\examples\3ds\templates\application\source\ directory that comes with devkitPro.
The include directory has a vscode_fix.h file that is used to fix IntelliSense behavior in Visual Studio Code. At the moment IntelliSense isn't smart enough to detect the feature flags that would be set by the compiler, so we add any interfaces that IntelliSense doesn't understand to this file.
For example, the main.cpp example code uses the iprintf function to print text to the screen. The iprintf function is defined in C:\devkitPro\devkitARM\arm-none-eabi\include\stdio.h, but it is protected by the __MISC_VISIBLE compiler feature. Since IntelliSense doesn't know what features our compiler has, we have to help it along by copying the interface from the stdio.h file and into vscode_fix.h.
The vscode_fix.h file is only used by IntelliSense and will not compile with your code!
The .vscode directory holds the settings that VS Code should use for the project. The c_cpp_properties.json file determines what directories IntelliSense searches in to find code for your project. The tasks.json file defines useful tasks like make and make clean so you don't have to switch to your terminal application to run them. The launch.json file defines the (gdb) Launch task for running the debugger.
Running the make build task will create an .3dsx file at the root of the project. You can run this file in the emulator by running the run task.