【Android】ファイルを添付したメールを送信する方法を徹底解説

はじめに

Androidアプリからファイル（画像など）を添付したメールを送信したいと思ったことはありませんか？本記事では、宛先・件名・本文の入力フォームと添付ボタンを備えたシンプルなメール送信機能を、サンプルコードとともに段階的に解説します。手順通りに実装すれば、端末内のファイルを選択し、標準のメールアプリ経由で添付メールを送れるようになります。

ステップ1：新規プロジェクトの作成

まず、Android Studioで新しいプロジェクトを作成します。メニューから「File → New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成してください。

ステップ2：レイアウトファイル（activity_main.xml）の作成

次に、res/layout/activity_main.xml に以下のコードを記述します。このレイアウトには、宛先用・件名用・本文用の3つのEditText、「送信」ボタン、「添付」ボタン、そして選択された添付ファイル名を表示するTextViewが含まれています。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
   xmlns:android="https://schemas.android.com/apk/res/android"
   xmlns:tools="https://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:orientation="vertical"
   android:padding="4dp"
   tools:context=".MainActivity">
   <EditText
      android:id="@+id/etTo"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_margin="5dp"
      android:hint="Receiver's Email Address!"
      android:inputType="textEmailAddress"
      android:singleLine="true" />
   <EditText
      android:id="@+id/etSubject"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_margin="5dp"
      android:hint="Enter Subject"
      android:singleLine="true" />
   <EditText
      android:id="@+id/etMessage"
      android:layout_width="match_parent"
      android:layout_height="200dp"
      android:layout_margin="5dp"
      android:gravity="top|start"
      android:hint="Compose Email"
      android:inputType="textMultiLine" />
   <RelativeLayout
      android:layout_width="match_parent"
      android:layout_height="wrap_content">
   <Button
      android:id="@+id/btSend"
      android:layout_width="80dp"
      android:layout_height="50dp"
      android:layout_margin="5dp"
      android:text="Send" />
   <Button
      android:id="@+id/btAttachment"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignParentEnd="true"
      android:text="attachment" />
   </RelativeLayout>
   <TextView
      android:id="@+id/tvAttachment"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:drawableStart="@drawable/ic_attach"
      android:visibility="gone" />
</LinearLayout>

ステップ3：MainActivity.javaの実装

続いて、src/MainActivity.java に以下のコードを記述します。ポイントは次の2つです。

• openFolder() メソッド：ACTION_GET_CONTENT インテントを使ってギャラリー（ストレージ）を開き、ユーザーにファイルを選択させます。
• sendEmail() メソッド：ACTION_SEND インテントに宛先・件名・本文をセットし、添付ファイルが選択されていれば EXTRA_STREAM でUriを渡します。最後に createChooser() を呼び出すことで、インストール済みのメールアプリ一覧が表示されます。

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends Activity {
   EditText etEmail;
   EditText etSubject;
   EditText etMessage;
   Button Send;
   Button attachment;
   TextView tvAttachment;
   String email;
   String subject;
   String message;
   Uri URI = null;
   private static final int PICK_FROM_GALLERY = 101;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      etEmail = findViewById(R.id.etTo);
      etSubject = findViewById(R.id.etSubject);
      etMessage = findViewById(R.id.etMessage);
      attachment = findViewById(R.id.btAttachment);
      tvAttachment = findViewById(R.id.tvAttachment);
      Send = findViewById(R.id.btSend);
      Send.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            sendEmail();
         }
      });
      //attachment button listener
      attachment.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            openFolder();
         }
      });
   }
   protected void onActivityResult(int requestCode, int resultCode, Intent data) {
      if (requestCode == PICK_FROM_GALLERY && resultCode == RESULT_OK) {
         URI = data.getData();
         tvAttachment.setText(URI.getLastPathSegment());
         tvAttachment.setVisibility(View.VISIBLE);
      }
   }
   public void sendEmail() {
      try {
         email = etEmail.getText().toString();
         subject = etSubject.getText().toString();
         message = etMessage.getText().toString();
         final Intent emailIntent = new Intent(android.content.Intent.ACTION_SEND);
         emailIntent.setType("plain/text");
         emailIntent.putExtra(android.content.Intent.EXTRA_EMAIL, new String[]{email});
         emailIntent.putExtra(android.content.Intent.EXTRA_SUBJECT, subject);
         if (URI != null) {
            emailIntent.putExtra(Intent.EXTRA_STREAM, URI);
         }
         emailIntent.putExtra(android.content.Intent.EXTRA_TEXT, message);
         this.startActivity(Intent.createChooser(emailIntent, "Sending email..."));
      } catch (Throwable t) {
         Toast.makeText(this, "Request failed try again: "+ t.toString(), Toast.LENGTH_LONG).show();
      }
   }
   public void openFolder() {
      Intent intent = new Intent();
      intent.setType("image/*");
      intent.setAction(Intent.ACTION_GET_CONTENT);
      intent.putExtra("return-data", true);
      startActivityForResult(Intent.createChooser(intent, "Complete action using"), PICK_FROM_GALLERY);
   }
}

ステップ4：AndroidManifest.xmlへの権限追加

最後に、androidManifest.xml にインターネット通信およびストレージ読み取りのためのパーミッションを追加します。これらの権限がないと、メール送信やファイルの取得が正しく動作しない場合があります。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.READ_INTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <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スマートフォンがPCに接続されているものとして説明します。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。デバイス選択画面で自分のスマートフォンを選ぶと、端末に以下のような画面が表示されます。

補足：より新しい実装方法について

上記のコードは古いバージョンのAndroidでも動作する定番の書き方ですが、近年のAndroid開発では以下の点に注意するとより安全です。

• ActivityResult API の利用：startActivityForResult() および onActivityResult() は非推奨となっているため、AndroidXの ActivityResultContracts.GetContent() を使うと、より簡潔かつ安全にファイル選択を実装できます。
• FileProvider の活用：アプリ内部ストレージのファイルを添付する場合は、Android 7.0（Nougat）以降では FileProvider 経由で content:// 形式のUriを渡す必要があります。
• MIMEタイプの指定：テキストメールの場合は "text/plain" を指定するのが一般的です。

これらのポイントを押さえておけば、最新のAndroid環境でも安定して添付メール送信機能を実装できます。ぜひ本記事のサンプルをベースに、自分のアプリに合わせてカスタマイズしてみてください。