org.acra
Enum ReportField

java.lang.Object
  java.lang.Enum<ReportField>
      org.acra.ReportField

All Implemented Interfaces:

Serializable, Comparable<ReportField>

public enum ReportField
extends Enum<ReportField>

Specifies all the different fields available in a crash report.

Author:

Normal

Enum Constant Summary

ANDROID_VERSION
Device android version name.

APP_VERSION_CODE
Application version code.

APP_VERSION_NAME
Application version name.

APPLICATION_LOG
Content of your own application log file.

AVAILABLE_MEM_SIZE
Estimation of the available device memory size based on filesystem stats.

BRAND
Device brand (manufacturer or carrier).

BUILD
Android Build details.

CRASH_CONFIGURATION
Configuration fields state on the application crash.

CUSTOM_DATA
Contains key = value pairs defined by the application developer during the application execution.

DEVICE_FEATURES
Features declared as available on this device by the system.

DEVICE_ID
Device unique ID (IMEI).

DISPLAY
Device display specifications.

DROPBOX
Content of the android.os.DropBoxManager (introduced in API level 8).

DUMPSYS_MEMINFO
Memory state details for the application process.

ENVIRONMENT
External storage state and standard directories.

EVENTSLOG
Logcat eventslog extract.

FILE_PATH
Base path of the application's private file folder.

INITIAL_CONFIGURATION
Configuration fields state on the application start.

INSTALLATION_ID
Installation unique ID.

IS_SILENT
True if the report has been explicitly sent silently by the developer.

LOGCAT
Logcat default extract.

MEDIA_CODEC_LIST
Since Android API Level 16 (Android 4.1 - Jelly Beans), retrieve the list of supported Media codecs and their capabilities (color format, profile and level).

PACKAGE_NAME
Application package name.

PHONE_MODEL
Device model name.

PRODUCT
Device overall product code.

RADIOLOG
Logcat radio extract.

REPORT_ID
Report Identifier

SETTINGS_GLOBAL
Global settings, introduced in Android 4.2 (API level 17) to centralize settings for multiple users.

