_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us [**Check out our open positions**](https://sentry.io/careers/)_ Sentry (lite) SDK for Unity =========== > This is the stable Sentry SDK for Unity. It's running in production in many games and sends millions of events every month to [sentry.io](https://github.com/getsentry/sentry-unity-lite/raw/main/sentry.io). If you are used to other Sentry SDKs, you might find that the API here is smaller. This is by design, and this SDK is lightweight and compile with your game. It supports any platform that you can target with Unity. **Sentry is working on a complete SDK for Unity with features such as Release Health, Native Crash Reporting and Performance Monitoring. If you'd like to learn more check out [sentry-unity](https://github.com/getsentry/sentry-unity) or join us on Discord, #unity: [![Discord Chat](https://camo.githubusercontent.com/d01e676e4b21bbe94d9d286944290a5d1226b2f268630d77c5e06782bc8e5964/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3632313737383833313630323232313036343f6c6f676f3d646973636f7264266c6f676f436f6c6f723d66666666666626636f6c6f723d373338394438)](https://discord.gg/PXa5Apfe7K)** # We are currently not accepting PRs for new features on this repository. Bug fixes are most welcomed and we'll continue to support the code base for security and bug fixes. But any new development, [refer to Sentry Unity](https://github.com/getsentry/sentry-unity). ### Installation #### Through the package manager ![Install git package screenshot](https://github.com/getsentry/sentry-unity-lite/raw/main/Documentation~/install-git-package.png) Open the package manager, click the + icon, and add git url. ``` https://github.com/getsentry/sentry-unity-lite.git#1.0.3 ``` #### Through unitypackage The [Releases page](https://github.com/getsentry/sentry-unity-lite/releases) include a `.unitypackage` which you can simply drag and drop into your project. ### Usage In order to make Sentry work, you need to add `SentrySdk` component to any `GameObject` that is in the first loaded scene of the game. You can also add it programatically. There can only be one `SentrySdk` in your whole project. To add it programatically do: ```C# var sentry = gameObject.AddComponent(); sentry.Dsn = "__YOUR_DSN__"; // get it on sentry.io when you create a project, or on project settings. ``` The SDK needs to know which project within Sentry your errors should go to. That's defined via the DSN. DSN is the only obligatory parameter on `SentrySdk` object. This is enough to capture automatic traceback events from the game. They will be sent to your DSN and you can find them at [sentry.io](https://github.com/getsentry/sentry-unity-lite/raw/main/sentry.io) `SentrySdk` is the main component that you have to use in your own project. ### Example The package includes a Demo scene. `SentryTest` is a component that handles button presses to crash or fail assert. ### API The basic API is automatic collection of test failures, so it should mostly run headless. There are two important APIs that are worth considering. * collecting breadcrumbs ```C# SentrySdk.AddBreadcrumb(string) ``` will collect a breadcrumb. * sending messages ```C# SentrySdk.CaptureMessage(string) ``` would send a message to Sentry. ### Unity version The lowest required version is Unity 5.6. Previous versions might work but were not tested and will not be supported. ### Native Crash Support Sentry is [working on a Unity SDK](https://github.com/getsentry/sentry-unity) based on the .NET SDK which includes offline caching and native crashes. Previews of that package are available. If you'd like to get involved in the SDK development, you can [join Sentry's Discord server and say hi on the `#unity` channel](https://discord.gg/UmjjsgRAFa). ## Resources * * * [![Discord Chat](https://camo.githubusercontent.com/d01e676e4b21bbe94d9d286944290a5d1226b2f268630d77c5e06782bc8e5964/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3632313737383833313630323232313036343f6c6f676f3d646973636f7264266c6f676f436f6c6f723d66666666666626636f6c6f723d373338394438)](https://discord.gg/PXa5Apfe7K) * * [![Twitter Follow](https://camo.githubusercontent.com/bb90a499ce79cf8b723c7f156c36c872b2297c491cf22137fa4cfa14ab1d3db1/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f67657473656e7472793f6c6162656c3d67657473656e747279267374796c653d736f6369616c)](https://twitter.com/intent/follow?screen_name=getsentry)