آموزش ارسال ایمیل در اندروید به همراه نمونه کد

قبل از شروع مقاله بهتر است تعریف تخصصی از ایمیل داشته باشیم ؛ ایمیل پیام هایی است از طریق یک وسیله الکترونیکی و توسط یک کاربر ، به یک یا چند گیرنده ، از طریقه شبکه ارسال می شود.

قبل از شروع بحث در باب اکتیویتی ای همچون ایمیل ، باید با عملکرد ایمیل توسط intent ها آشنا شوید. همانطور که می دانید intent  ها داده هایی هستند که وظیفه انتقال اطلاعات از یک جز به جز دیگر ، با کمک اپلیکیشن یا خارج از حیطه ی اپلیکیشن را بر عهده دارند.
در مقالات پیشین ، در مورد Android Intent  گفتیم که آبجکتی است که هدفی را دنبال می کند، به عنوان مثال پیامی از یک مولفه به مولفه دیگر در داخل و یا خارج از برنامه.

برای ارسال ایمیل از اپلیکیشن خود ، نیاز به ایجاد email client نیست ؛ اما می توانید از یک موجودیتی همچون اپلیکیشن ایمیل پیش فرض از اندروید مانند : Gmail،  Outlook،  K-9 Mail و غیره استفاده کنید . در راستای تحقق این هدف ، نیاز به ایجاد یک اکتیویتی دارید که email client را راه اندازی کند.  در مثالی که به شما ارائه خواهد شد ، هدف ارسال ایمیل از اپلیکیشن شما با استفاده از Intent object و راه اندازی email client می باشد .

Intent Object - Action to send Email

شما از اکشن ACTION_SEND برای آغاز یک email client نصب شده روی دستگاه اندروید خود ، استفاده خواهید کرد. در زیر ، ترکیب ساده برای ایجاد یک Intent با اکشن ACTION_SEND را مشاهده می کنید :

Intent emailIntent = new Intent(Intent.ACTION_SEND);

Intent Object - Data/Type to send Email

برای ارسال یک ایمیل باید mailto را مشخص کنید. همان طور که URI از متد ()setData استفاده می کند، و نوع داده با استفاده از متد ()setType از نوع text/plain خواهد بود، مانند زیر :

emailIntent.setData(Uri.parse("mailto:"));
emailIntent.setType("text/plain");

Intent Object - Extra to send Email

اندروید دارای پشتیبانی built-in (داخلی) برای اضافه کردن  TO ، SUBJECT، CC ، TEXT و غیره می باشد ، که می توانند قبل از ارسال intent  به email client هدف  ، بهintent ضمیمه شوند. شما می توانید از فیلد های اضافه ی زیر برای ایمیل خود استفاده کنید :

EXTRA_BCC : یک [ ]String آدرس های ایمیلی را نگه می دارد که باید نسخه ی کپی شده ی پنهان باشند.

EXTRA_CC : یک [ ]String آدرس های ایمیلی را نگه می دارد که باید نسخه ی کپی شده باشند.

EXTRA_EMAIL : یک [ ]String آدرس های ایمیلی را نگه می دارد که باید به آن ها تحویل داده شود.

EXTRA_HTML_TEXT :یک رشته ی ثابت (constant string) که با Intent در ارتباط است، و با ACTION_SEND استفاده می شود تا به محض اینکه متن HTML را فرمت کرد برای EXTRA_TEXT یک گزینه فراهم کند.

EXTRA_SUBJECT : یک رشته ی ثابت (constant string) که خط موضوع مورد نظر را از یک متن نگه می دارد.

EXTRA_TEXT : یک CharSequence ثابت که با Intent در ارتباط است، با اکشن ACTION_SEND مورد استفاده قرار می گیرد تا داده ی لیترال را برای ارسال فراهم کند.

EXTRA_TITLE : یک تیتر گفتگوی CharSequence برای ارائه به یوزر می باشد ( زمانی که با یک ACTION_CHOOSER مورد استفاده قرار می گیرد.)

در اینجا مثالی را می بینید که نشان می دهد چگونه داده ی اضافه را به Intent خود اختصاص دهید :

emailIntent.putExtra(Intent.EXTRA_EMAIL  , new String[]{"Recipient"});
emailIntent.putExtra(Intent.EXTRA_SUBJECT, "subject");
emailIntent.putExtra(Intent.EXTRA_TEXT   , "Message Body");

مثال :

مثال زیر در عمل به شما نشان می دهد که چگونه از intent object برای آغاز Email client استفاده کنید تا یک ایمیل به گیرنده های مشخص شده ارسال کنید.

