Before you enable your Unity project with BugSplat, you may want to
take a moment to
experiment with our
MyUnityCrasher sample application.
First, login to BugSplat with
the user name
email@example.com and password
All crash reports in the
firstname.lastname@example.org account are actual crashes created with our sample applications.
You can see some sample
MyUnityCrasher by navigating to the Crashes page.
To begin using
MyUnityCrasher download the BugSplat Unity SDK.
Once the SDK has been downloaded, right click the
BugSplatUnity.zip file and choose
Next, open Unity Hub and add the
MyUnityCrasher project by clicking
Add and selecting the
Once Unity has opened the
MyUnityCrasher project, open the
Main scene by double clicking it in the
File > Build Settings to open the build settings dialog.
Copy PDB files option is selected and click
Build and Run.
When prompted, select
BugSplatUnity/BugSplat/samples/MyUnityCrasher/bin as the output location.
Once the window for the game appears, hold
Shift and press the
m key to trigger a program crash.
The BugSplat dialog will be displayed and prompt you for input.
Send Error Report button at which point your internet browser will load a configurable support response.
Dismiss the support response and navigate to the Crashes page.
Crashes page you should see a new
MyUnityCrasher crash report.
Click the link in the
ID column to view details about the crash report.
Open Unity Hub and start a New Project.
You can name this project whatever you would like.
For this example, our project is named
Once in Unity, go to Asset and select
Custom Package under
Package. Once there
open the BugSplatUnity.unitypackage file previously downloaded. This will place BugSplat into your Assets
folder. Double-clicking the package will have the same effect.
Once it is in your asset folder, navigate to and select the folder
bugsplat > report > scene. This will bring
up the debug scene, which you will double-click on.
Double-clicking will bring up the debug scene. Run this scene by hitting the run scene button (play button) at the top middle of the Unity window.
Once you do this, you will see in the Game Panel the scene UI showing three buttons. Any of these options will post a test crash, but for this example we will use the Prompted Exception button.
By clicking that button, you will post the crash to the test database email@example.com. To view it, navigate to the Crashes page.
To send a crash to a different database, set the database property on the Reporter object. Similarly, you can also set the app and version properties on the Reporter object to set the application name and version number respectively