richiecr7 / firecrasher

FireCrasher is a Uncaught Exceptions handler library for android

FireCrasher

FireCrasher is designed to handle the Uncaught Exceptions on the android application and help recover from the Exception Without exiting from the application.

Requirements

Min SDK version 14

Install

Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

Step 2. Add the dependency

	dependencies {
	        implementation 'com.github.osama-raddad:FireCrasher:1.5.1'
	}

Usage

to use the library add this code to Application class :

public class app extends Application {
    @Override
    public void onCreate() {
        FireCrasher.install(this);
        super.onCreate();
    }
}

or you can use your logic, For example :

public class App extends Application {
    @Override
    public void onCreate() {
        FireCrasher.install(this, new CrashListener() {

            @Override
            public void onCrash(Throwable throwable, final Activity activity) {
            
                // show your own message
                Toast.makeText(activity, throwable.getMessage(), Toast.LENGTH_SHORT).show();

                // start the recovering process
                recover(activity);

                //you need to add your crash reporting tool here
                //Ex: Crashlytics.logException(throwable);
            }
        });
        super.onCreate();
    }
}

Contributing

We welcome contributions to FireCrasher!

• ⇄ Pull requests and ★ Stars are always welcome.

Version: 1.1

• add Java8 support
• fix some bugs

Version: 1.0

• fix some bugs
• add custom crash Listener

Let me know!

I’d be really happy if you sent me links to your projects where you use my library. Just send an email to [email protected] And do let me know if you have any questions or suggestion regarding the library.

License

Copyright 2016, Osama Raddad

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.