CrashReporter
CrashReporter is a handy tool to capture app crashes and save them in a file.
Here is an article related to this library.
Why CrashReporter?
While developing features we get crashes and if device is not connected to logcat we miss the crash log. In worst case scenario we might not be able to reproduce the crash and endup wasting effort. This library captures all unhandled crashes and saves them locally on device. I found a problem with other libraries that they capture crashes and then uploads them to server and sometimes few crashes aren't logged to server. That's the purpose of this library use it as a debug feature to capture crashes locally and immediately.
Run the sample
Crash Reporter APIs
- Track all crashes
- Use Log Exception API to log Exception
- All crashes and exceptions are saved in device
- Choose your own path to save crash reports and exceptions
- Share Instantly crash log with your team with other device data.
Crash reporter doesn't takes any permission or root access
Using Crash Reporter Library in your application
add below dependency in your app's gradle
compile 'com.balsikandar.android:crashreporter:1.1.0'
If you only want to use Crash reporter in debug builds only add
debugCompile 'com.balsikandar.android:crashreporter:1.1.0'
Note : If you get error like this "no resource identifier found for attribute 'alpha' in package 'android'" use below dependency. This may happen due to two different versions of design support library as CrashReporter also uses design support library internally.
debugCompile('com.balsikandar.android:crashreporter:1.1.0') {
exclude group: 'com.android.support', module: 'design'
}
Crash Reporter On Duty
- It'll capture all unhandled crashes and write them to a file in below directory
/Android/data/your-app-package-name/files/crashReports
- To save crashes in a path of your choice, add below line in onCreate method of your Application class
CrashReporter.initialize(this, crashReporterPath);
Note: You don't need to call CrashReporter.initialize() if you want logs to be saved in default directory. If you want to use external storage then add storage permission in you manifest file.
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Using log Exception API
If you want to capture exceptions then you can use below API
for ex :
try {
// Do your stuff
} catch (Exception e) {
CrashReporter.logException(e);
}
Pass exception thrown in below method
logException(Exception exception)
To get default crash reports path
CrashUtil.getDefaultPath()
you can access all crash/exception log files from this path and upload them to server for your need. Remember it's default path if you provide your own path you know where to find the logs...
TODO
Context awareness to track crashes and fix them. Identify crashes and categorise them in groups
Find this project useful ? ❤️
- Support it by clicking the ⭐ button on the upper right of this page. ✌️
That's it for now
Contact - Let's connect and share knowledge
License
Copyright (C) 2016 Bal Sikandar
Copyright (C) 2011 Android Open Source Project
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.
Contributing to this Repo
Create a pull request and Dive In.