Mobile Application Performance Monitoring Guide - Read Now

Bug Reporting and In-App Chat for Unity Games

Take your app quality and stability to the next level with the Instabug SDK for Unity

Get Detailed Bug Reports for All Your Unity Apps

Let your users send bugs they experience by simply shaking their phone or swiping. Get comprehensive reports without interrupting their gaming experience. Don't waste time trying to reproduce a bug; spend your time fixing it!

Manual

Cocoapods

Carthage

Language:

1 - Download the SDK zip file and extract it to get the .framework file.

2 - Drag & drop Instabug.framework to your project's "Embedded Binaries" section under the    "General" tab, and make sure that the "Copy items if needed" checkbox is checked.

3 - Import the framework in the appDelegate.


import Instabug

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


Instabug.start(withToken:"YOUR_APP_TOKEN_HERE", invocationEvents: [.shake, .screenshot])

5 -If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your  app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

6 - Create a new "Run Script Phase" in your project’s target "Build Phases" and add the following snippet


bash
"${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Instabug.framework/Instabug.bundle/
strip-frameworks.sh"

1 - Download the SDK zip file and extract it to get the .xcframework file.

2 - Drag & drop Instabug.framework to your project's "Embedded Binaries" section under the "General" tab, and make sure that the "Copy items if needed" checkbox is checked.

3 - Import the framework in the appDelegate.


#import <Instabug/Instabug.h>

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


[Instabug startWithToken:@"YOUR_APP_TOKEN_HERE" invocationEvents: IBGInvocationEventShake | IBGInvocationEventScreenshot];

5 -If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your  app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

6 - Create a new "Run Script Phase" in your project’s target "Build Phases" and add the following snippet


bash 
"${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Instabug.framework/Instabug.bundle/
strip-frameworks.sh"

1 - Add the following line to your "Podfile":


pod 'Instabug' 

2 - Run pod install in your Xcode project directory. CocoaPods should download and install the SDK and all the required

3 - Import the framework in the appDelegate.


#import <Instabug/Instabug.h>

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


[Instabug startWithToken:@"YOUR_APP_TOKEN_HERE" invocationEvents: IBGInvocationEventShake | IBGInvocationEventScreenshot];

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

1 - Add the following line to your "Podfile":


pod 'Instabug' 

2 - Run pod install in your Xcode project directory. CocoaPods should download and install the SDK and all the required

3 - Import the framework in the appDelegate.


import Instabug

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


Instabug.start(withToken:"YOUR_APP_TOKEN_HERE", invocationEvents: [.shake, .screenshot])

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

1 - To integrate Instabug into your Xcode project using Carthage, add it to your Cartfile:


binary "https://raw.githubusercontent.com/Instabug/Instabug-iOS/master/Instabug.json"

2 - Run the following command:


$ carthage update

3 - Import the framework in the appDelegate


#import <Instabug/Instabug.h>

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


[Instabug startWithToken:@"YOUR_TOKEN_HERE" invocationEvents:IBGInvocationEventFloatingButton | IBGInvocationEventShake];

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

1 - To integrate Instabug into your Xcode project using Carthage, add it to your Cartfile:


binary "https://raw.githubusercontent.com/Instabug/Instabug-iOS/master/Instabug.json"

2 - Run the following command:


$ carthage update

3 - Import the framework in the appDelegate


import Instabug

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


Instabug.start(withToken:"YOUR_APP_TOKEN_HERE", invocationEvents: [.shake, .screenshot])

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

Simple Steps To Get Started

iOS Configuration

1- Add Instabug from the Unity Asset Store.

2- Add an empty GameObject to your project, and add the InstabugiOS script component to it.

3- Click on Add Component, search for InstabugiOS, and add it to the game object.

4- Add your app token, and change the invocation event from Unity's Inspector directly.

Android Configuration

1- Add Instabug from the Unity Asset Store.

2- Export your Unity project by opening Build Settings from “File → Build Settings”, and checking the Export button. Choose your desired path to save the project.

3- Open the exported project from Android Studio, and add the following changes to the build.gradle file.


...
	allprojects {
  	repositories {
  		jcenter()
  		google()
  		maven {
				if
				interested in getting SNAPSHOT releases
				url 'https://oss.sonatype.org/content/repositories/snapshots'
			}
			...
		}
	}
	...
	dependencies {
		...
		compile 'com.instabug.library:instabug:5.0.0.3.19-SNAPSHOT'
	}
...

4- Create a new Application.java class that should look like this. Add your app token, and change the invocation event from this class.


...
import android.app.Application;
import com.instabug.library.Instabug;
import com.instabug.library.invocation.InstabugInvocationEvent;

...
public class MyApp extends Application {
@Override
public void onCreate() { super.onCreate();
// You can change the invocation event to NONE, FLOATING_BUTTON, 
// SCREENSHOT_GESTURE, or TWO_FINGER_SWIPE_LEFT.
new Instabug.Builder(this, "YOUR_APP_TOKEN")
.setInvocationEvent(InstabugInvocationEvent.SHAKE)
.build(); Instabug.setUnityEnabled(true);
}}

5- Add the Application class name to the AndroidManifest.xml file.


<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...> ...
	<application android:name=".MyApp" ...> ...
	</application>
	...
</manifest>

You can also check out our API Reference for more detailed information about our SDK

Text Link

25,000 Innovative Mobile Teams Rely on Instabug

Himadri Sarkar

Himadri Sarkar

T-Mobile

“Customers love our product, and they show their love with a 4.8/5.0 rating for SyncUP KIDS in the app store. We really appreciate Instabug which provides a mechanism to build a communication channel with our customers and is an active ear for our customers' feedback.”

Justin Ing

Justin Ing

Loblaw

“Instabug has allowed us to really connect to our store colleagues. We have given them an easy and simple method to provide feedback to our support teams. It helped us diagnose, triage, and solve problems affecting our stores easier and faster. Our colleagues love it!"

Alex Ma

Alex Ma

Poparazzi

"I would highly recommend Instabug to anyone on the product development journey. Listening to feedback from users, and making sure you're building an app that works and that is high quality, is critical and crucial to finding product-market fit."

Kimberly Kalb

Houseparty

"I would highly recommend Instabug to anyone on the product development journey. Listening to feedback from users, and making sure you're building an app that works and that is high quality, is critical and crucial to finding product-market fit."

Wells Riley

Wells Riley

Envoy

"I've had plenty of apps break on me and I try to take a screenshot so that I can send it to support and I always get a little disappointed when I don’t see Instabug. Instabug has made it easier for Envoy’s customers to report problems.”

Jamie Scanlon

Jamie Scanlon

CommentSold

"Instabug not only gave us the ability to obtain accurate data about the health of the apps in the wild, it gave us the ability to address issues quickly and proactively."

Shelby Kozlowski

Shelby Kozlowski

Unigroup

“Instabug has helped us better understand our users' feedback and opened a communication channel with our users to accommodate features and functionally they're looking for more effectively.”

Mohammad Hariri

Mohammad Hariri

Verizon

"If you look at our crash rate over the last two to four years, the trend was down, we were making headway, but not as fast as we wanted to, and Instabug provided us the ability to make a major impact in a rather short time.”

partner logos
partner logos
partner logos
partner logos
partner logos

Frequently Asked Questions

Start Your 14-Day Free Trial for Realtime Contextual Insights

In less than a minute, integrate the Instabug SDK for iOS, Android, React Native, Xamarin, Cordova, Flutter, and Unity mobile apps