Getting Started

Setup

On Windows, there's a graphical installer. On Unix-like platforms such as Linux/macOS/WSL, there's pacman.

Windows

• If you already use msys2 then you can follow the instructions at https://github.com/devkitPro/pacman/releases/latest to add the devkitPro repositories.

Otherwise

• download the latest version of the graphical installer from github and run it, following the instructions as you go.
• An Internet connection is required.
• Once the installer has finished, launch MSYS from:
  • Windows 7 and earlier: Start -> All Programs -> devkitPro -> MSYS
  • Windows 8 and 8.1: Right click on the Start screen and select 'All Apps'. You should find MSYS there.
  • Windows 10 (pre-Anniversary Update): Start -> All Apps -> devkitPro -> MSYS
  • Windows 10 (post-Anniversary Update): Start -> devkitPro -> MSYS

Unix-like platforms

Note that Linux x86_64 binaries are usable under WSL.

• Follow the instructions to install pacman found at https://github.com/devkitPro/pacman/releases/latest
• run sudo (dkp-)pacman -S switch-dev to install the tools and libraries for switch development
• logout and login again to get the environment settings needed.

BuildScripts

Where possible you should stick to the binary distributions - building from source can be a path of frustration even for seasoned developers. Where a binary is not provided then you should use the most recent stable release of the https://github.com/devkitPro/buildscripts/releases/latest buildscripts]. The buildscripts in the git repositories should be avoided since the buildscripts found there will often contain the next iteration of a given toolchain rather than the current stable release and may only be usable by our developers. Using these scripts is a simple matter of extracting the archive, running ./build-devkit.sh from a bash shell and following the prompts. The scripts will also build and install the current support libraries from the release tarballs. The readme supplied with the buildscripts details some dependencies which need to be in place before starting a build.