SETTINGS_SECURE
Secure settings (applications can't modify them).

SETTINGS_SYSTEM
System settings.

SHARED_PREFERENCES
SharedPreferences contents

STACK_TRACE
The Holy Stack Trace.

THREAD_DETAILS
Retrieves details of the failing thread (id, name, group name).

TOTAL_MEM_SIZE
Estimation of the total device memory size based on filesystem stats.

USER_APP_START_DATE
User date on application start.

USER_COMMENT
Comment added by the user in the CrashReportDialog displayed in ReportingInteractionMode.NOTIFICATION mode.

USER_CRASH_DATE
User date immediately after the crash occurred.

USER_EMAIL
User email address.

USER_IP
Retrieves the user IP address(es).

Method Summary

boolean	containsKeyValuePairs() Whether this field is a collection of key/value pairs.
static ReportField	valueOf(String name) Returns the enum constant of this type with the specified name.
static ReportField[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

REPORT_ID

public static final ReportField REPORT_ID

Report Identifier

APP_VERSION_CODE

public static final ReportField APP_VERSION_CODE

Application version code. This is the incremental integer version code used to differentiate versions on the android market.

See Also:

PackageInfo.versionCode

APP_VERSION_NAME

public static final ReportField APP_VERSION_NAME

Application version name.

See Also:

PackageInfo.versionName

PACKAGE_NAME

public static final ReportField PACKAGE_NAME

Application package name.

See Also:

Context.getPackageName()

FILE_PATH

public static final ReportField FILE_PATH

Base path of the application's private file folder.

See Also:

Context.getFilesDir()

PHONE_MODEL

public static final ReportField PHONE_MODEL

Device model name.

See Also:

Build.MODEL

ANDROID_VERSION

public static final ReportField ANDROID_VERSION

Device android version name.

See Also:

Build.VERSION.RELEASE

BUILD

public static final ReportField BUILD

Android Build details.

See Also:

Build

BRAND

public static final ReportField BRAND

Device brand (manufacturer or carrier).

See Also:

Build.BRAND

PRODUCT

public static final ReportField PRODUCT

Device overall product code.

See Also:

Build.PRODUCT

TOTAL_MEM_SIZE

public static final ReportField TOTAL_MEM_SIZE

Estimation of the total device memory size based on filesystem stats.

AVAILABLE_MEM_SIZE

public static final ReportField AVAILABLE_MEM_SIZE

Estimation of the available device memory size based on filesystem stats.

CUSTOM_DATA

public static final ReportField CUSTOM_DATA

Contains key = value pairs defined by the application developer during the application execution.

STACK_TRACE

public static final ReportField STACK_TRACE

The Holy Stack Trace.

INITIAL_CONFIGURATION

public static final ReportField INITIAL_CONFIGURATION

Configuration fields state on the application start.

See Also:

Configuration

CRASH_CONFIGURATION

public static final ReportField CRASH_CONFIGURATION

Configuration fields state on the application crash.

See Also:

Configuration

DISPLAY

public static final ReportField DISPLAY

Device display specifications.

See Also:

WindowManager.getDefaultDisplay()

USER_COMMENT

public static final ReportField USER_COMMENT

Comment added by the user in the CrashReportDialog displayed in ReportingInteractionMode.NOTIFICATION mode.

USER_APP_START_DATE

public static final ReportField USER_APP_START_DATE

User date on application start.

USER_CRASH_DATE

public static final ReportField USER_CRASH_DATE

User date immediately after the crash occurred.

DUMPSYS_MEMINFO

public static final ReportField DUMPSYS_MEMINFO

Memory state details for the application process.

DROPBOX

public static final ReportField DROPBOX

Content of the android.os.DropBoxManager (introduced in API level 8). Requires READ_LOGS permission.

LOGCAT

public static final ReportField LOGCAT

Logcat default extract. Requires READ_LOGS permission.

EVENTSLOG

public static final ReportField EVENTSLOG

Logcat eventslog extract. Requires READ_LOGS permission.

RADIOLOG

public static final ReportField RADIOLOG

Logcat radio extract. Requires READ_LOGS permission.

IS_SILENT

public static final ReportField IS_SILENT

True if the report has been explicitly sent silently by the developer.

DEVICE_ID

public static final ReportField DEVICE_ID

Device unique ID (IMEI). Requires READ_PHONE_STATE permission.

INSTALLATION_ID

public static final ReportField INSTALLATION_ID

Installation unique ID. This identifier allow you to track a specific user application installation without using any personal data.

USER_EMAIL

public static final ReportField USER_EMAIL

User email address. Can be provided by the user in the ACRA.PREF_USER_EMAIL_ADDRESS SharedPreference.

DEVICE_FEATURES

public static final ReportField DEVICE_FEATURES

Features declared as available on this device by the system.

ENVIRONMENT

public static final ReportField ENVIRONMENT

External storage state and standard directories.

SETTINGS_SYSTEM

public static final ReportField SETTINGS_SYSTEM

System settings.

SETTINGS_SECURE

public static final ReportField SETTINGS_SECURE

Secure settings (applications can't modify them).

SETTINGS_GLOBAL

public static final ReportField SETTINGS_GLOBAL

Global settings, introduced in Android 4.2 (API level 17) to centralize settings for multiple users.

SHARED_PREFERENCES

public static final ReportField SHARED_PREFERENCES

SharedPreferences contents

APPLICATION_LOG

public static final ReportField APPLICATION_LOG

Content of your own application log file. To be configured with ReportsCrashes.applicationLogFile() to define the path/name of the log file and ReportsCrashes.applicationLogFileLines() to set the number of lines you want to be retrieved.

MEDIA_CODEC_LIST

public static final ReportField MEDIA_CODEC_LIST

Since Android API Level 16 (Android 4.1 - Jelly Beans), retrieve the list of supported Media codecs and their capabilities (color format, profile and level).

THREAD_DETAILS

public static final ReportField THREAD_DETAILS

Retrieves details of the failing thread (id, name, group name).

USER_IP

public static final ReportField USER_IP

Retrieves the user IP address(es).

Method Detail

values

public static ReportField[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ReportField c : ReportField.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ReportField valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

containsKeyValuePairs

public boolean containsKeyValuePairs()

Whether this field is a collection of key/value pairs.

Returns:

true if the field contains a string with a key/value pair on each line, key and value separated by an equal sugn