Getting started with Nintendo Switch Development using devkitpro on macOS

Prerequsite: Ensure Xcode command line tools are installed

xcode-select --install

Install the devkitpro Package Manager

Download the latest devkitpro-pacman-installer.pkg from the GitHub releases page.

Install it with:

sudo installer -pkg /path/to/devkitpro-pacman-installer.pkg -target /

Install the libraries and tools for switch development

Install the switch-dev package group using dkp-pacman.

sudo dkp-pacman --noconfirm --sync switch-dev

Update your shell runtime configuration

Create ~/.bash_profile or edit it if you have one already and add the following envrionment variables:

export DEVKITPRO=/opt/devkitpro
export DEVKITARM="${DEVKITPRO}/devkitARM"
export DEVKITPPC="${DEVKITPRO}/devkitPPC"
export PATH="${DEVKITPRO}/tools/bin:${PATH}"

Source your updated ~/.bash_profile
```
source ~/.bash_profile
```

Your first build

Devkitpro comes with example code installed at ${DEVKITPRO}/examples. You can use this code to test your toolchain or as a boiler plate for your first project.

cp -r "${DEVKITPRO}/examples/switch/templates/application" /tmp/example
cd /tmp/example
make

You should now have a file in the current directory called example.nro.

Using NetLoader and nxlink to test your build

Launch the hbmenu using your favorite method. I'm partial to the RCMLoader myself.
Ensure that your Switch is connected to Wifi (not in Airplane mode) and press 'Y' to start NetLoader
In your build directory, run nxlink with the IP address shown on the NetLoader screen:
```
nxlink --address 192.168.1.10 example.nro
```
You should see your example code running.

joshenders/devkitpro_setup_macos.md