Vitamin C

Android Crash Reporting Tools


The best complete wiki is available here in github.

Fabric - Crashlytics

Fabric is a modular mobile platform that provides useful kits you can mix to build your application. Crashlytics is a crash and issue reporting tool provided by Fabric that allows you to track and monitor your applications in detail.

How to Configure Fabric-Crashlytics

Step 1: Change your build.gradle:

Add the plugin repo and the gradle plugin:

 buildscript {
  repositories {
    maven { url '' }

  dependencies {
    // The Fabric Gradle plugin uses an open ended version to react
    // quickly to Android tooling updates
    classpath ''

Apply the plugin:

apply plugin: ''
//Put Fabric plugin after Android plugin
apply plugin: 'io.fabric'

Add the Fabric repo:

repositories {
  maven { url '' }

Add the Crashlyrics Kit:

dependencies {
  compile('[email protected]') {
    transitive = true;

Step 2: Add Your API Key and the INTERNET permission in AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="">
     ... >

  <uses-permission android:name="android.permission.INTERNET" />

Step 3: Init the Kit at runtime in you code, for example:

public class MainActivity extends ActionBarActivity {

    protected void onCreate(Bundle savedInstanceState) {

      //Init the KIT
      Fabric.with(this, new Crashlytics());


Step 4: Build project. To build and run:

enter image description here

Using the Fabric IDE plugin

Kits can be installed using the Fabric IDE plugin for Android Studio or IntelliJ following this link.

enter image description here

After installing the plugin, restart Android Studio and login with your account using Android Studio.

( short key > CTRL + L)

enter image description here

Then it will show the projects that you have / the project you opened, select the one you need and click next .. next.

Select the kit you would like to add, for his example it is Crashlytics :

enter image description here

Then hit Install. You don't need to add it manually this time like above gradle plugin, instead it will build for you.

enter image description here


Crash Reporting with ACRA

Step 1: Add the dependency of latest ACRA AAR to your application gradle(build.gradle).

Step 2: In your application class(the class which extends Application; if not create it) Add a @ReportsCrashes annotation and override the attachBaseContext() method.

Step 3: Initialize the ACRA class in your application class

    formUri = "Your choice of backend",
    reportType = REPORT_TYPES(JSON/FORM),
    httpMethod = HTTP_METHOD(POST/PUT),
    formUriBasicAuthLogin = "AUTH_USERNAME",
    formUriBasicAuthPassword = "AUTH_PASSWORD,
    customReportContent = {
    resToastText = R.string.crash_text_toast)

    public class MyApplication extends Application {
            protected void attachBaseContext(Context base) {
                // Initialization of ACRA

Where AUTH_USERNAME and AUTH_PASSWORD are the credentials of your desired backends.

Step 4: Define the Application class in AndroidManifest.xml


Step 5: Make sure you have internet permission to receive the report from crashed application

<uses-permission android:name="android.permission.INTERNET"/>

In case if you want to send the silent report to the backend then just use the below method to achieve it.


Force a Test Crash With Fabric

Add a button you can tap to trigger a crash. Paste this code into your layout where you’d like the button to appear.

    android:text="Force Crash!"
    android:layout_centerHorizontal="true" />

Throw a RuntimeException

public void forceCrash(View view) {
    throw new RuntimeException("This is a crash");

Run your app and tap the new button to cause a crash. In a minute or two you should be able to see the crash on your Crashlytics dashboard as well as you will get a mail.

Capture crashes using Sherlock

Sherlock captures all your crashes and reports them as a notification. When you tap on the notification, it opens up an activity with all the crash details along with Device and Application info

How to integrate Sherlock with your application?

You just need to add Sherlock as a gradle dependency in your project.

dependencies {
    compile('com.github.ajitsing:sherlock:[email protected]') {
        transitive = true

After syncing your android studio, initialize Sherlock in your Application class.

package com.singhajit.login;


import com.singhajit.sherlock.core.Sherlock;

public class SampleApp extends Application {
  public void onCreate() {

Thats all you need to do. Also Sherlock does much more than just reporting a crash. To checkout all its features take a look at this article.


enter image description here

Got any Android Question?