A crash recovery framework!
“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.
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>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);
| 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
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);
}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>{SDCard Dir}/Android/data/{packageName}/files/recovery_crash/
VERSION-0.0.5——Support silent recoveryVERSION-0.0.6——Strengthen the protection of silent restore modeVERSION-0.0.7——Add confusion configurationVERSION-0.0.8——Add the skip Activity features,method:skip()VERSION-0.0.9——Update the UI and solve some problemsVERSION-0.1.0——Optimization of crash exception delivery, initial Recovery framework can be in any position, release the official version-0.1.0VERSION-0.1.3——Add 'no-op' supportVERSION-0.1.4——update default themeVERSION-0.1.5——fix 8.0+ hook bugVERSION-0.1.6——updateVERSION-1.0.0——Fix 8.0 compatibility issue
- Blog：https://zhengxiaoyong.com
- Wechat：
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.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent