Home

Awesome

Recovery

A crash recovery framework!


Download build License

中文文档

Introduction

Blog entry with introduction

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

Art

recovery

Usage

Installation

Using Gradle

    implementation 'com.zxy.android:recovery:1.0.0'

or

    debugImplementation 'com.zxy.android:recovery:1.0.0'
    releaseImplementation 'com.zxy.android:recovery-no-op:1.0.0'

Using Maven

<dependency>
  	<groupId>com.zxy.android</groupId>
  	<artifactId>recovery</artifactId>
  	<version>1.0.0</version>
  	<type>pom</type>
</dependency>

Initialization

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

        Recovery.getInstance()
                .debug(true)
                .recoverInBackground(false)
                .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)
                .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

ArgumentTypeFunction
debugbooleanWhether to open the debug mode
recoverInBackgroudbooleanWhen the App in the background, whether to restore the stack
recoverStackbooleanWhether to restore the activity stack, or to restore the top activity
mainPageClass<? extends Activity>Initial page activity
callbackRecoveryCallbackCrash info callback
silentboolean,SilentModeWhether 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

About

LICENSE

   Copyright 2016 zhengxiaoyong

   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.