Add BugSnag to your Nintendo Switch games.
Nintendo Switch console integration is available on Enterprise plans. Contact us to learn more or add this feature to your Bugsnag account.
Bugsnag pulls Nintendo Switch crash information from Nintendo’s APIs. To configure this:
In a project of type Nintendo Switch, Unreal Engine or Cocos 2d-x, go to Project Settings -> Configure connection to Nintendo Switch -> Configure new connector -> Nintendo Switch.
In the “Configure Switch Connector” modal window, enter your Application ID and Crash Reporting Access Token. We recommend you contact Nintendo and request that this access token be prevented from expiring, to avoid you having to update it in Bugsnag periodically.
Choose whether this access token is for a Production or Development build of your game.
Choose or enter the “Release stage” you want these crashes to belong to.
New crashes will start appearing in Bugsnag on an hourly basis.
We recommend creating two Nintendo Switch Connectors: one for development builds and one for production builds.
The received crash reports will have no symbol information and therefore the stacktraces are not human-readable. To get readable stacktraces you need to upload the symbols file generated when building your game.
The symbols file can be uploaded to BugSnag using cURL:
$ curl --http1.1 \
"https://upload.bugsnag.com/nintendo-switch-symbol" \
-F symbolFile=@path/to/example.nss \
-F apiKey=YOUR_API_KEY_HERE
If you are using the BugSnag for Enterprise instance, you will need to configure the endpoint to upload.bugsnag.smartbear.com.
For more information, including documentation on all the parameters, see the Nintendo Switch symbol upload API docs.
As well as receiving native crashes for any Switch game, BugSnag has extra support for Unreal Engine Switch games.
When Unreal Engine Switch games crash, the framework adds some additional information to the crash report. BugSnag unpacks this information to give you Unreal Engine-specific metadata, as well as the Unreal Engine logs leading up to the crash.
To have this information included, you must define the WITH_SWITCH_CRASH_HANDLING macro in your game build:
#define WITH_SWITCH_CRASH_HANDLING 1
As there is no native Switch BugSnag library and hence no BugSnag code running in the game, the crash reports are not augmented with any additional BugSnag data. For this reason, Switch native crashes do not support breadcrumbs, custom metadata, feature flags or session and stability information.