See the App Inventor Extensions document about how to use an App Inventor Extension.
For questions about this extension, bug reports and feature requests, please start a new thread in the App Inventor Extensions forum. Thank you.
July 10th, 2016: Version 1 of the Mail Extension released (POP3 blocks are still experimental!)
Aug 11th, 2016: Version 1a: avoid DX execution failed error: build each extension separately
This extension enables you to send an email via SMTP. You can send to several To, Cc or Bcc addresses, add several attachments and
send in plain text or HTML format. Note: SMTP authentication is set to true.
To use this extension together with Gmail accounts, you have to enable less secure apps in the Google settings, see also Why do I get AuthenticationFailedException when accessing Gmail?.
Required permissions: android.permission.INTERNET, android.permission.READ_EXTERNAL_STORAGE, android.permission.WRITE_EXTERNAL_STORAGE
Probably you want to read this first: What is SMTP?
This extension uses the Javamail API version 1.5.5. Thank you Oracle!
Note: There are also blocks available to receive emails via POP3, but these are still experimental... What is POP3?
Returns from (i.e. the email address of the sender of a message).
Specifies from (i.e. the email address of the sender of a message).
Returns SMTP host.
Specifies SMTP host. Default value is smtp.gmail.com.
Returns SMTP port.
Specifies SMTP port. Default value is 465.
Returns whether text should be sent in HTML format.
Specifies whether text should be sent in HTML format. Default value is false.
Subject and To address are mandatory. For To, Cc and Bcc you can add several addresses, use a comma as delimiter. Also you can add several attachments, use a comma as delimiter. You can't send attachments from the assets of the app.
Event indicating that email has been sent.
In case of success, the flag successful is true and the text "success" will be provided as response. In case of failure, the flag successful is false and an error message will be provided as response.
Enter your settings and send emails to several To, Cc or Bcc addresses, add several attachments and
send in plain text or HTML format to test the functionality of the Mail extension.
Q1: When I tried the .apk it gives as response javax.mail.AuthenticationFailedException 534-5.7.14?
A: To use this extension together with Gmail accounts, you have to enable less secure apps in the Google settings, see also Why do I get AuthenticationFailedException when accessing Gmail?.
Q2: Would you be able to assist me with the file location needed to send a different file in my test I am using ///storage/emulated/0/Folder/File.txt?
A: You can use a full path, which is file:///mnt/sdcard/Folder/File.txt or a relative path, which is /Folder/File.txt.
There are also blocks available to receive emails via POP3, but these are still experimental...
Returns POP3 host.
Specifies POP3 host. Default value is pop.gmail.com.
Returns POP3 port.
Specifies POP3 port. Default value is 995.
Returns the max. number of messages to check or fetch.
Specifies the max. number of messages to check or fetch. Default value is 10.
Returns directory to save attachments after fetching emails.
Specifies directory to save attachments after fetching emails. Default value is AI.
Only the following information is downloaded for each email: number, from address, subject and sentDate.
Decode a quoted-printable string, which can be found in an email address.
Example: =?utf-8?Q?Taifun_B=C3=A4r?= will be coverted to Taifun Bär.
Event indicating the progress of the checking process.
As it takes a few seconds to download the information depending on the number of emails to check, you can follow the progress of the checking process here.
Event indicating that emails have been checked.
If Check was successful, the flag 'successful' is true, 'number' will be the number of available messages and the following information will be provided in the 'response' in JSON format for each message: number, from, subject, sentDate.
Event indicating the progress of the fetching process.
As it takes a few seconds to download the information depending on the number of emails to fetch, you can follow the progress of the fetching process here.
Event indicating that emails have been fetched.
If Fetch was successful, the flag 'successful' is true and the following information will be provided in the 'response' in JSON format for each message: from, to, cc, subject, sentDate, contentType, content, attachments. To keep it simple, only the first To and Cc address will be provided (in case there is one). You can set the directory for the attachments to be stored in the property 'SaveDirectory'.
Enter your settings and check for available emails or fetch emails to test the functionality of the Mail extension.
A message including inline images
A message including an attachment
Note: Inline Images will be downloaded and stored in the folder defined in the SaveDirectory property, which is by default directory AI. The content of the email will be adjusted accordingly by the Mail extension to link to the inline images from that directory. The example app uses the webviewer to display the message. The HTML code will be passed in the Webviewstring property of the Webviewer.
Q1: I'm getting this sender address as result after receiving emails using POP3. Could you add a method to convert that?
A: These are characters outside the ASCII range, see also this stackoverflow answer. I already added a block to decode quoted printable characters (starts with "=?utf-8?Q"), what is still missing is a method to decode base64 encoded characters (starts with "=?utf-8?B"). I can add that method after having received a donation of 10 USD. Thank you.
I can help you: for one hour I charge 25 USD.
Please contact me at info [at] puravidaapps [dot] com for details!
For questions about App Inventor, please use the App Inventor forum. Thank you.
You can buy this extension (aix file).
With your payment you accept the terms and conditions below.
Please transfer 10 USD via Paypal.
After having received your payment I will be happy to send the extension (aix file) to you.
Thank you! Taifun
Please check your spam folder in case you did not receive the extension!
I usually will send the extension not later than 24 hours after having received your payment.