برای اجرا گرفتن از این مثال به یک دستگاه موبایل مجهز شده به آخرین نسخه ی Android OS نیاز خواهید داشت، در غیر این صورت مجبور خواهید بود با امولاتوری تلاش کنید که ممکن است به درستی کار نکند و نتیجه درست را به شما بازتاب ندهد. دوم اینکه شما به یک Email client مانند Gmail یا K9mail نصب شده روی دستگاه خود نیاز خواهید داشت.

1) با استفاده از Android studio یک اپلیکیشن اندروید ایجاد کنید و آن را با عنوان clicksite تحت یک پکیج com.example.sendemaildemo قراردهید.

2) فایل src/MainActivity.java را تغییر دهید و کد مورد نیاز را برای ارسال ایمیل به آن بیفزایید.

3) فایل  layout XML را به src/MainActivity.java  تغییر دهید و کد مورد نیاز را برای ارسال ایمیل به آن بیفزایید.

4) فایل layout XML را به res/layout/activity_main.xml تغییر دهید، و هر گونه مولفه ی GUI را اگر لازم است به آن بیفزایید.

5) فایل AndroidManifest.xml را به روش شرح داده شده در زیر تغییر دهید .

6) برای آغاز امولاتور اندروید ،برنامه را اجرا کنید و نتایج تغییرات انجام شده در برنامه را بررسی کنید.

محتوای تغییر یافته فایل اصلی اکتیویتی (main activity file ) 

src/com.example.Tutorialspoint/MainActivity.java :

package com.example.clicksite;

import android.net.Uri;
import android.os.Bundle;
import android.app.Activity;
import android.content.Intent;
import android.util.Log;
import android.view.Menu;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends Activity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      Button startBtn = (Button) findViewById(R.id.sendEmail);
      startBtn.setOnClickListener(new View.OnClickListener() {
         public void onClick(View view) {
            sendEmail();
         }
      });
   }
	
   protected void sendEmail() {
      Log.i("Send email", "");
      String[] TO = {""};
      String[] CC = {""};
      Intent emailIntent = new Intent(Intent.ACTION_SEND);
      
      emailIntent.setData(Uri.parse("mailto:"));
      emailIntent.setType("text/plain");
      emailIntent.putExtra(Intent.EXTRA_EMAIL, TO);
      emailIntent.putExtra(Intent.EXTRA_CC, CC);
      emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Your subject");
      emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message goes here");
      
      try {
         startActivity(Intent.createChooser(emailIntent, "Send mail..."));
         finish();
         Log.i("Finished sending email...", "");
      } catch (android.content.ActivityNotFoundException ex) {
         Toast.makeText(MainActivity.this, "There is no email client installed.", Toast.LENGTH_SHORT).show();
      }
   }
}

 محتوای فایل res/layout/activity_main.xml را مشاهده می کنید :

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="fill_parent"
   android:layout_height="fill_parent"
   android:orientation="vertical" >
   
   <TextView
      android:id="@+id/textView1"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Sending Mail Example"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true"
      android:textSize="30dp" />
      
   <TextView
      android:id="@+id/textView2"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="click site "
      android:textColor="#ff87ff09"
      android:textSize="30dp"
      android:layout_above="@+id/imageButton"
      android:layout_alignRight="@+id/imageButton"
      android:layout_alignEnd="@+id/imageButton" />
      
   <ImageButton
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageButton"
      android:src="@drawable/abc"
      android:layout_centerVertical="true"
      android:layout_centerHorizontal="true" />
      
   <Button 
      android:id="@+id/sendEmail"
      android:layout_width="fill_parent"
      android:layout_height="wrap_content"
      android:text="@string/compose_email"/>
    
</LinearLayout>

محتوای فایل res/values/strings.xml برای تعریف دو تا از ثوابت :

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <string name="app_name">clicksite</string>
   <string name="compose_email">Compose Email</string>
</resources>

جزییات محتوای فایل AndroidManifest.xml :

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.clicksite" >
   
   <application
      android:allowBackup="true"
      android:icon="@drawable/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name="com.example.clicksite.MainActivity"
         android:label="@string/app_name" >
         
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
         
      </activity>
      
   </application>
</manifest>

اکنون از دکمه ی Compose Email استفاده کنید تا لیست همه ی email client ها را داشته باشید. از این لیست می توانید یکی از email client را انتخاب کنید تا ایمیل خود را به آن ارسال کنید. قصد داریم برای ارسال از Gmail استفاده کنیم که دارای همه ی فیلدهای پیش فرض ارائه شده خواهد بود، همانطور که در زیر مشاهده می کنید. در اینجا From: ایمیل پیش فرضی خواهد بود که برای دستگاه اندروید خود ثبت کرده اید.