com.mapbox.android.core.crashreporter

Class MapboxUncaughtExceptionHanlder

java.lang.Object

com.mapbox.android.core.crashreporter.MapboxUncaughtExceptionHanlder

All Implemented Interfaces:

android.content.SharedPreferences.OnSharedPreferenceChangeListener, java.lang.Thread.UncaughtExceptionHandler

public class MapboxUncaughtExceptionHanlder
extends java.lang.Object
implements java.lang.Thread.UncaughtExceptionHandler, android.content.SharedPreferences.OnSharedPreferenceChangeListener

Mapbox custom exception handler, which catches unhandled fatal exceptions caused by Mapbox classes. This is an attempt to capture mapbox exceptions as reliably as possible with minimal false positives.

Note: this handler is not capturing full application's stacktrace!

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MAPBOX_CRASH_REPORTER_PREFERENCES
static java.lang.String	MAPBOX_PREF_ENABLE_CRASH_REPORTER

Method Summary

Modifier and Type	Method and Description
static void	install(android.content.Context context, java.lang.String mapboxPackage, java.lang.String version) Installs exception handler for Mapbox module/sdk
void	onSharedPreferenceChanged(android.content.SharedPreferences sharedPreferences, java.lang.String key)
void	uncaughtException(java.lang.Thread thread, java.lang.Throwable throwable)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAPBOX_PREF_ENABLE_CRASH_REPORTER

public static final java.lang.String MAPBOX_PREF_ENABLE_CRASH_REPORTER

See Also:

Constant Field Values

MAPBOX_CRASH_REPORTER_PREFERENCES

public static final java.lang.String MAPBOX_CRASH_REPORTER_PREFERENCES

See Also:

Constant Field Values

Method Detail

install

public static void install(@NonNull
                           android.content.Context context,
                           @NonNull
                           java.lang.String mapboxPackage,
                           @NonNull
                           java.lang.String version)

Installs exception handler for Mapbox module/sdk

Crash data will land in context.getFilesDir()/${mapboxPackage}/

Parameters:

context - application context.

mapboxPackage - mapbox package name exceptions to handle.

version - version of mapbox package

Note: Package name used to filter exceptions: i.e. `com.mapbox.android.telemetry` will catch all telemetry exceptions in the context of a single app process.

uncaughtException

public void uncaughtException(java.lang.Thread thread,
                              java.lang.Throwable throwable)

Specified by:

uncaughtException in interface java.lang.Thread.UncaughtExceptionHandler

onSharedPreferenceChanged

public void onSharedPreferenceChanged(android.content.SharedPreferences sharedPreferences,
                                      java.lang.String key)

Specified by:

onSharedPreferenceChanged in interface android.content.SharedPreferences.OnSharedPreferenceChangeListener