org.acra.sender

Class EmailIntentSender

java.lang.Object

org.acra.sender.EmailIntentSender

All Implemented Interfaces:

ReportSender

public class EmailIntentSender
extends Object
implements ReportSender

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 AcraCore.reportContent(). Crash receiving mailbox has to be defined with AcraMailSender.mailTo().

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_REPORT_FILENAME

Constructor Summary

Constructors

Constructor and Description
EmailIntentSender(CoreConfiguration config)

Method Summary

Modifier and Type	Method and Description
protected Intent	buildAttachmentIntent(String subject, String body, ArrayList<Uri> attachments) Builds an email intent with attachments
protected Intent	buildResolveIntent(String subject, String body) Builds an intent used to resolve email clients and to send reports without attachments or as fallback if no attachments are supported
protected String	buildSubject(Context context) Creates the message subject
protected Uri	createAttachmentFromString(Context context, String name, String content) Creates a temporary file with the given content and name, to be used as an email attachment
protected boolean	fillAttachmentList(Context context, String reportText, List<Uri> attachments) Adds all attachment uris into the given list
boolean	requiresForeground()
void	send(Context context, CrashReportData errorContent) Send crash report data.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.acra.sender.ReportSender

send

Field Detail

DEFAULT_REPORT_FILENAME

public static final String DEFAULT_REPORT_FILENAME

See Also:

Constant Field Values

Constructor Detail

EmailIntentSender

public EmailIntentSender(@NonNull
                         CoreConfiguration config)

Method Detail

send

public void send(@NonNull
                 Context context,
                 @NonNull
                 CrashReportData errorContent)
          throws ReportSenderException

Description copied from interface: ReportSender

Send crash report data.

Method will be called from the LegacySenderService.

Specified by:

send in interface ReportSender

Parameters:

context - Android Context in which to send the crash report.

errorContent - Stores key/value pairs for each report field.

Throws:

ReportSenderException - If anything goes fatally wrong during the handling of crash data, you can (should) throw a ReportSenderException with a custom message.

requiresForeground

public boolean requiresForeground()

Specified by:

requiresForeground in interface ReportSender

buildAttachmentIntent

@NonNull
protected Intent buildAttachmentIntent(@NonNull
                                                String subject,
                                                @Nullable
                                                String body,
                                                @NonNull
                                                ArrayList<Uri> attachments)

Builds an email intent with attachments

Parameters:

subject - the message subject

body - the message body

attachments - the attachments

Returns:

email intent

buildResolveIntent

@NonNull
protected Intent buildResolveIntent(@NonNull
                                             String subject,
                                             @NonNull
                                             String body)

Builds an intent used to resolve email clients and to send reports without attachments or as fallback if no attachments are supported

Parameters:

subject - the message subject

body - the message body

Returns:

email intent

buildSubject

@NonNull
protected String buildSubject(@NonNull
                                       Context context)

Creates the message subject

Parameters:

context - a context

Returns:

the message subject

fillAttachmentList

protected boolean fillAttachmentList(@NonNull
                                     Context context,
                                     @NonNull
                                     String reportText,
                                     @NonNull
                                     List<Uri> attachments)

Adds all attachment uris into the given list

Parameters:

context - a context

reportText - the report content

attachments - the target list

Returns:

if the attachments contain the content

createAttachmentFromString

@Nullable
protected Uri createAttachmentFromString(@NonNull
                                                   Context context,
                                                   @NonNull
                                                   String name,
                                                   @NonNull
                                                   String content)

Creates a temporary file with the given content and name, to be used as an email attachment

Parameters:

context - a context

name - the name

content - the content

Returns:

a content uri for the file