cat.ereza.customactivityoncrash

Class CustomActivityOnCrash

java.lang.Object

cat.ereza.customactivityoncrash.CustomActivityOnCrash

public final class CustomActivityOnCrash
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CustomActivityOnCrash.EventListener Interface to be called when events occur, so they can be reported by the app as, for example, Google Analytics events.

Constructor Summary

Constructors

Constructor and Description
CustomActivityOnCrash()

Method Summary

Modifier and Type	Method and Description
static void	closeApplication(android.app.Activity activity, CaocConfig config) Closes the app.
static java.lang.String	getActivityLogFromIntent(android.content.Intent intent) Given an Intent, returns the activity log extra from it.
static java.lang.String	getAllErrorDetailsFromIntent(android.content.Context context, android.content.Intent intent) Given an Intent, returns several error details including the stack trace extra from the intent.
static CaocConfig	getConfig() INTERNAL method that returns the current configuration of the library.
static CaocConfig	getConfigFromIntent(android.content.Intent intent) Given an Intent, returns the config extra from it.
static java.lang.String	getStackTraceFromIntent(android.content.Intent intent) Given an Intent, returns the stack trace extra from it.
static void	install(android.content.Context context) Installs CustomActivityOnCrash on the application using the default error activity.
static void	restartApplication(android.app.Activity activity, CaocConfig config)
static void	restartApplicationWithIntent(android.app.Activity activity, android.content.Intent intent, CaocConfig config) Given an Intent, restarts the app and launches a startActivity to that intent.
static void	setConfig(CaocConfig config) INTERNAL method that sets the configuration of the library.

Methods inherited from class java.lang.Object

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

Constructor Detail

CustomActivityOnCrash

public CustomActivityOnCrash()

Method Detail

install

public static void install(android.content.Context context)

Installs CustomActivityOnCrash on the application using the default error activity.

Parameters:

context - Context to use for obtaining the ApplicationContext. Must not be null.

getStackTraceFromIntent

public static java.lang.String getStackTraceFromIntent(android.content.Intent intent)

Given an Intent, returns the stack trace extra from it.

Parameters:

intent - The Intent. Must not be null.

Returns:

The stacktrace, or null if not provided.

getConfigFromIntent

public static CaocConfig getConfigFromIntent(android.content.Intent intent)

Given an Intent, returns the config extra from it.

Parameters:

intent - The Intent. Must not be null.

Returns:

The config, or null if not provided.

getActivityLogFromIntent

public static java.lang.String getActivityLogFromIntent(android.content.Intent intent)

Given an Intent, returns the activity log extra from it.

Parameters:

intent - The Intent. Must not be null.

Returns:

The activity log, or null if not provided.

getAllErrorDetailsFromIntent

public static java.lang.String getAllErrorDetailsFromIntent(android.content.Context context,
                                                            android.content.Intent intent)

Given an Intent, returns several error details including the stack trace extra from the intent.

Parameters:

context - A valid context. Must not be null.

intent - The Intent. Must not be null.

Returns:

The full error details.

restartApplicationWithIntent

public static void restartApplicationWithIntent(android.app.Activity activity,
                                                android.content.Intent intent,
                                                CaocConfig config)

Given an Intent, restarts the app and launches a startActivity to that intent. The flags NEW_TASK and CLEAR_TASK are set if the Intent does not have them, to ensure the app stack is fully cleared. If an event listener is provided, the restart app event is invoked. Must only be used from your error activity.

Parameters:

activity - The current error activity. Must not be null.

intent - The Intent. Must not be null.

config - The config object as obtained by calling getConfigFromIntent.

restartApplication

public static void restartApplication(android.app.Activity activity,
                                      CaocConfig config)

closeApplication

public static void closeApplication(android.app.Activity activity,
                                    CaocConfig config)

Closes the app. If an event listener is provided, the close app event is invoked. Must only be used from your error activity.

Parameters:

activity - The current error activity. Must not be null.

config - The config object as obtained by calling getConfigFromIntent.

getConfig

public static CaocConfig getConfig()

INTERNAL method that returns the current configuration of the library. If you want to check the config, use CaocConfig.Builder.get();

Returns:

the current configuration

setConfig

public static void setConfig(CaocConfig config)

INTERNAL method that sets the configuration of the library. You must not use this, use CaocConfig.Builder.apply()

Parameters:

config - the configuration to use