osama-raddad/firecrasher/install-firecrasher

Install FireCrasher

FireCrasher catches uncaught main-thread exceptions and recovers the app (restart the activity → go back → restart the app) instead of letting it die. It is distributed via JitPack.

Requirements

• minSdk 23 or higher.
• A toolchain that accepts Java 21 bytecode / Kotlin 2.1+ metadata (AGP 8.2+).

1. Add the JitPack repository

In settings.gradle (or the root build.gradle for older setups):

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

2. Add the dependency

In your app module's build.gradle:

dependencies {
    implementation 'com.github.osama-raddad:FireCrasher:3.0.0'
}

3. Install in your Application class

Installation must happen in Application.onCreate, before any activity is created — FireCrasher hooks the main looper and activity lifecycle there. A bare install already recovers automatically at the evaluated level:

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        installFireCrasher()
    }
}

To take over crash handling, configure onCrash (see the report-crashes and customize-recovery skills for reporting and custom UX):

installFireCrasher {
    onCrash {
        // `throwable`, `activity`, `level`, `retryCount` are in scope.
        recover()
    }
}

Register the Application in your manifest if it isn't already:

<application android:name=".App" ... />

Verify

Build and run, then throw from a screen (e.g. a button handler) to confirm the app recovers instead of closing:

button.setOnClickListener { throw RuntimeException("boom") }

Next

• report-crashes — forward the crash to your crash reporter.
• customize-recovery — show a loading/recovery UI based on the recovery level.
• detect-native-crashes-and-anrs — capture crashes the handler can't see.