Getting started with ADT Unity SDK

Last updated on March 11, 2026

Overview​

ADT provides a comprehensive toolset that lets developers quickly capture and analyze game crashes while monitoring the performance of critical systems. This oversight ensures new features integrate smoothly without degrading overall game stability or performance. To capture and analyze crashes from your Unity game builds using the ADT Crash Reporter, follow the steps below to set up and configure the required tools.

Prerequisites​

Before integrating the Crash Reporter, ensure the following requirements are met:

  • Unity Version: Unity 2021.3.45f1 LTS or later
  • Build Target: Windows x64, Android ARM64-v8a, MacOS, iOS
  • ADT SDK: Download the latest version from the ADT Web Download page
  • ADT CLI: Installed and authenticated using your credentials
  • Set Rendering Backend to IL2CPP (Refer to the Unity Manual for setup instructions). This configuration is required because IL2CPP generates the GameAssembly.dll and GameAssembly.pdb files necessary for stack trace generation.
warning

Set the Graphics API to DirectX 11. Please note that DirectX 12 support is only available for projects using Unity 2023 or later.

Downloading the SDK​

  1. Navigate to the SDK section at the bottom of the ADT Web Download page and select the Unity tab.
  2. Click the Download button below the Windows icon.
note

The BlackBoxUnitySDK-x.x.x.unitypackage is a unified bundle supporting Windows, Android, MacOS, and iOS.

  1. The SDK will be downloaded as a file named: BlackBoxUnitySDK-x.x.x.unitypackage.
  2. Once the download is complete, import the package into your project by dragging the file into the Unity Editor or via Assets > Import Package > Custom Package.

Installing the ADT SDK​

  1. Launch your project in the Unity Editor using a supported version via Unity Hub.
  2. Navigate to Assets > Import Package > Custom Package.
  3. Locate and select the BlackBoxUnitySDK-x.x.x.unitypackage file previously downloaded.
  4. An installation wizard will appear prompting you to download BlackBox Helper and BlackBox Issue Reporter. These executables are essential for crash and issue reporting functionality. After downloading these components, you must restart the Unity Editor to initialize them
  5. Following the restart, a new Tools > BlackBox menu will be available in the top menu bar. Use this menu to access and configure the SDK settings.
Last updated on
On this page