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.7'
Using Maven
com.zxy.android
recovery
0.0.7
pom
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);
and grant permission:
android.permission.GET_TASKS
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)
.silent(false, Recovery.SilentMode.RECOVER_ACTIVITY_STACK)
.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
silent
boolean,SilentMode
Whether to use silence recover,if true it will not display RecoveryActivity and restore the activity stack automatically
SilentMode
RESTART - Restart App
RECOVER_ACTIVITY_STACK - Restore the activity stack
RECOVER_TOP_ACTIVITY - Restore the top activity
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
);
}
Custom Theme
You can customize UI by setting these properties in your styles file:
#F44336
#D32F2F
#BDBDBD
#FFFFFF
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
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.