(Android™) Convert HTML String to Email with Embedded Images

Converts an HTML string into an email with embedded images and sends. The HTML image may contain IMG tags with SRC attributes referencing images on the local filesystem or on the Web. The MHT component will gather all referenced images, style sheets, etc. regardless of whether they are located on the filesystem or the Web via an http or https URL.

Chilkat Android™ Downloads

Android™ Java Libraries

Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkMailMan mailman = new CkMailMan();

    // The MHT component can be used to convert an HTML page
    // from a URL, file, or in-memory HTML into an email
    // with embedded images and style sheets.
    CkMht mht = new CkMht();

    // There are two ways of embedding images in emails: with CIDs
    // and without.  When using CIDs, the IMG SRC attributes use
    // urls that begin with "cid:" and the corresponding image
    // embedded within the email includes a Content-ID header field.
    // When not using CIDs, the IMG SRC attribute can have a URL,
    // path, etc. and the corresponding image embedded within
    // the email has a matching Content-Location header field.

    // When testing with GMail, if CIDs are used the email will
    // be displayed with images blocked (by default) unless
    // the user allows them to be displayed.  Without CIDs,
    // the images are automatically displayed.

    // When testing with Eudora, Mozilla Thunderbird, and Outlook Express, 
    // embedded images display correctly with our without CIDs.

    // When testing with Yahoo! Mail, embedded images display OK.
    // However, the Yahoo! Mail user has the option of blocking
    // images.  If this is turned on, the CID images will still 
    // display correctly even though images are blocked.  Why?
    // It's because when viewing the email there is no external
    // HTTP request to fetch an image.  Therefore, a spammer 
    // cannot get an indication that you've read the email. 
    // However, if CIDs are not used, the images are blocked by 
    // any Yahoo! Mail user that has image blocking turned on --
    // even though the images are embedded.

    // I haven't tested Hotmail yet...
    // Regardless, there is no perfect solution.  If CIDs are used,
    // GMail users may block your embedded images, if CIDs are not
    // used, Yahoo! Mail users may block your embedded images.

    // I recommend setting using CIDs.  This is what Mozilla Thunderbird
    // does by default, and it's the more clear an unambiguous way
    // to indicate that images are indeed embedded.
    mht.put_UseCids(true);

    // Create an email from an HTML file.
    // Call mht.HtmlToEML to get the MIME source of an email,
    // then load it into an email object.
    CkEmail email = new CkEmail();
    String mime;
    mime = mht.htmlToEML("<html><body><p><b>Test Email</b><br><img src=\"http://www.chilkatsoft.com/images/dude.gif\"></body></html>");
    boolean success = email.SetFromMimeText(mime);

    email.put_Subject("Test HTML email");

    // This example is tested in:
    // Outlook 2000, Eudora 7, Mozilla Thunderbird 1.5.0.9, Outlook Express 6, GMail, Yahoo Mail
    success = email.AddTo("Chilkat Support","support@chilkatsoft.com");

    // Note: Chilkat does not regularly check our GMail and Yahoo
    // email accounts.  Please send support email to support@chilkatsoft.com
    success = email.AddTo("Chilkat on Yahoo","chilkat_software@yahoo.com");
    success = email.AddTo("Chilkat on GMail","chilkat.support@gmail.com");

    email.put_From("chilkat@live.com");

    // Send email using smtp.live.com
    mailman.put_SmtpHost("smtp.live.com");
    mailman.put_SmtpUsername("chilkat@live.com");
    mailman.put_SmtpPassword("myPassword");
    mailman.put_SmtpPort(587);
    mailman.put_StartTLS(true);

    // Send the email.
    success = mailman.SendEmail(email);
    if (success != true) {
        Log.i(TAG, mailman.lastErrorText());
        return;
        }

    Log.i(TAG, "HTML Email Sent!");

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}