Android - Email 发送电子邮件
Email 电子邮件是通过网络从一个系统用户以电子方式分发给一个或多个收件人的消息。
在启动 Email 活动之前,您必须了解带有意图的电子邮件功能,Intent 是将数据从一个组件传送到应用程序内部或应用程序外部的另一个组件。
要从您的应用程序发送电子邮件,您不必从一开始就实现电子邮件客户端,但您可以使用现有的客户端,例如 Android、Gmail、Outlook、K-9 Mail 等提供的默认电子邮件应用程序。为此 为此,我们需要编写一个启动电子邮件客户端的活动,使用具有正确操作和数据的隐式 Intent。 在此示例中,我们将使用启动现有电子邮件客户端的 Intent 对象从我们的应用程序发送一封电子邮件。
以下部分解释了发送电子邮件所需的 Intent 对象的不同部分。
Intent 对象 - 发送电子邮件的操作
您将使用 ACTION_SEND 操作来启动安装在您的 Android 设备上的电子邮件客户端。 以下是使用 ACTION_SEND 操作创建意图的简单语法。
Intent emailIntent = new Intent(Intent.ACTION_SEND);
Intent 意图对象 - 发送电子邮件的数据/类型
要发送电子邮件,您需要使用 setData() 方法将 mailto: 指定为 URI,数据类型将是使用 setType() 方法的 text/plain,如下所示 −
emailIntent.setData(Uri.parse("mailto:")); emailIntent.setType("text/plain");
Intent 意图对象 - 额外发送电子邮件
Android 内置支持添加 TO、SUBJECT、CC、TEXT 等字段,这些字段可以在将意图发送到目标电子邮件客户端之前附加到意图。 您可以在电子邮件中使用以下额外字段 −
序号 | 额外数据 & 描述 |
---|---|
1 |
EXTRA_BCC 一个 String[] 包含应该被密送的电子邮件地址。 |
2 |
EXTRA_CC 一个 String[] 包含应该被抄送的电子邮件地址。 |
3 |
EXTRA_EMAIL 一个 String[] 包含应发送到的电子邮件地址。 |
4 |
EXTRA_HTML_TEXT 与 Intent 关联的常量字符串,与 ACTION_SEND 一起使用以提供作为 HTML 格式文本的 EXTRA_TEXT 的替代项。 |
5 |
EXTRA_SUBJECT 包含所需消息主题行的常量字符串。 |
6 |
EXTRA_TEXT 与 Intent 关联的常量 CharSequence,与 ACTION_SEND 一起使用以提供要发送的文字数据。 |
7 |
EXTRA_TITLE 与 ACTION_CHOOSER 一起使用时提供给用户的 CharSequence 对话框标题。 |
这是一个示例,向您展示如何为您的意图分配额外的数据 −
emailIntent.putExtra(Intent.EXTRA_EMAIL , new String[]{"Recipient"}); emailIntent.putExtra(Intent.EXTRA_SUBJECT, "subject"); emailIntent.putExtra(Intent.EXTRA_TEXT , "Message Body");
The out-put of above code is as below shown an image
Email Example
示例
以下示例向您展示了如何使用 Intent 对象启动电子邮件客户端以将电子邮件发送给给定的收件人。
要使用此示例进行电子邮件实验,您将需要配备最新 Android 操作系统的实际移动设备,否则您可能会遇到无法正常工作的模拟器。 其次,您需要在您的设备上安装一个电子邮件客户端,如 GMail(默认情况下,每个 android 版本都有 Gmail 客户端应用程序)或 K9mail。
步骤 | 描述 |
---|---|
1 | 您将使用 Android Studio 创建一个 Android 应用程序,并将其命名为 Tutorialspoint,位于包 com.example.tutorialspoint 下。 |
2 | 修改 src/MainActivity.java 文件并添加所需的代码来处理发送电子邮件。 |
3 | 修改布局 XML 文件 res/layout/activity_main.xml 添加任何 GUI 组件(如果需要)。 我正在添加一个简单的按钮来启动电子邮件客户端。 |
4 | 修改 res/values/strings.xml 以定义所需的常量值 |
5 | 修改AndroidManifest.xml如下图 |
6 | 运行应用程序以启动 Android 模拟器并验证应用程序中所做更改的结果。 |
以下是修改后的主活动文件src/com.example.Tutorialspoint/MainActivity.java的内容。
package com.example.tutorialspoint; 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 文件的内容 −
这里 abc 表示关于 tutorialspoint 的标志
<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="Tutorials point " 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">Tutorialspoint</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.Tutorialspoint" > <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="com.example.tutorialspoint.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>
让我们尝试运行您的 tutorialspoint 应用程序。 我假设您已将实际的 Android 移动设备与您的计算机连接起来。 要从 Android Studio 运行应用程序,请打开项目的活动文件之一,然后单击工具栏中的 Run 图标。在启动您的应用程序之前,Android Studio 安装程序将显示以下窗口以选择您要运行 Android 应用程序的选项。选择您的移动设备作为选项,然后检查您的移动设备,它将显示以下屏幕 −
现在使用 Compose Email 撰写电子邮件按钮列出所有已安装的电子邮件客户端。从列表中,您可以选择一个电子邮件客户端来发送您的电子邮件。 我将使用 Gmail 客户端发送我的电子邮件,其中包含所有提供的默认字段,如下所示。 这里的 From: 将是您为 Android 设备注册的默认电子邮件 ID。
您可以修改任一给定的默认字段,最后使用发送电子邮件按钮将您的电子邮件发送给上述收件人。