JarCasting 
Crashlife is an awesome crash reporting SDK & web platform for Android apps. Here's how it works:
- Your app crashes and relaunches
- Crashlife sends the crash report to the Crashlife web dashboard
- There is no step 3.
You can also find Crashlife for iOS here
| Main Features | |
|---|---|
| |
Open source |
| 🏃🏽♀️ | Fast & lightweight |
| |
Custom attributes |
| |
Captured footprints and logs, with info / warning / error levels |
Installation
-
Add
crashlife-androidas a dependency to your app'sbuild.gradle.dependencies { implementation 'com.buglife.sdk:crashlife-android:1.0.5' } -
Create an
Applicationsubclass in your project if you don't already have one. (And don't forget to add it to your app'sAndroidManifest.xml.) -
Add the following lines to the end of the
onCreate()method in your app'sApplicationsubclass:Crashlife.initWithApiKey(this, "YOUR_API_KEY_HERE");
-
Build & run on a device; and crash your app (hopefully deliberately)!
-
On relaunch, your crash report will be submitted; then go to the Crashlife web dashboard.
Proguard
If using Proguard, you'll need to add the following to your `proguard-rules.
-keep class com.crashlife.** { *; }
-dontwarn com.crashlife.**
-keep class ru.ivanarh.** { *; }
Usage
Crash reporting
Once initialized, Crashlife will watch for both uncaught JVM exceptions, as well as C/C++ crashes from your native code. Crash reports will be saved to disk and sent on next launch. If the crash report can't be submitted for any reason, it will persist on disk until it can be sent at launch.
Additionally, Crashlife supports logging caught exceptions and error, warning, and info messages to the web dashboard as individual events.
Caught exception reporting
Crashlife can log caught exceptions will a full stack trace. From your catch block, call
Crashlife.logException(exception);
You can also pass a new (not yet-thrown) exception, however for performance reasons, it will not contain a stack trace. Crashlife will attempt to send the exception event immediately, and will cache it in case it is unable to do so.
Error/Warning/Info events
Crashlife supports logging messages of the severity of your choice: Crash, Error, Warning, and Info.
// Log an error
Crashlife.logError("An error occurred: ...");
// Log a warning
Crashlife.logWarning("Warning: doing something dangerous...");
// Log an informational message
Crashlife.logInfo("Note: something weird is going on...");
// Or you can use the parameterized method:
Crashlife.log(Event.Severity.CRASH, "Some other process we care about died.");
Footprints
In order to aid in reproducing crashes, you can include footprints indicating what code paths were followed in order to reach the crash or error. These footprints can include their own attributes to avoid cluttering up the custom attributes. These footprints will not be sent to the Crashlife web dashboard unless a report is made.
// Leave a footprint with no metadata
Crashlife.leaveFootprint("User navigated to screen 2");
// Leave a footprint with metadata
HashMap<String, String> attributes = new HashMap<>();
attributes.put("Developer", "You");
attributes.put("App", "Awesome");
Crashlife.leaveFootprint("User did something else", attributes);
Custom Attributes
Adding custom attributes
You can include custom attributes (i.e. key-value pairs) to your crash reports and logged events, as such:
Crashlife.putAttribute("Artist", "2Pac");
Crashlife.putAttribute("Song", "California Love");
Removing attributes
To clear an attribute, set its value to null.
Crashlife.putAttribute("Artist", null);
User Identification
You may set a string representing the user’s name, database ID or other identifier:
String username = ...; // the current username
Crashlife.setUserIdentifier(username);
License
Copyright (C) 2019 Buglife, Inc.
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.
