https://github.com/xuuhaoo/android-defensecrash
Android runtime crash controller. defense java crash keep your application safety
https://github.com/xuuhaoo/android-defensecrash
android android-exceptions androidcrash cglib crash-reporting exception-handling
Last synced: 11 days ago
JSON representation
Android runtime crash controller. defense java crash keep your application safety
- Host: GitHub
- URL: https://github.com/xuuhaoo/android-defensecrash
- Owner: xuuhaoo
- Created: 2020-12-08T09:33:09.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-10-18T03:46:07.000Z (over 3 years ago)
- Last Synced: 2025-04-15T11:13:15.415Z (11 days ago)
- Topics: android, android-exceptions, androidcrash, cglib, crash-reporting, exception-handling
- Language: Java
- Homepage:
- Size: 156 KB
- Stars: 128
- Watchers: 4
- Forks: 38
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Android Defense Crash
[](https://jitpack.io/#xuuhaoo/Android-DefenseCrash)
[]()
为了方便中国同学,提供了翻译文档如下:[中文文档](https://github.com/xuuhaoo/Android-DefenseCrash/blob/main/README_CN.md)
### What's this
This’s a `Crash Defense` library in Android to help you catch the `Java exceptions` which you don’t expected.
### Integration
* Step 1 Find the `build.gradle` file in your project and add the code into it as follow.
```groovy
allprojects {
repositories {
//other mavens
maven { url 'https://jitpack.io' }
}
}
```
* Step 2 Find the `build.gradle` file in the module that you want to integration
```groovy
dependencies {
implementation 'com.github.xuuhaoo:Android-DefenseCrash:last.version’
}
```
> Attentions: `last.version`is a substitute word, the real version will be found in [](https://github.com/xuuhaoo/Android-DefenseCrash/releases/latest)
### Use
* Initialize should be more earlier in application create, we suggest you put the init code in `Application` `attachBaseContext(base:Context)`
* Sample
```kotlin
override fun attachBaseContext(base: Context) {
super.attachBaseContext(base)
DefenseCrash.initialize(this)
...
}
```
* Install Defense library after initialize.
* Sample
```kotlin
override fun attachBaseContext(base: Context) {
super.attachBaseContext(base)
DefenseCrash.initialize(this)
DefenseCrash.install { thread, throwable, isSafeMode, isCrashInChoreographer ->
//thread: The crash happened’s thread.
//throwable: The Exception exactly is.
//isSafeMode: If application is allready crashed and we saved it that is mean you are in safe mode,
//that happens most of the time is your Main Looper is compromised by some errors and not going to normal,and we keep it runing that’s called safe mode.
//isCrashInChoreographer: If crash happend in OnMeasure/OnLayout/OnDraw it will case screen blank or some view not draw successfully
//If you got this true, we suggest you restart or finish the current Activity for good
//You can throw some throwables here and if you do that, will case VM got this throwable and shutdown your process.
//And you should do somting here such as:
Log.i("Exceptionhandler",
"thread:${thread.name} " +
"exception:${throwable.message} " +
"isCrashInChoreographer:$isCrashInChoreographer " +
"isSafeMode:$isSafeMode")
throwable.printStackTrace()
FirebaseCrashlytics.getInstance().recordException(throwable);
}
}
```
* Uninstall Defense library if you don’t need this.
* Sample
```kotlin
DefenseCrash.unInstall()
```