diff --git a/web/static/javadoc/5.11.3/acra/org.acra.annotation/-acra-dsl/index.html b/web/static/javadoc/5.11.3/acra/org.acra.annotation/-acra-dsl/index.html new file mode 100644 index 0000000000..90bd484cf9 --- /dev/null +++ b/web/static/javadoc/5.11.3/acra/org.acra.annotation/-acra-dsl/index.html @@ -0,0 +1,84 @@ + + +
+ +Get an uri for this content provider for the given file
the uri
a context
the file
Get an uri for this content provider for the given file
the uri
a context
the directory, to with the path is relative
the file path
Tries to guess the mime type from uri extension
the mime type of the uri, with fallback .MIME_TYPE_OCTET_STREAM
the uri
Provides access to attachments for senders For uri schema, see AcraCore.attachmentUris
F43nd1r
13.03.2017
Open a file for read
ignored
ignored
Open a file for read
a ParcelFileDescriptor for the File
the file uri
ignored
if the file cannot be resolved
Provides file metadata
file metadata in a cursor with a single row
the file uri
any combination of OpenableColumns.DISPLAY_NAME and OpenableColumns.SIZE
ignored
ignored
ignored
all file uris that should be attached to the report
a context
ACRA configuration
Provides attachment uris to ACRA
F43nd1r
09.03.2017
{@inheritDoc}
Provides access to attachments for senders For uri schema, see AcraCore.attachmentUris
Provides attachment uris to ACRA
Reads attachment uris from the configuration
clear saved activities
Responsible for tracking the last Activity that was created.
4.8.0
a list of activities in the current process
last created activity, if any
wait until the last activity is stopped
timeout for wait
Assembles and sends the crash report.
ReportExecutor to use to build the report.
Sets additional values to be added to org.acra.ReportField.CUSTOM_DATA. Values specified here take precedence over globally specified custom data.
the updated ReportBuilder
a map of custom key-values to be attached to the report
Sets an additional value to be added to org.acra.ReportField.CUSTOM_DATA. The value specified here takes precedence over globally specified custom data.
the updated ReportBuilder
the key identifying the custom data
the value for the custom data entry
Ends the application after sending the crash report
the updated ReportBuilder
Set the stack trace to be reported
the updated ReportBuilder
The exception that should be associated with this report
the exception, or null if none present
a map with all custom data
Fluent API used to assemble the different options used for a crash report.
4.8.0
Assembles and sends the crash report.
Sets additional values to be added to org.acra.ReportField.CUSTOM_DATA. Values specified here take precedence over globally specified custom data.
Sets an additional value to be added to org.acra.ReportField.CUSTOM_DATA. The value specified here takes precedence over globally specified custom data.
Ends the application after sending the crash report
Set the stack trace to be reported
Set the error message to be reported.
Forces the report to be sent silently, ignoring all interactions
Sets the Thread on which an uncaught Exception occurred.
if this should stop the application after collecting
if this should send silently
Set the error message to be reported.
the updated ReportBuilder
the error message
the error message, or null if none is present
Forces the report to be sent silently, ignoring all interactions
the updated ReportBuilder
Sets the Thread on which an uncaught Exception occurred.
the updated ReportBuilder
Thread on which an uncaught Exception occurred.
the Thread on which an uncaught Exception occurred, or null if none present
Try to create a report. Also starts LegacySenderService
The report builder used to assemble the report
pass-through to default handler
the crashed thread
the uncaught exception
Collates, records and initiates the sending of a report.
4.8.0
Responsible for tracking the last Activity that was created.
Fluent API used to assemble the different options used for a crash report.
Collates, records and initiates the sending of a report.
A stack which keeps only weak references
F43nd1r
5.3.0
collect startup data
a context
the config
A collector that is also called at startup
F43nd1r
29.09.2017
Execute collection
collect startup data
controls if this instance is active
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Base implementation of a collector. Maintains information on which fields can be collected by this collector. Validates constraints in which a field should (not) be collected.
F43nd1r
4.9.1
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
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.)
Returns an array containing the constants of this enum type, in the order they're declared.
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.)
if this enum type has no constant with the specified name
Returns an array containing the constants of this enum type, in the order they're declared.
This method may be used to iterate over the constants.
Execute collection
a context
current Configuration
current ReportBuilder
put results here
if collection failed
F43nd1r
29.09.2017
Execute collection
controls if this instance is active
when this collector should be called compared to other collectors
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
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.)
Returns an array containing the constants of this enum type, in the order they're declared.
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.)
if this enum type has no constant with the specified name
Returns an array containing the constants of this enum type, in the order they're declared.
This method may be used to iterate over the constants.
collect startup data
a context
the config
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Inspects a Configuration object through reflection API in order to generate a human readable String with values replaced with their constants names. The Configuration.toString method was not enough as values like 0, 1, 2 or 3 aren't readable. Using reflection API allows to retrieve hidden fields and can make us hope to be compatible with all Android API levels, even those which are not published yet.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
collect startup data
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects custom data supplied by the user
F43nd1r
4.9.1
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects features declared as available on the device.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects the device ID
F43nd1r
4.9.1
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects information about the connected display(s)
F43nd1r & Various
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects data from the DropBoxManager. A set of DropBox tags have been identified in the Android source code. We collect data associated to these tags with hope that some of them could help debugging applications. Application specific tags can be provided by the app dev to track his own usage of the DropBoxManager.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
when this collector should be called compared to other collectors
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Executes logcat commands and collects it's output.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
when this collector should be called compared to other collectors
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects the N last lines of a text stream. Use this collector if your application handles its own logging system.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
when this collector should be called compared to other collectors
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects data about available codecs on the device through the MediaCodecList API introduced in Android 4.1 JellyBean.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
when this collector should be called compared to other collectors
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects results of the dumpsys
command.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collector retrieving key/value pairs from static fields and getters. Reflection API usage allows to retrieve data without having to implement a class for each android version of each interesting class. It can also help find hidden properties.
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects the content (key/value pairs) of SharedPreferences, from the application default preferences or any other preferences asked by the application developer.
F43nd1r & Various
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects various simple values
F43nd1r
4.9.1
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects the holy stacktrace
F43nd1r
4.9.1
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
when this collector should be called compared to other collectors
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
Collects some data identifying a Thread
Kevin Gaudin & F43nd1r
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
when this collector should be called compared to other collectors
collect startup data
a context
the config
Collect a ReportField
the reportField to collect
a context
current Configuration
current ReportBuilder
put results here
if collection failed
collects time information
F43nd1r
4.9.1
Calls .shouldCollect for each ReportField and then .collect if it returned true
Collect a ReportField
collect startup data
controls if this instance is active
this should check if the config contains the field, but may add additional checks like permissions etc.
this should check if the config contains the field, but may add additional checks like permissions etc.
if this field should be collected now
a context
current configuration
the field to collect
the current reportBuilder
A collector that is also called at startup
Base implementation of a collector. Maintains information on which fields can be collected by this collector. Validates constraints in which a field should (not) be collected.
Thrown by collectors
Inspects a Configuration object through reflection API in order to generate a human readable String with values replaced with their constants names. The Configuration.toString method was not enough as values like 0, 1, 2 or 3 aren't readable. Using reflection API allows to retrieve hidden fields and can make us hope to be compatible with all Android API levels, even those which are not published yet.
Collects custom data supplied by the user
Collects features declared as available on the device.
Collects the device ID
Collects information about the connected display(s)
Collects data from the DropBoxManager. A set of DropBox tags have been identified in the Android source code. We collect data associated to these tags with hope that some of them could help debugging applications. Application specific tags can be provided by the app dev to track his own usage of the DropBoxManager.
Executes logcat commands and collects it's output.
Collects the N last lines of a text stream. Use this collector if your application handles its own logging system.
Collects data about available codecs on the device through the MediaCodecList API introduced in Android 4.1 JellyBean.
Collects results of the dumpsys
command.
Collects android.content.pm.PackageInfo values
Collector retrieving key/value pairs from static fields and getters. Reflection API usage allows to retrieve data without having to implement a class for each android version of each interesting class. It can also help find hidden properties.
Collects the content (key/value pairs) of SharedPreferences, from the application default preferences or any other preferences asked by the application developer.
Collects various simple values
Collects the holy stacktrace
Collects some data identifying a Thread
collects time information
A simple Exception used when required configuration items are missing.
Kevin Gaudin
creates a new builder
a new builder with values from the annotation
the context holding the annotation from which the builder should pull its values
Builds the configuration
the fully configured and immutable configuration
if the configuration is invalid
A configuration object
F43nd1r
01.06.2017
Custom tags to be included in DropBox event collection
Add here your android.content.SharedPreferences identifier Strings if you use others than your application's default. They will be added to the ReportField.SHARED_PREFERENCES field.
Set this to true if you prefer displaying the native force close dialog after ACRA is done. Recommended: Keep this set to false if using interactions with user input.
To use in combination with ReportField.APPLICATION_LOG to set the root for the path provided in applicationLogFile
To use in combination with ReportField.APPLICATION_LOG to set the number of latest lines of your application log file to be collected. Default value is 100.
To use in combination with ReportField.APPLICATION_LOG to set the path/name of your application log file.
Allows attachmentUris configuration at runtime instead of compile time.
4.9.3
Allows to attach files to crash reports.
+ACRA contains a file provider under the following Uri:
+content://[applicationId].acra/[Directory]/[Path]
+where [applicationId]
is your application package name, [Directory]
is one of the enum constants in [Directory] in lower case and [Path]
is the relative path to the file in that directory
+e.g. content://org.acra.test.acra/files/thisIsATest.txt
+
POST mode: requests will be sent with content-type multipart/form-data
PUT mode: There will be additional requests with the attachments. Naming scheme:
EMAIL mode: Some email clients do not support attachments, so some emails may lack these attachments. Note that attachments might be readable to email clients when they are sent.
4.9.3
The default value will be a BuildConfig class residing in the same package as the Application class. You only have to set this option if your BuildConfig class is obfuscated.
Controls whether unapproved reports are deleted on application start or not.
+Silent and Toast reports are automatically approved. +Dialog and Notification reports require explicit approval by the user before they are sent. +
++On application restart the user is prompted with approval for one unsent report. +So you generally don't want to accumulate unapproved reports, otherwise you will prompt them multiple times. +
++If this is set to true then all unapproved reports bar one will be deleted on application start. +The last report is always retained because that is the report that probably just happened. +
DropBox event collection will look back this many minutes
Provide here regex patterns to be evaluated on each [android.provider.Settings.System}, android.provider.Settings.Secure and android.provider.Settings.Global key to exclude KV pairs from being collected. This allows you to exclude sensitive data from being collected.
If you only want to include some keys, you may use regular expressions to do so:
only keys foo and bar | "^(?!foo|bar).*$" |
only keys containing foo and bar | "^((?!foo|bar).)*$" |
Provide here regex patterns to be evaluated on each android.content.SharedPreferences key to exclude KV pairs from the collected SharedPreferences. This allows you to exclude sensitive user data like passwords from being collected.
If you only want to include some keys, you may use regular expressions to do so:
only keys foo and bar | "^(?!foo|bar).*$" |
only keys containing foo and bar | "^((?!foo|bar).)*$" |
If enabled, DropBox events collection will include system tags:
system_app_anr
system_app_wtf
system_app_crash
system_server_anr
system_server_wtf
system_server_crash
BATTERY_DISCHARGE_INFO
SYSTEM_RECOVERY_LOG
SYSTEM_BOOT
SYSTEM_LAST_KMSG
APANIC_CONSOLE
APANIC_THREADS
SYSTEM_RESTART
SYSTEM_TOMBSTONE
data_app_strictmode
Custom tags to be included in DropBox event collection
Add here your android.content.SharedPreferences identifier Strings if you use others than your application's default. They will be added to the ReportField.SHARED_PREFERENCES field.
Set this to true if you prefer displaying the native force close dialog after ACRA is done. Recommended: Keep this set to false if using interactions with user input.
To use in combination with ReportField.APPLICATION_LOG to set the path/name of your application log file.
To use in combination with ReportField.APPLICATION_LOG to set the root for the path provided in applicationLogFile
To use in combination with ReportField.APPLICATION_LOG to set the number of latest lines of your application log file to be collected. Default value is 100.
Allows attachmentUris configuration at runtime instead of compile time.
Allows to attach files to crash reports.
The default value will be a BuildConfig class residing in the same package as the Application class. You only have to set this option if your BuildConfig class is obfuscated.
Controls whether unapproved reports are deleted on application start or not.
DropBox event collection will look back this many minutes
Provide here regex patterns to be evaluated on each [android.provider.Settings.System}, android.provider.Settings.Secure and android.provider.Settings.Global key to exclude KV pairs from being collected. This allows you to exclude sensitive data from being collected.
Provide here regex patterns to be evaluated on each android.content.SharedPreferences key to exclude KV pairs from the collected SharedPreferences. This allows you to exclude sensitive user data like passwords from being collected.
If enabled, DropBox events collection will include system tags:
Arguments to be passed to the logcat command line.
Set this to true if you want to include only logcat lines related to your Application process. Note that this is always done by android starting with API 16 (Jellybean)
Set this to true if you want to read logcat lines in a non blocking way for your thread. It has a default timeout of 3 seconds.
Plugin configurations
Allows custom plugin loading
Redefines the list of ReportFields collected and sent in your reports.
Format in which the report should be sent
Toast shown when report sending fails
Toast shown when a report is sent successfully
Implement a custom RetryPolicy to decide if a failed report should be resent or not.
Set this to false if you want to disable sending reports in development mode. Only signed application packages will send reports.
Name of the SharedPreferences that will host ACRA settings which you can make accessible to your users through a preferences screen:
If you have services which might crash on startup android will try to restart them indefinitely. Set this to true to prevent that.
Arguments to be passed to the logcat command line.
Do not include -b arguments for buffer selection, include ReportField.EVENTSLOG and ReportField.RADIOLOG in reportContent to activate alternative logcat buffers reporting. They will use the same other arguments as those provided here.
Set this to true if you want to include only logcat lines related to your Application process. Note that this is always done by android starting with API 16 (Jellybean)
Set this to true if you want to read logcat lines in a non blocking way for your thread. It has a default timeout of 3 seconds.
Plugin configurations
Allows custom plugin loading
Redefines the list of ReportFields collected and sent in your reports.
You can also use this property to modify fields order in your reports.
Implement a custom RetryPolicy to decide if a failed report should be resent or not.
4.9.1
Set this to false if you want to disable sending reports in development mode. Only signed application packages will send reports.
Name of the SharedPreferences that will host ACRA settings which you can make accessible to your users through a preferences screen:
Default is to use the application default SharedPreferences, as retrieved with android.preference.PreferenceManager.getDefaultSharedPreferences
If you have services which might crash on startup android will try to restart them indefinitely. Set this to true to prevent that.
4.9.2
if the request should be resent later.
a list of all senders.
a list of all failed senders with the thrown exceptions.
label of the comment input prompt. If not provided, removes the input field.
5.0.0
label of the email input prompt. If not provided, removes the input field.
5.0.0
CrashReportDialog configuration
F43nd1r
01.06.2017
label of the comment input prompt. If not provided, removes the input field.
label of the email input prompt. If not provided, removes the input field.
label of the negative button
label of the positive button
Custom CrashReportDialog class
Custom CrashReportDialog class
Inside the activity, use org.acra.dialog.CrashReportDialogHelper to integrate it ACRA.
5.0.0
you can set here and in basicAuthPassword the credentials for a BASIC HTTP authentication.
5.0.0
you can set here and in basicAuthLogin the credentials for a BASIC HTTP authentication.
5.0.0
a certificate used for ssl authentication
Must start with "asset://" if the file is in the assets folder
5.0.0
type of the certificate used for ssl authentication, set in either certificatePath or resCertificate
5.0.0
timeout for server connection in milliseconds
5.0.0
allows to prevent resending of timed out reports, possibly relieving server stress, but also reducing received report counts
5.0.0
custom HTTP headers to be sent by the provided org.acra.sender.HttpSender This should be used also by third party senders.
Http sender configuration
F43nd1r
01.06.2017
you can set here and in basicAuthPassword the credentials for a BASIC HTTP authentication.
you can set here and in basicAuthLogin the credentials for a BASIC HTTP authentication.
a certificate used for ssl authentication
type of the certificate used for ssl authentication, set in either certificatePath or resCertificate
timeout for server connection in milliseconds
allows to prevent resending of timed out reports, possibly relieving server stress, but also reducing received report counts
custom HTTP headers to be sent by the provided org.acra.sender.HttpSender This should be used also by third party senders.
The HttpSender.Method to be used when posting with uri.
A custom class supplying a java.security.KeyStore, which will be used for ssl authentication. A base implementation is available: org.acra.security.BaseKeyStoreFactory
a certificate used for ssl authentication
timeout for socket connection in milliseconds
TLS versions supported by the server.
A custom class supplying a java.security.KeyStore, which will be used for ssl authentication. A base implementation is available: org.acra.security.BaseKeyStoreFactory
5.0.0
timeout for socket connection in milliseconds
5.0.0
TLS versions supported by the server.
This array has to contain at least one option supported on all android versions this runs on! ACRA will automatically remove unsupported versions on older devices.
Note: Older Android versions do not support all tls versions.
5.7.0
This property can be used to determine whether old (out of date) reports should be sent or not.
5.3.0
limit for reports with the same exception class per period
5.0.0
toast shown when a report was not collected or sent because a limit was exceeded
5.0.0
Limiter configuration
F43nd1r
26.10.2017
This property can be used to determine whether old (out of date) reports should be sent or not.
limit for reports with the same exception class per period
limit for unsent reports to keep
toast shown when a report was not collected or sent because a limit was exceeded
general limit of reports per period
number of periodUnits in which to limit reports
Unit of period
Resetting limits after an app update allows you to see if a bug still exists.
limit for reports with the same stacktrace per period
number of periodUnits in which to limit reports
Reports which have been collected before this will not be considered for any limits except failedReportLimit
5.0.0
Resetting limits after an app update allows you to see if a bug still exists.
5.3.0
F43nd1r
26.10.2017
F43nd1r
01.06.2017
report is an attachment instead of plain text.
Sending the report as an attachment prevents issues with report size and the user from modifying it
5.0.0
notification channel description
5.0.0
notification channel importance. Must be one of
android.app.NotificationManager#IMPORTANCE_NONE
android.app.NotificationManager#IMPORTANCE_LOW
android.app.NotificationManager#IMPORTANCE_DEFAULT
android.app.NotificationManager#IMPORTANCE_HIGH
android.app.NotificationManager#IMPORTANCE_MAX
Default is android.app.NotificationManager#IMPORTANCE_HIGH
5.0.0
notification channel name. To learn about notification channels, visit the notification guide
5.0.0
in-line comment prompt label. Only available on API 24 - 28.
5.0.0
F43nd1r
15.09.2017
notification channel description
notification channel importance. Must be one of
notification channel name. To learn about notification channels, visit the notification guide
in-line comment prompt label. Only available on API 24 - 28.
discard button text shown in expanded view
discard button icon shown in collapsed and sometimes expanded view
send button icon shown in collapsed and sometimes expanded view
in-line comment button icon. Only available on API 24 - 28.
send button text shown in expanded view
enable to send report even on normal click, not only on button click
in-line comment button text. Only available on API 24 - 28.
ticker text for the notification
discard button icon shown in collapsed and sometimes expanded view
5.0.0
icon of the notification
5.0.0
#setSmallIcon(int)
send button icon shown in collapsed and sometimes expanded view
5.0.0
in-line comment button icon. Only available on API 24 - 28.
5.0.0
enable to send report even on normal click, not only on button click
5.0.0
in-line comment button text. Only available on API 24 - 28.
5.0.0
ticker text for the notification
5.0.0
title of the notification
5.0.0
controls if this instance is active
notifies the user about a dropped report
Determines if the application should be killed
Determines if a collected report should be sent
Determines if report collection should start
notifies the user about a dropped report
a context
the current config
Determines if the application should be killed
if the application should be killed
a context
the current config
the reportBuilder for the report about to be collected
the collected report
Determines if a collected report should be sent
if this report should be sent
a context
the current config
the collected report
Determines if report collection should start
if this report should be collected
a context
the current config
the reportBuilder for the report about to be collected
A policy which determines if a report should be resent.
F43nd1r
4.9.1
if the request should be resent later.
a list of all senders.
a list of all failed senders with the thrown exceptions.
F43nd1r
18.04.18
Battery constraint for report sending
Charging constraint for report sending
Idle constraint for report sending
Network constraint for report sending
Restarts the last activity immediately after a crash. If an activity is restarted, the org.acra.scheduler.RestartingAdministrator.EXTRA_ACTIVITY_RESTART_AFTER_CRASH extra will contain a boolean true. Note that this might interact badly with the crash dialog.
Restarts the last activity immediately after a crash. If an activity is restarted, the org.acra.scheduler.RestartingAdministrator.EXTRA_ACTIVITY_RESTART_AFTER_CRASH extra will contain a boolean true. Note that this might interact badly with the crash dialog.
5.2.0
F43nd1r
02.06.2017
Allows easy access to Plugin configurations from the main configuration
F43nd1r
01.06.2017
A simple Exception used when required configuration items are missing.
A configuration object
A Configuration builder
A factory for configuration builders
Default RetryPolicy. Only resend if all senders failed.
CrashReportDialog configuration
Http sender configuration
Limiter configuration
Controls if reports are sent
A policy which determines if a report should be resent.
Allows easy access to Plugin configurations from the main configuration
Collects crash data.
CrashReportData identifying the current crash.
ReportBuilder for whom to crete the crash report.
Responsible for collecting the CrashReportData for an Exception.
F43nd1r
4.3.0
Returns the property with the specified key.
the keyd property value, or null
if it can't be found.
the key of the property to find.
Stores a crash report data
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
Represents possible report formats
F43nd1r
14.11.2017
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.)
Returns an array containing the constants of this enum type, in the order they're declared.
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.)
if this enum type has no constant with the specified name
Returns an array containing the constants of this enum type, in the order they're declared.
This method may be used to iterate over the constants.
Stores a crash report data
Responsible for collecting the CrashReportData for an Exception.
Represents possible report formats
Cancel any pending crash reports.
Use this class to integrate your custom crash report dialog with ACRA.
Call this in your android.app.Activity.onCreate. The intent must contain two extras:
f43nd1r
5.4.0
a context
the intent which started this activity
if the intent cannot be parsed or does not contain the correct data
loads the current report data
report data
if there was a problem with the report file
This is the dialog Activity used by ACRA to get authorization from the user to send reports.
F43nd1r & Various
Whether to delete approved or unapproved reports.
Number of latest reports to keep.
Gets the timestamp of a report from its name
timestamp of the report
Name of the report to get the timestamp from.
Responsible for determining the state of a Crash Report based on its file name.
William Ferguson & F43nd1r
4.3.0
use {@link ReportLocator#getApprovedReports()} and {@link ReportLocator#getUnapprovedReports()} instead
Returns true if the report is considered as approved.
This includes:
Reports which were pending when the user agreed to send a report in the NOTIFICATION mode Dialog.
Explicit silent reports
True if a report can be sent.
Name of report to check whether it is approved to be sent.
Handles persistence of CrashReportData
Loads properties from the specified File
.
Stores the mappings in this Properties to the specified OutputStream, putting the specified comment at the beginning. The output from this method is suitable for being read by the load() method.
Loads properties from the specified File
.
CrashReportData read from the supplied File.
Report file from which to load the CrashData.
if error occurs during reading from the File
.
if the stream cannot be parsed as a JSON object.
Stores the mappings in this Properties to the specified OutputStream, putting the specified comment at the beginning. The output from this method is suitable for being read by the load() method.
CrashReportData to save.
File into which to store the CrashReportData.
if the CrashReportData could not be written to the OutputStream.
if the crashData could not be converted to JSON.
Directory returned by Context.getCacheDir
Directory returned by Context.getExternalCacheDir Note: Additional permissions may be required.
Directory returned by Context.getExternalFilesDir Note: Additional permissions may be required.
Directory returned by Environment.getExternalStorageDirectory Note: Additional permissions may be required.
Directory returned by Context.getFilesDir
Directory returned by Context.getNoBackupFilesDir. Will fall back to Context.getFilesDir on API < 21
Root Directory, paths in this directory are absolute paths
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
Directory returned by Context.getFilesDir
Directory returned by Context.getExternalFilesDir Note: Additional permissions may be required.
Directory returned by Context.getCacheDir
Directory returned by Context.getExternalCacheDir Note: Additional permissions may be required.
Directory returned by Context.getNoBackupFilesDir. Will fall back to Context.getFilesDir on API < 21
Directory returned by Environment.getExternalStorageDirectory Note: Additional permissions may be required.
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.)
if this enum type has no constant with the specified name
Deletes unsent reports.
Responsible for determining the state of a Crash Report based on its file name.
Handles persistence of CrashReportData
Locates crash reports.
F43nd1r
03.03.2017
Sends to a URL.
URL to which to send.
content to send.
if the data cannot be sent.
F43nd1r
10.03.2017
F43nd1r
10.03.2017
Produces RFC 7578 compliant requests
F43nd1r
11.03.2017
Used in the intent starting CrashReportDialog to provide the AcraConfig to use when gathering the crash info.
This can be used by any BaseCrashReportDialog subclass to custom the dialog.
Used in the intent starting CrashReportDialog to provide the name of the latest generated report file in order to be able to associate the user comment.
Used in the intent starting CrashReportDialog to provide the AcraConfig to use when gathering the crash info.
Used in the intent starting CrashReportDialog to provide the name of the latest generated report file in order to be able to associate the user comment.
Manages and executes all report interactions
F43nd1r
10.10.2017
A user interaction before reports are sent
F43nd1r
02.06.2017
controls if this instance is active
Perform interaction synchronously
Perform interaction synchronously
if reports should be sent instantly
a context
the configuration
the file with the report content
A user interaction before reports are sent
Manages and executes all report interactions
Responsible for providing ACRA classes with a platform neutral way of logging.
One reason for using this mechanism is to allow ACRA classes to use a logging system, but be able to execute in a test environment outside of an Android JVM.
William Ferguson
4.3.0
Responsible for delegating calls to the Android logging system.
William Ferguson
4.3.0
Stub implementation of org.acra.log.ACRALog, quenches all logging.
Responsible for delegating calls to the Android logging system.
Stub implementation of org.acra.log.ACRALog, quenches all logging.
controls if this instance is active
if this instance should be called
the current config
controls if this instance is active
if this instance should be called
the current config
Utility to load Plugins
Check if the application default shared preferences contains true for the key "acra.disable", do not activate ACRA. Also checks the alternative opposite setting "acra.enable" if "acra.disable" is not found.
true if prefs indicate that ACRA should be enabled.
SharedPreferences to check to see whether ACRA should be disabled.
The Shared Preferences where ACRA will retrieve its user adjustable setting.
Responsible for creating a SharedPreferences instance which stores ACRA settings.
Retrieves the SharedPreferences instance where user adjustable settings for ACRA are stored. Default are the Application default SharedPreferences, but you can provide another SharedPreferences name with org.acra.annotation.AcraCore.sharedPreferencesName.
Context for the application in which ACRA is running.
AcraConfig to use when reporting and sending errors.
Whether this ErrorReporter should capture Exceptions and forward their reports.
the minimal supported version
If reports should be checked on startup
Removes all key/value pairs from your reports custom data field.
Gets the current value for a key in your reports custom data field.
The value for this key.
The key of the data to be retrieved.
.removeCustomData
Send a normal report for the given exception
The Throwable to be reported. If null the report will contain a new Exception("Report requested by developer").
if you want the application to be ended after sending the report.
Send a normal report for the given exception.
The Throwable to be reported. If null the report will contain a new Exception("Report requested by developer").
Send a silent report for the given exception
The Throwable to be reported. If null the report will contain a new Exception("Report requested by developer").
The ErrorReporter is a Singleton object in charge of collecting crash context data and sending crash reports. It registers itself as the Application's Thread default Thread.UncaughtExceptionHandler.
When a crash occurs, it collects data of the crash context (device, system, stack trace...) and writes a report file in the application private directory, which may then be sent.
Context for the application in which ACRA is running.
AcraConfig to use when reporting and sending errors.
Whether this ErrorReporter should capture Exceptions and forward their reports.
the minimal supported version
If reports should be checked on startup
Removes all key/value pairs from your reports custom data field.
Gets the current value for a key in your reports custom data field.
Send a normal report for the given exception.
Send a normal report for the given exception
Send a silent report for the given exception
Use this method to provide the ErrorReporter with data of your running application. You should call this at several key places in your code the same way as you would output important debug data in a log file. Only the latest value is kept for each key (no history of the values is sent in the report).
Removes a key/value pair from your reports custom data field.
Enable or disable this ErrorReporter. By default it is enabled.
Use this method to provide the ErrorReporter with data of your running application. You should call this at several key places in your code the same way as you would output important debug data in a log file. Only the latest value is kept for each key (no history of the values is sent in the report).
The previous value for this key if there was one, or null.
A key for your custom data.
The value associated to your key.
.getCustomData
Removes a key/value pair from your reports custom data field.
The value for this key before removal.
The key of the data to be removed.
.getCustomData
Access point to manual report scheduling
current SenderScheduler
Enable or disable this ErrorReporter. By default it is enabled.
Whether this ErrorReporter should capture Exceptions and forward them as crash reports.
The ErrorReporter is a Singleton object in charge of collecting crash context data and sending crash reports. It registers itself as the Application's Thread default Thread.UncaughtExceptionHandler.
Utilizes jobservice to delay report sending
F43nd1r
18.04.18
Starts a process to start sending outstanding error reports.
If not null, this report will be approved before scheduling.
If true then only send silent reports.
Fully configured instance of the relevant SenderScheduler.
a context.
Configuration to use when sending reports.
Utilizes jobservice to delay report sending
Simply schedules sending instantly
the certificate type
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
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.)
Returns an array containing the constants of this enum type, in the order they're declared.
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.)
if this enum type has no constant with the specified name
Returns an array containing the constants of this enum type, in the order they're declared.
This method may be used to iterate over the constants.
Provides base KeyStoreFactory implementation
creates a new KeyStoreFactory with the specified certificate type
F43nd1r
4.8.3
the certificate type
The interface can be used to provide a KeyStore with certificates.
F43nd1r
4.8.3
try to get the keystore
the keystore, or null if none provided / failure
a context
the configuration
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
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.)
if this enum type has no constant with the specified name
Provides base KeyStoreFactory implementation
The interface can be used to provide a KeyStore with certificates.
Helper to get a KeyStore from a configuration
Default KeyStoreFactory. Does not provide any KeyStore
Constructs an EmailIntentSender.
Send reports through an email intent.
The user will be asked to chose his preferred email client if no default is set. Included report fields can be defined using org.acra.annotation.AcraCore.reportContent. Crash receiving mailbox has to be defined with org.acra.annotation.AcraMailSender.mailTo.
Constructs a HttpSender with no report field mappings.
AcraConfig declaring the
HTTP Method to be used to send data. Currently only Method.POST and Method.PUT are available. If Method.PUT is used, the ReportField.REPORT_ID is appended to the formUri to be compliant with RESTful APIs.
StringFormat of encoding used to send the report body. StringFormat.KEY_VALUE_LIST is a simple Key/Value pairs list as defined by the application/x-www-form-urlencoded mime type.
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
Available HTTP methods to send data. Only POST and PUT are currently supported.
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.)
Returns an array containing the constants of this enum type, in the order they're declared.
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.)
if this enum type has no constant with the specified name
Returns an array containing the constants of this enum type, in the order they're declared.
This method may be used to iterate over the constants.
Create a new HttpSender instance with its destination taken from the supplied config.
F43nd1r & Various
AcraConfig declaring the
HTTP Method to be used to send data. Currently only Method.POST and Method.PUT are available. If Method.PUT is used, the ReportField.REPORT_ID is appended to the formUri to be compliant with RESTful APIs.
StringFormat of encoding used to send the report body. StringFormat.KEY_VALUE_LIST is a simple Key/Value pairs list as defined by the application/x-www-form-urlencoded mime type.
Set credentials for this HttpSender that override (if present) the ones set globally.
The username to set for HTTP Basic Auth.
The password to set for HTTP Basic Auth.
Job service sending reports. has to run in the :acra process
Lukas
31.12.2018
Plain service sending reports. has to run in the :acra process. Only used when no JobScheduler is available.
Lukas
Creates a new ReportSenderException instance. You can provide a detailed message to explain what went wrong.
A message to explain the cause of this exception.
An optional throwable which caused this Exception.
Creates a new ReportSenderException instance. You can provide a detailed message to explain what went wrong.
A message to explain the cause of this exception.
This exception is thrown when an error occurred while sending crash data in a ReportSender implementation.
Kevin Gaudin
Creates a new ReportSenderException instance. You can provide a detailed message to explain what went wrong.
Creates a new ReportSenderException instance. You can provide a detailed message to explain what went wrong.
Fully configured instance of the relevant ReportSender.
a context.
Configuration to use when sending reports.
Factory for creating and configuring a ReportSender instance. Implementations must have a no argument constructor.
Each configured ReportSenderFactory is created within the LegacySenderService and is used to construct and configure a single ReportSender.
Created by William on 4-JAN-2016.
A simple interface for defining various crash report senders.
Kevin Gaudin
Send crash report data.
Method will be called from the ReportDistributor.
Android Context in which to send the crash report.
Stores key/value pairs for each report field.
If anything goes fatally wrong during the handling of crash data, you can (should) throw a ReportSenderException with a custom message.
Send crash report data.
Method will be called from the ReportDistributor.
Android Context in which to send the crash report.
Stores key/value pairs for each report field.
additional information set in a org.acra.scheduler.DefaultSenderScheduler
If anything goes fatally wrong during the handling of crash data, you can (should) throw a ReportSenderException with a custom message.
Send reports through an email intent.
Constructs an EmailIntentSender.
Create a new HttpSender instance with its destination taken from the supplied config.
Constructs a HttpSender with no report field mappings.
Job service sending reports. has to run in the :acra process
Plain service sending reports. has to run in the :acra process. Only used when no JobScheduler is available.
A simple interface for defining various crash report senders.
This exception is thrown when an error occurred while sending crash data in a ReportSender implementation.
Factory for creating and configuring a ReportSender instance. Implementations must have a no argument constructor.
lukas
15.09.18
lukas
15.09.18
controls if this instance is active
Creates a file storing a UUID on the first application start. This UUID can then be used as a identifier of this specific application installation.
This was taken from [ the
android developers blog.](http://android-developers.blogspot.com/2011/03/identifying-app-installations.html)
Create an instance of clazz
a new instance of clazz or fallback
the clazz to create an instance of
a value provider which provides a fallback in case of a failure
Create instances of the given classes
a list of successfully created instances, does not contain null
the classes to create insatnces of
PackageInfo for the current application or null if the PackageManager could not be contacted.
true if the permission has been granted to the app, false if it hasn't been granted or the PackageManager could not be contacted.
Manifest.permission to check whether it has been granted.
Responsible for wrapping calls to PackageManager to ensure that they always complete without throwing RuntimeExceptions. Depending upon the state of the application it is possible that
Context has no PackageManager.
PackageManager returned by Context throws RuntimeException("Package manager has died") because it cannot contact the remote PackageManager service.
I suspect that PackageManager death is caused during app installation. But we need to make ACRA bullet proof, so it's better to handle the condition safely so that the error report itself doesn't fail.
William Ferguson
4.3.0
Takes care of cleaning up a process and killing it.
F43nd1r
4.9.2
F43nd1r
30.11.2017
Responsible for sending Toasts under all circumstances.
William Ferguson
4.3.0
Creates a file storing a UUID on the first application start. This UUID can then be used as a identifier of this specific application installation.
Responsible for wrapping calls to PackageManager to ensure that they always complete without throwing RuntimeExceptions. Depending upon the state of the application it is possible that
Takes care of cleaning up a process and killing it.
Responsible for sending Toasts under all circumstances.
Creates a new PersistableBundle from the specified Bundle. Will ignore all values that are not persistable, according to .isPersistableBundleType.
Creates a new PersistableBundle from the specified Bundle. Will ignore all values that are not persistable, according to .isPersistableBundleType.
Suffix to be added to report files when they have been approved by the user in NOTIFICATION mode
Default list of ReportFields to be sent in reports. You can set your own list with org.acra.annotation.AcraCore.reportContent.
This is the maximum number of previously stored reports that we send in one batch to avoid overloading the network.
This key is used to store the silent state of a report sent by handleSilentException().
Responsible for collating those constants shared among the ACRA components.
William Ferguson
4.3.0
Suffix to be added to report files when they have been approved by the user in NOTIFICATION mode
Default list of ReportFields to be sent in reports. You can set your own list with org.acra.annotation.AcraCore.reportContent.
This is the maximum number of previously stored reports that we send in one batch to avoid overloading the network.
This key is used to store the silent state of a report sent by handleSilentException().
The key of the SharedPreference allowing the user to automatically accept sending reports.
The key of the application default SharedPreference where you can put a 'true' Boolean value to disable ACRA.
Alternatively, you can use this key if you prefer your users to have the checkbox ticked to enable crash reports. If both acra.disable and acra.enable are set, the value of acra.disable takes over the other.
The key of the SharedPreference allowing the user to disable sending his device id. Device ID collection is also dependent of the READ_PHONE_STATE permission.
The key of the SharedPreference allowing the user to disable sending content of logcat/dropbox. System logs collection is also dependent of the READ_LOGS permission.
The version number of the application the last time ACRA was started. This is used to determine whether unsent reports should be discarded because they are old and out of date.
The key of the SharedPreference allowing the user to always include his email address.
the current instance of ErrorReporter. not available if ACRA.init has not yet been called.
Use this class to initialize the crash reporting feature using .init as soon as possible in your Application subclass Application.onCreate method. Configuration items must have been set by using org.acra.annotation.AcraCore above the declaration of your Application subclass.
Kevin Gaudin
the current instance of ErrorReporter. not available if ACRA.init has not yet been called.
The key of the SharedPreference allowing the user to automatically accept sending reports.
The key of the application default SharedPreference where you can put a 'true' Boolean value to disable ACRA.
Alternatively, you can use this key if you prefer your users to have the checkbox ticked to enable crash reports. If both acra.disable and acra.enable are set, the value of acra.disable takes over the other.
The key of the SharedPreference allowing the user to disable sending his device id. Device ID collection is also dependent of the READ_PHONE_STATE permission.
The key of the SharedPreference allowing the user to disable sending content of logcat/dropbox. System logs collection is also dependent of the READ_LOGS permission.
The version number of the application the last time ACRA was started. This is used to determine whether unsent reports should be discarded because they are old and out of date.
The key of the SharedPreference allowing the user to always include his email address.
Initialize ACRA for a given Application.
Initialize ACRA for a given Application. The call to this method should be placed as soon as possible in the Application.attachBaseContext method.
Initialize ACRA for a given Application.
The call to this method should be placed as soon as possible in the Application.attachBaseContext method.
Your Application class.
ConfigurationBuilder to manually set up ACRA configuration.
Whether to invoke ErrorReporter.checkReportsOnApplicationStart().
Initialize ACRA for a given Application. The call to this method should be placed as soon as possible in the Application.attachBaseContext method.
Your Application class.
CoreConfiguration to manually set up ACRA configuration.
Whether to invoke ErrorReporter.checkReportsOnApplicationStart().
if it is called more than once.
true if the current process is the process running the SenderService. NB this assumes that your SenderService is configured to used the default ':acra' process.
true is ACRA has been initialised.
Removes all key/value pairs from your reports custom data field.
Gets the current value for a key in your reports custom data field.
The value for this key.
The key of the data to be retrieved.
.removeCustomData
Send a normal report for the given exception
The Throwable to be reported. If null the report will contain a new Exception("Report requested by developer").
if you want the application to be ended after sending the report.
Send a normal report for the given exception.
The Throwable to be reported. If null the report will contain a new Exception("Report requested by developer").
Send a silent report for the given exception
The Throwable to be reported. If null the report will contain a new Exception("Report requested by developer").
This interface contains methods used to interact with ACRA after it has been initialized
F43nd1r
29.12.2017
Removes all key/value pairs from your reports custom data field.
Gets the current value for a key in your reports custom data field.
Send a normal report for the given exception.
Send a normal report for the given exception
Send a silent report for the given exception
Use this method to provide the ErrorReporter with data of your running application. You should call this at several key places in your code the same way as you would output important debug data in a log file. Only the latest value is kept for each key (no history of the values is sent in the report).
Removes a key/value pair from your reports custom data field.
Enable or disable this ErrorReporter. By default it is enabled.
Use this method to provide the ErrorReporter with data of your running application. You should call this at several key places in your code the same way as you would output important debug data in a log file. Only the latest value is kept for each key (no history of the values is sent in the report).
The previous value for this key if there was one, or null.
A key for your custom data.
The value associated to your key.
.getCustomData
Removes a key/value pair from your reports custom data field.
The value for this key before removal.
The key of the data to be removed.
.getCustomData
Access point to manual report scheduling
current SenderScheduler
Enable or disable this ErrorReporter. By default it is enabled.
Whether this ErrorReporter should capture Exceptions and forward them as crash reports.
Application version code. This is the incremental integer version code used to differentiate versions on the android market.
Estimation of the available device memory size based on filesystem stats.
Contains key = value pairs defined by the application developer during the application build.
android.content.res.Configuration fields state on the application crash.
Contains key = value pairs defined by the application developer during the application execution.
DEVICE_ID will be null on Android Q and above
Device unique ID (IMEI). Requires READ_PHONE_STATE permission.
Content of the android.os.DropBoxManager (introduced in API level 8). Requires READ_LOGS permission.
android.content.res.Configuration fields state on the application start.
Installation unique ID. This identifier allow you to track a specific user application installation without using any personal data.
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).
Global settings, introduced in Android 4.2 (API level 17) to centralize settings for multiple users.
A hash of the stack trace, taking only method names into account.
Line numbers are stripped out before computing the hash. This can help you uniquely identify stack traces.
Returns a representation of an immutable list of all enum entries, in the order they're declared.
This method may be used to iterate over the enum entries.
Specifies all the different fields available in a crash report.
Normal
Application version code. This is the incremental integer version code used to differentiate versions on the android market.
Application version name.
Application package name.
Device model name.
Device android version name.
Estimation of the total device memory size based on filesystem stats.
Estimation of the available device memory size based on filesystem stats.
Contains key = value pairs defined by the application developer during the application build.
Contains key = value pairs defined by the application developer during the application execution.
The Holy Stack Trace.
A hash of the stack trace, taking only method names into account.
Line numbers are stripped out before computing the hash. This can help you uniquely identify stack traces.
android.content.res.Configuration fields state on the application start.
android.content.res.Configuration fields state on the application crash.
Comment added by the user in the CrashReportDialog.
User date on application start.
User date immediately after the crash occurred.
Memory state details for the application process.
Installation unique ID. This identifier allow you to track a specific user application installation without using any personal data.
User email address. Can be provided by the user in SharedPreferences.
Features declared as available on this device by the system.
External storage state and standard directories.
System settings.
Secure settings (applications can't modify them).
Global settings, introduced in Android 4.2 (API level 17) to centralize settings for multiple users.
SharedPreferences contents
Content of your own application log file.
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).
Retrieves details of the failing thread (id, name, group 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.)
Returns an array containing the constants of this enum type, in the order they're declared.
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.)
if this enum type has no constant with the specified name
Returns an array containing the constants of this enum type, in the order they're declared.
This method may be used to iterate over the constants.
Use this class to initialize the crash reporting feature using .init as soon as possible in your Application subclass Application.onCreate method. Configuration items must have been set by using org.acra.annotation.AcraCore above the declaration of your Application subclass.
Responsible for collating those constants shared among the ACRA components.
This interface contains methods used to interact with ACRA after it has been initialized
Specifies all the different fields available in a crash report.