cketti/emailintentbuilder

An Android Library for the creation of SendTo Intents with mailto: URI

Email Intent Builder

An Android Library for the creation of SendTo Intents with mailto: URI

Read the article Android: Sending Email using Intents if you want to learn what motivated the creation of this library.

Include the library

Add this to your dependencies block in build.gradle:

implementation 'de.cketti.mailto:email-intent-builder:2.0.0'

Usage

Creating a simple email intent is as easy as this:

Intent emailIntent = EmailIntentBuilder.from(activity)
        .to("[email protected]")
        .subject("Feedback")
        .build();

This will build an intent with the action android.intent.action.SENDTO and the data mailto:[email protected]?subject=Feedback.

You can also use EmailIntentBuilder to add a couple of other fields and directly launch the intent:

EmailIntentBuilder.from(activity)
        .to("[email protected]")
        .cc("[email protected]")
        .bcc("[email protected]")
        .subject("Message from an app")
        .body("Some text here")
        .start();

Changelog

Version 2.0.0 (2019-11-26)

• Use org.jetbrains:annotations for nullability annotations
• No functional changes

Version 1.0.0 (2015-12-19)

• Initial release

License

Copyright 2015-2019 cketti

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

emailintentbuilder's Issues

Non-email app shows up in chooser (PayPal)

I know it is not your problem, but PayPal is shown in choser alongside email client. It shouldn't be the case.
I'm fighting with this stupid case for quite some time myself...

Update documentation: HTML emails are not supported

How can I send HTML formatted text using your library similar to ShareCompat.IntentBuilder.setHtmlText()?

"to" is an operator in the Kotlin stdlib

https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/to.html

This makes it difficult to use the to method from Kotlin because Kotlin interprets it as the stdlib operator.

Document limitations

This library doesn't support…

• attachments (not supported by mailto URI)
• names that go with email addresses, e.g. John Doe <[email protected]> (not sure if support possible)
• non-text/plain mail bodies; see also #1 (not supported by mailto URI)

Update the documentation to include this information and point to alternatives if available, e.g. ACTION_SEND.

Line breaks in body not working for Gmail app

Hi, I'm doing something like this:

val intent = EmailIntentBuilder.from(it)
  .to("[email protected]")
  .subject("Hi!")
  .body("\nContains\nline breaks!\n")
  .build()

Using this intent shows the line breaks in the Samsung mail client and also in Outlook for Android. But Gmail seems to not understand the line breaks.

Receiving that email sent via Gmail I can see that it contains plain text AND html mail.
The html part contains the line breaks (without any effect, because.. html 😉 ). The text part doesn't contain the line breaks.

Is this some weird misbehavior of Gmail anyone faced before? I'm using the current version published on 12.02.2020.

Premise of EmailIntentBuilder no longer valid?

AFAIU, one of the premises EIB was built for was the lack of documentation of the various commonly used extras and ACTION_SENDTO. However, I just stumbled across this:

https://developer.android.com/guide/components/intents-common.html#Email

What do you think?

Cut off body

I'm using EmailIntentBuilder in my app Glimpse Notifications. The can create some log data and send it as an email to me. Recently, I'm getting mails where the body seems to be cut off. For example, the body should look like this:

Device = samsung, SM-J320F
Version = 5.1.1
Build = LMY47V.J320FXXU0AQL1
-------------------------
accel_tune_sensitivity=1
allow_adaptive_notifications=false
...

More data follows, a typical body would be 237 lines or 17k bytes.

But I only get:

Device

Is there any resonable explanation for this? Are there any lenth limitations? Any characters I should not use? Any side effects from the fixLineBreaks() method?

Just to be clear, only a fraction of emails are garbled like this. In one case I could determine that the user user Gmail as an email client, FWIW.

Newlines from body stripped in some configurations

On a Samsung Galaxy S8, Android 9 (and maybe other configurations), newlines aren't included when selecting Gmail. They are included when selecting the default Samsung mail app.

Steps to reproduce:

• Open the sample app
• Enter an e-mail body which contains some newlines
• Click "send email"
• Select Gmail
• Expected behavior: the newlines appear in the mail body
• Actual behavior: the newlines are stripped: all paragraphs run together

Screenshots:
Sample app:

Gmail missing newlines:

Samsung mail app contains newlines ok: