【Android】JavaMail APIを使用してメールを送信する方法を解説

はじめに

この記事では、JavaMail APIを使用してAndroidアプリからメールを送信する方法を、ステップごとに詳しく解説します。画面に入力した宛先・件名・本文をもとに、GmailのSMTPサーバー経由でメールを送信するシンプルなサンプルアプリを作成していきます。

手順1：新規プロジェクトの作成

Android Studioを起動し、「File」→「New Project」を選択して、必要事項を入力して新しいプロジェクトを作成します。

手順2：レイアウトファイル（activity_main.xml）の作成

res/layout/activity_main.xmlに以下のコードを記述します。宛先メールアドレス・件名・本文の入力欄と、送信ボタンを縦に並べたシンプルなレイアウトです。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
   xmlns:app="https://schemas.android.com/apk/res-auto"
   xmlns:tools="https://schemas.android.com/tools"
   android:orientation="vertical"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".MainActivity">
   <TextView
      android:text="Recipient Email"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content" />
   <EditText
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:id="@+id/editTextEmail" />
   <TextView
      android:text="Subject"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content" />
   <EditText
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:id="@+id/editTextSubject" />
   <TextView
      android:text="Message"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content" />
   <EditText
      android:lines="4"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:id="@+id/editTextMessage" />
   <Button
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:id="@+id/buttonSend"
      android:text="Send"/>
</LinearLayout>

手順3：MainActivity.javaの実装

src/MainActivity.javaに以下のコードを記述します。各ビューへの参照を取得し、送信ボタンがタップされたタイミングでメール送信処理を呼び出す構成になっています。

package com.app.sample;
import androidx.appcompat.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import java.util.Properties;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import android.os.Bundle;
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
   private EditText editTextEmail;
   private EditText editTextSubject;
   private EditText editTextMessage;
   private Button buttonSend;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      editTextEmail = (EditText) findViewById(R.id.editTextEmail);
      editTextSubject = (EditText) findViewById(R.id.editTextSubject);
      editTextMessage = (EditText) findViewById(R.id.editTextMessage);
      buttonSend = (Button) findViewById(R.id.buttonSend);
      buttonSend.setOnClickListener(this);
   }
   private void sendEmail() {
      String email = editTextEmail.getText().toString().trim();
      String subject = editTextSubject.getText().toString().trim();
      String message = editTextMessage.getText().toString().trim();
      SendMail sm = new SendMail(this, email, subject, message);
      sm.execute();
   }
   @Override
   public void onClick(View v) {
      sendEmail();
   }
}

手順4：Config.javaの作成

送信元となるGmailアカウントの情報を一元管理するためのConfigクラスを作成します。src/Config.javaに以下のコードを記述し、「your-gmail-username」「your-gmail-password」の部分をご自身のGmailアカウントのユーザー名とパスワードに置き換えてください。

package com.app.sample;
public class Config {
   public static final String EMAIL ="your-gmail-username";
   public static final String PASSWORD ="your-gmail-password";
}

手順5：SendMail.javaの実装

メール送信はネットワーク通信を伴うため、メインスレッド上で直接実行することはできません。そこでAsyncTaskを継承したSendMailクラスを作成し、バックグラウンドで送信処理を行います。src/SendMail.javaに以下のコードを記述してください。

package com.app.sample;
import android.app.ProgressDialog;
import android.content.Context;
import android.os.AsyncTask;
import android.widget.Toast;
import java.util.Properties;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
public class SendMail extends AsyncTask{
   private Context context;
   private Session session;
   private String email;
   private String subject;
   private String message;
   private ProgressDialog progressDialog;
   public SendMail(Context context, String email, String subject, String message){
      this.context = context;
      this.email = email;
      this.subject = subject;
      this.message = message;
   }
   @Override
   protected void onPreExecute() {
      super.onPreExecute();
      progressDialog = ProgressDialog.show(context,"Sending message","Please wait...",false,false);
   }
   @Override
   protected void onPostExecute(Void aVoid) {
      super.onPostExecute(aVoid);
      progressDialog.dismiss();
      Toast.makeText(context,"Message Sent",Toast.LENGTH_LONG).show();
   }
   @Override
   protected Void doInBackground(Void... params) {
      Properties props = new Properties();
      props.put("mail.smtp.host", "smtp.gmail.com");
      props.put("mail.smtp.socketFactory.port", "465");
      props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
      props.put("mail.smtp.auth", "true");
      props.put("mail.smtp.port", "465");
      session = Session.getDefaultInstance(props, new javax.mail.Authenticator() {
         protected PasswordAuthentication getPasswordAuthentication() {
            return new PasswordAuthentication(Config.EMAIL, Config.PASSWORD);
         }
      });
      try {
         MimeMessage mm = new MimeMessage(session);
         mm.setFrom(new InternetAddress(Config.EMAIL));
         mm.addRecipient(Message.RecipientType.TO, new InternetAddress(email));
         mm.setSubject(subject);
         mm.setText(message);
         Transport.send(mm);
      }
      catch (MessagingException e) {
         e.printStackTrace();
      }
      return null;
   }
}

手順6：AndroidManifest.xmlの設定

インターネット通信を行うため、Manifests/AndroidManifest.xmlにINTERNETパーミッションを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.app.sample">
   <uses-permission android:name="android.permission.INTERNET"/>
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:supportsRtl="true"
      android:theme="@style/AppTheme">
      <activity android:name=".MainActivity">
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>
</manifest>

アプリの実行

それでは、実際にアプリを実行してみましょう。実機のAndroidスマートフォンをパソコンに接続していることを前提としています。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。接続したモバイルデバイスを選択して実行すると、スマートフォンに以下のような画面が表示されます。

補足：JavaMailライブラリの追加とGmailの設定について

JavaMail APIを利用するには、mail.jar・activation.jar・additionnal.jarなどのライブラリをプロジェクトに追加する必要があります。appフォルダ内のlibsディレクトリにjarファイルを配置し、build.gradleのdependenciesブロックに依存関係を追記してください。

また、GmailのSMTPサーバー経由で送信する場合は、Googleアカウントのセキュリティ設定で「安全性の低いアプリのアクセス」を許可するか、2段階認証プロセスを有効にした上でアプリパスワードを発行して使用する必要がある点にご注意ください。これらの設定を怠ると、認証エラーが発生してメールを送信できません。