Recovery

A crash recovery framework!

Introduction

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

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.

Art

Usage

Installation

Using Gradle

compile 'com.zxy.android:recovery:0.0.3'

Using Maven

<dependency>
    <groupId>com.zxy.android</groupId>
    <artifactId>recovery</artifactId>
    <version>0.0.3</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)
        .callback(new MyCrashCallback())
        .init(this);

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

Callback

public interface RecoveryCallback {

    void stackTrace(String stackTrace);

    void cause(String cause);

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

Custom Theme

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

<color name="recoveryColorPrimary">#F44336</color>
<color name="recoveryColorPrimaryDark">#D32F2F</color>
<color name="recoveryColorAccent">#BDBDBD</color>
<color name="recoveryTextColor">#FFFFFF</color>

Crash File Path

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

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.