Android™

Create Complex Email

This is an example showing how to create an email that has file attachments, contains both plain-text and HTML alternative bodies, and has embedded images within the HTML. The email is saved to a .eml file, which is a text file and can be viewed in any text editor. EML is nothing more than the MIME source of an email. In this example, you'll see that the MIME is structured in three layers of multipart content types. The outermost layer is multipart/mixed. This is typically where you'll find file attachments and attached messages. Underneath the multipart/mixed is a multipart/related envelope. Within this you'll find the "related" items -- which are the items belonging to the HTML body (images and style sheets). Underneath the multipart/related you'll find the multipart/alternative, and this contains the text/plain and text/html alternative bodies.

Chilkat Android™ Downloads

Download Chilkat for Android™

Android™

// 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);

    boolean success = false;

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

    CkEmail email = new CkEmail();

    // Adding attachments, HTML/plain-text bodies, etc can be done
    // in any order:

    // Add an attachment
    String contentType = email.addFileAttachment("hamlet.zip");
    if (email.get_LastMethodSuccess() != true) {
        Log.i(TAG, email.lastErrorText());
        return;
        }

    // Add some headers:
    email.put_Subject("This is a complex email");
    success = email.AddTo("Chilkat Support","support@chilkatsoft.com");
    email.put_From("Matt <matt@chilkatsoft.com>");

    // Add a plain-text body:
    success = email.AddPlainTextAlternativeBody("This is the plain-text body");

    // Add an image that will be embedded in the HTML body.
    String contentIdDude = email.addRelatedFile("dude.gif");
    if (email.get_LastMethodSuccess() != true) {
        Log.i(TAG, email.lastErrorText());
        return;
        }

    // Update the CONTENT_ID_DUDE to the actual content ID when sending the email.
    success = email.SetReplacePattern("CONTENT_ID_DUDE",contentIdDude);

    // Add an HTML body:
    String html;
    html = "<html><body><b>This is the HTML body</b><br><img src=\"cid:CONTENT_ID_DUDE\"></body></html>";

    success = email.AddHtmlAlternativeBody(html);

    // Save the email as a .eml

    success = email.SaveEml("complex.eml");
    if (success != true) {
        Log.i(TAG, email.lastErrorText());
        }
    else {
        Log.i(TAG, "Created email!");
        }


  }

  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."
  }
}