A Framework for crash recovery and simple offline log sharing with no required Android permissions; Can be configured for all build types as well as debug builds only.

---

Introduction

“Recovery” can help you to automatically handle application crash in runtime. It provides you with following functionality:

• A way to share crash logs directly;
• Automatic recovery activity with stack and data;
• Ability to recover to the top activity;
• A way to view and save crash info;
• Ability to restart and clear the cache;
• Allows you to do a restart instead of recovering if failed twice in one minute.

Preview

Usage

Installation

Add JitPack repository to your root build.gradle:

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Using Gradle

If you want to use the recovery framework in debug and release variants, you can use the following:

    implementation 'com.github.alesimula.Recovery:recovery:1.0.7'

If you want to use the recovery framework only in debug variant, you can use the following:

    debugImplementation 'com.github.alesimula.Recovery:recovery:1.0.7'
    releaseImplementation 'com.github.alesimula.Recovery:recovery-no-op:1.0.7'

or, IF AND ONLY you wrap the code that follows inside if (BuildConfig.DEBUG) { [...] } (UNSAFE: relies on R8 optimizer to strip the code on release)

    debugImplementation 'com.github.alesimula.Recovery:recovery:1.0.7'
    releaseCompileOnly 'com.github.alesimula.Recovery:recovery-no-op:1.0.7'

Initialization

You can use this code sample to initialize Recovery in your application:

        Recovery.getInstance()
                .debug(true)
                .recoverInBackground(false)
                .showDevEmail("alesimula@murinelauncher.app", true) // call to show "SEND MAIL" button
                .recoverStack(true)
                .mainPage(MainActivity.class)
                .recoverEnabled(true)
                .callback(new MyCrashCallback())
                .silent(false, Recovery.SilentMode.RECOVER_ACTIVITY_STACK)
                .skip(TestActivity.class)
                .init(this);

If you don't want to show the RecoveryActivity when the application crash in runtime,you can use silence recover to restore your application.

You can use this code sample to initialize Recovery in your application:

        Recovery.getInstance()
                .debug(true)
                .recoverInBackground(false)
                .showDevEmail("alesimula@murinelauncher.app", true) // call to show "SEND MAIL" button
                .recoverStack(true)
                .mainPage(MainActivity.class)
                .recoverEnabled(true)
                .callback(new MyCrashCallback())
                .silent(true, Recovery.SilentMode.RECOVER_ACTIVITY_STACK)
                .skip(TestActivity.class)
                .init(this);

If you only need to display 'RecoveryActivity' page in development to obtain the debug data, and in the online version does not display, you can set up recoverEnabled(false);

Arguments

Argument	Type	Function
debug	boolean	Whether to open the debug mode
recoverInBackgroud	boolean	When the App in the background, whether to restore the stack
recoverStack	boolean	Whether to restore the activity stack, or to restore the top activity
mainPage	Class<? extends Activity>	Initial page activity
callback	RecoveryCallback	Crash info callback
silent	boolean,SilentMode	Whether to use silence recover，if true it will not display RecoveryActivity and restore the activity stack automatically

SilentMode

1. RESTART - Restart App
2. RECOVER_ACTIVITY_STACK - Restore the activity stack
3. RECOVER_TOP_ACTIVITY - Restore the top activity
4. RESTART_AND_CLEAR - Restart App and clear data

Callback

public interface RecoveryCallback {

    void stackTrace(String stackTrace);

    void cause(String cause);

    void exception(
    	String throwExceptionType,
    	String throwClassName,
    	String throwMethodName,
    	int throwLineNumber
    );
    
    void throwable(Throwable throwable);
}

Custom Theme

You can customize UI by setting these properties in your styles file:

    <color name="recovery_colorPrimary">#2E2E36</color>
    <color name="recovery_colorPrimaryDark">#2E2E36</color>
    <color name="recovery_colorAccent">#BDBDBD</color>
    <color name="recovery_background">#3C4350</color>
    <color name="recovery_textColor">#FFFFFF</color>
    <color name="recovery_textColor_sub">#C6C6C6</color>

Crash File Path

{SDCard Dir}/Android/data/{packageName}/files/recovery_crash/

---

Update history

• VERSION-0.0.5——Support silent recovery
• VERSION-0.0.6——Strengthen the protection of silent restore mode
• VERSION-0.0.7——Add confusion configuration
• VERSION-0.0.8——Add the skip Activity features,method:skip()
• VERSION-0.0.9——Update the UI and solve some problems
• VERSION-0.1.0——Optimization of crash exception delivery, initial Recovery framework can be in any position, release the official version-0.1.0
• VERSION-0.1.3——Add 'no-op' support
• VERSION-0.1.4——update default theme
• VERSION-0.1.5——fix 8.0+ hook bug
• VERSION-0.1.6——update
• VERSION-1.0.0——Fix 8.0 compatibility issue
• VERSION-1.0.1——Added share logs option and customized splash logo
• VERSION-1.0.2——Reduced library size (no legacy asset generation by increasing minSdk to 24)
• VERSION-1.0.3——Reduced library impact on apk significantly: removed appcompat dependencies and broad proguard rules
• VERSION-1.0.4——Change default language to English
• VERSION-1.0.5——Added send e-mail option
• VERSION-1.0.6——Added correct log timestamp + minimal device info and app version
• VERSION-1.0.7——Reduced resources size

LICENSE

   Copyright 2016 zhengxiaoyong
   Copyright 2026 alesimula

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.