Unity

Introduction
BugSplat's com.bugsplat.unity package provides crash and exception reporting for Unity projects. BugSplat provides you with invaluable insight into the issues tripping up your users. Our Unity integration collects screenshots, log files, exceptions, and Windows minidumps so that you can fix bugs and deliver a better user experience.
Before integrating your application with BugSplat, make sure to review the Getting Started resources and complete the simple startup tasks listed below.
​Sign up for a BugSplat account
​Log in using your email address
Create a new database for your application
Additionally, you can check out our my-unity-crasher sample that demonstrates how to use com.bugsplat.unity.
Need any further help? Check out the full BugSplat documentation here, or email the team at [email protected].
Installation
BugSplat's com.bugsplat.unity package can be added to your project via OpenUPM or a URL to our git repository.
OpenUPM
Information on how to install the OpenUPM package for node.js can be found here.
1
openupm add com.bugsplat.unity
Copied!
Git
Information on adding a Unity package via a git URL can be found here.
Usage
BugSplat's Unity integration is flexible and can be used in a variety of ways. The easiest way to get started is to create new script and attach it to a GameObject. In your script, add a using statement that aliases BugSplatUnity.BugSplat as BugSplat.
1
using BugSplat = BugSplatUnity.BugSplat;
Copied!
Next, create a new instance of BugSplat passing it your database, application, and version. Use Application.productName, and Application.version for application and version respectively.
1
var bugsplat = new BugSplat(database, Application.productName, Application.version);
Copied!
You can set the defaults for a variety of properties on the BugSplat instance. These default values will be used in exception and crash posts. Additionally, you can tell BugSplat to capture a screenshot, include the Player.log file, and include the Editor.log file when an exception is recorded.
1
bugsplat.Attachments.Add(new FileInfo("/path/to/attachment.txt"));
2
bugsplat.Description = "description!";
3
bugsplat.Email = "[email protected]";
4
bugsplat.Key = "key!";
5
bugsplat.User = "Fred";
6
bugsplat.CaptureEditorLog = true;
7
bugsplat.CapturePlayerLog = false;
8
bugsplat.CaptureScreenshots = true;
Copied!
You can send exceptions to BugSplat in a try/catch block by calling Post.
1
try
2
{
3
    throw new Exception("BugSplat rocks!");
4
}
5
catch (Exception ex)
6
{
7
    StartCoroutine(bugsplat.Post(ex));
8
}
Copied!
The default values specified on the instance of BugSplat can be overridden in the call to Post. Additionally, you can provide a callback to Post that will be invoked with the result once the upload is complete.
1
var options = new ReportPostOptions()
2
{
3
    Description = "a new description",
4
    Email = "[email protected]",
5
    Key = "a new key!",
6
    User = "Barney"
7
};
8
​
9
options.AdditionalAttachments.Add(new FileInfo("/path/to/additional.txt"));
10
​
11
static async void callback(HttpResponseMessage response)
12
{
13
    var status = response.StatusCode;
14
    var contents = await response.Content.ReadAsStringAsync();
15
    Debug.Log(quot;Response {status}: {contents}");
16
};
17
​
18
StartCoroutine(bugsplat.Post(ex, options, callback));
Copied!
You can also configure a global LogMessageRecieved callback. When the BugSplat instance recieves a logging event where the type is Exception it will upload the exception.
1
Application.logMessageReceived += bugsplat.LogMessageReceived;
Copied!
BugSplat can be configured to upload Windows minidumps created by the UnityCrashHandler. If your game contains Native Windows C++ plugins, .exe, .dll and .pdb files in the Assets/Plugins/x86 and Assets/Plugins/x86_64 folders they will be uploaded by BugSplat's PostBuild script and used in symbolication.
Each of the methods that post crashes to BugSplat also accept a MinidumpPostOptions parameter and a callback. The usage of MinidumpPostOptions and callback are nearly identically to the ExceptionPostOptions example listed above.
1
Utils.ForceCrash(ForcedCrashCategory.Abort);
2
Utils.ForceCrash(ForcedCrashCategory.AccessViolation);
3
Utils.ForceCrash(ForcedCrashCategory.FatalError);
4
Utils.ForceCrash(ForcedCrashCategory.PureVirtualFunction);
Copied!
Once you've posted an exception or a minidump to BugSplat click the link in the ID column on either the Dashboard or Crashes pages to see details about your crash.
Unity crash reports
WebGL
A few settings must be changed in order to capture function names and line numbers in a WebGL exception report. Open File > Build Settings and switch the platform to WebGL and check Development Build.
Unity Build Settings Menu
Click the button that says Player Settings, highlight the Player section. Under Publishing Settings, select Full With Stacktrace. 
Unity Player Publishing Settings
Please note that Unity does not recommend shipping development builds and thus this configuration is not recommended for applications in production.
Contributing
BugSplat ❤️ 's open source! If you feel that this integration can be improved, please open an Issue. If you have an awesome new feature you'd like to implement, we'd love to merge your Pull Request. You can also reach out to us via an email to [email protected] or the in-app chat on bugsplat.com.
Unreal Engine
Xbox
Last modified 19d ago
Copy link
Contents