在Android中使用JavaMail API发送电子邮件而无需使用默认/内置应用程序

699
我试图在Android中创建一个发送邮件的应用程序。
如果我使用:
Intent emailIntent = new Intent(android.content.Intent.ACTION_SEND);

这将启动内置的Android应用程序;我正在尝试在按钮点击时直接发送邮件,而不使用该应用程序。

这会启动内置的 Android 应用程序;我想在按钮单击时直接发送电子邮件,而无需使用该应用程序。


3
发送电子邮件时出现javax.mail.AuthenticationFailedException异常,即使用户名/密码是正确的。 有什么解决办法吗? - T D Nguyen
1
请注意,从1.5.5版本开始,JavaMail声称支持Android。 - artbristol
1
SendGrid不是一个选项吗?据我所知,您还可以获取发送的电子邮件的统计信息。 - Stamatis Stiliats
SendGrid对Android存在一些严重的问题(尚未解决)。 - Abhishek
25个回答

789

使用JavaMail API和Gmail身份验证在Android中发送电子邮件。

创建示例项目的步骤:

MailSenderActivity.java:

public class MailSenderActivity extends Activity {
    
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        final Button send = (Button) this.findViewById(R.id.send);
        send.setOnClickListener(new View.OnClickListener() {
            
            public void onClick(View v) {
                try {   
                    GMailSender sender = new GMailSender("username@gmail.com", "password");
                    sender.sendMail("This is Subject",   
                            "This is Body",   
                            "user@gmail.com",   
                            "user@yahoo.com");   
                } catch (Exception e) {   
                    Log.e("SendMail", e.getMessage(), e);   
                } 
                
            }
        });
        
    }
}

GMailSender.java:

public class GMailSender extends javax.mail.Authenticator {   
    private String mailhost = "smtp.gmail.com";   
    private String user;   
    private String password;   
    private Session session;   
  
    static {   
        Security.addProvider(new com.provider.JSSEProvider());   
    }  
  
    public GMailSender(String user, String password) {   
        this.user = user;   
        this.password = password;   
  
        Properties props = new Properties();   
        props.setProperty("mail.transport.protocol", "smtp");   
        props.setProperty("mail.host", mailhost);   
        props.put("mail.smtp.auth", "true");   
        props.put("mail.smtp.port", "465");   
        props.put("mail.smtp.socketFactory.port", "465");   
        props.put("mail.smtp.socketFactory.class",   
                "javax.net.ssl.SSLSocketFactory");   
        props.put("mail.smtp.socketFactory.fallback", "false");   
        props.setProperty("mail.smtp.quitwait", "false");   
  
        session = Session.getDefaultInstance(props, this);   
    }   
  
    protected PasswordAuthentication getPasswordAuthentication() {   
        return new PasswordAuthentication(user, password);   
    }   
  
    public synchronized void sendMail(String subject, String body, String sender, String recipients) throws Exception {   
        try{
        MimeMessage message = new MimeMessage(session);   
        DataHandler handler = new DataHandler(new ByteArrayDataSource(body.getBytes(), "text/plain"));   
        message.setSender(new InternetAddress(sender));   
        message.setSubject(subject);   
        message.setDataHandler(handler);   
        if (recipients.indexOf(',') > 0)   
            message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(recipients));   
        else  
            message.setRecipient(Message.RecipientType.TO, new InternetAddress(recipients));   
        Transport.send(message);   
        }catch(Exception e){
            
        }
    }   
  
    public class ByteArrayDataSource implements DataSource {   
        private byte[] data;   
        private String type;   
  
        public ByteArrayDataSource(byte[] data, String type) {   
            super();   
            this.data = data;   
            this.type = type;   
        }   
  
        public ByteArrayDataSource(byte[] data) {   
            super();   
            this.data = data;   
        }   
  
        public void setType(String type) {   
            this.type = type;   
        }   
  
        public String getContentType() {   
            if (type == null)   
                return "application/octet-stream";   
            else  
                return type;   
        }   
  
        public InputStream getInputStream() throws IOException {   
            return new ByteArrayInputStream(data);   
        }   
  
        public String getName() {   
            return "ByteArrayDataSource";   
        }   
  
        public OutputStream getOutputStream() throws IOException {   
            throw new IOException("Not Supported");   
        }   
    }   
}  

JSSEProvider.java:

/*
 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF licenses this file to You under the Apache License, Version 2.0
 *  (the "License"); you may not use this file except in compliance with
 *  the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

/**
 * @author Alexander Y. Kleymenov
 * @version $Revision$
 */


import java.security.AccessController;
import java.security.Provider;

public final class JSSEProvider extends Provider {

    public JSSEProvider() {
        super("HarmonyJSSE", 1.0, "Harmony JSSE Provider");
        AccessController.doPrivileged(new java.security.PrivilegedAction<Void>() {
            public Void run() {
                put("SSLContext.TLS",
                        "org.apache.harmony.xnet.provider.jsse.SSLContextImpl");
                put("Alg.Alias.SSLContext.TLSv1", "TLS");
                put("KeyManagerFactory.X509",
                        "org.apache.harmony.xnet.provider.jsse.KeyManagerFactoryImpl");
                put("TrustManagerFactory.X509",
                        "org.apache.harmony.xnet.provider.jsse.TrustManagerFactoryImpl");
                return null;
            }
        });
    }
}

请将以下三个JAR文件添加到您的Android项目中。

如果您不知道如何操作,请查看this的帖子。

并且不要忘记在您的清单中添加以下行:

<uses-permission android:name="android.permission.INTERNET" />

通过访问此链接,调整您的帐户访问设置以使用不太安全的应用程序:

https://www.google.com/settings/security/lesssecureapps


更新 2023: 不再支持使用较不安全的应用程序。要访问您的帐户,您需要启用双因素身份验证,并使用下面图片中提供的设置使用应用程序密码:

How to create Temporary Password


运行项目并检查您的收件人邮件帐户以查看邮件。

P.S.:请记住,在Android中直接从Activity执行网络操作是不允许的。因此,强烈建议使用AsyncTaskIntentService以避免遇到主线程上的网络异常。

Jar文件:https://code.google.com/archive/p/javamail-android/


56
你的代码似乎使用了硬编码的用户名和密码。这是当前存在的安全风险吗(也就是说,上传到应用市场的apk文件是否已被反编译)? - Rich
11
为我工作!不要忘记在您的应用程序清单中添加uses-permission INTERNET权限。 - Avi Shukron
20
有没有办法在不将密码放入代码的情况下发送电子邮件?如果我要求用户提供他们的电子邮件密码,他们可能会感到惊讶... - pumpkee
7
谢谢您提供的代码。但是在Mailsenderactivity上使用GMailSender sender = new GMailSender(...)时,我遇到了java.lang.NoClassDefFoundError错误。我已经添加了所有的JAR文件并将它们加入了构建路径,但仍无法解决问题。请帮帮我。 - M.A.Murali
60
有人抱怨/询问如何获取用户密码——这不是本意。这是用于您(开发者)的电子邮件账户。如果您想依赖用户的电子邮件账户,应使用电子邮件意图,在其他帖子中广泛讨论过。 - Tom
显示剩余78条评论

73

感谢您提供宝贵的信息。代码正常运行。通过添加以下代码,我也能够添加附件。

private Multipart _multipart; 
_multipart = new MimeMultipart(); 

public void addAttachment(String filename,String subject) throws Exception { 
    BodyPart messageBodyPart = new MimeBodyPart(); 
    DataSource source = new FileDataSource(filename); 
    messageBodyPart.setDataHandler(new DataHandler(source)); 
    messageBodyPart.setFileName(filename); 
    _multipart.addBodyPart(messageBodyPart);

    BodyPart messageBodyPart2 = new MimeBodyPart(); 
    messageBodyPart2.setText(subject); 

    _multipart.addBodyPart(messageBodyPart2); 
} 



message.setContent(_multipart);

6
请将以下代码添加至GmailSender.java文件中。 - Garbage
当我调用setcontent时,它覆盖了我的正文内容。我做错了什么吗?我想在其他文本正文内容中添加附件。 - Calvin
1
在这里,对于filename变量,您必须指定文件路径。例如:String path = Environment.getExternalStorageDirectory().getPath() + "/temp_share.jpg"; - user6649667
这段代码可以帮助您添加多个文件 https://dev59.com/4nA75IYBdhLWcg3wqK10#3177640 ;) :) - AndroidManifester

58

无法连接到SMTP主机: smtp.gmail.com,端口:465

在您的清单文件中添加此行:

<uses-permission android:name="android.permission.INTERNET" />

40
您可以使用JavaMail API来处理电子邮件任务。 JavaMail API可在JavaEE软件包中使用,其jar文件可供下载。不幸的是,由于JavaMail API使用与Android不兼容的AWT组件,因此无法直接在Android应用程序中使用。
您可以在以下位置找到JavaMail的Android端口: http://code.google.com/p/javamail-android/ 将JAR文件添加到您的应用程序中并使用SMTP方法。

1
有任何Maven仓库可以使用吗? - user1050755
抱歉,我不知道那个。 - Kshitij Aggarwal
6
我已经将最新的JavaMail移植过来,并且它可以在Maven Central上使用,路径为eu.ocathain.com.sun.mail:javax.mail:1.5.2 - artbristol

31

为了帮助那些在SDK Target > 9中遇到网络主线程异常的人。这是使用droopie上面的代码,但对于任何其他类似情况也适用。

StrictMode.ThreadPolicy policy = new StrictMode.ThreadPolicy.Builder().permitAll().build();

StrictMode.setThreadPolicy(policy); 

android.os.NetworkOnMainThreadException

您可以按以下方式使用AsyncTask

public void onClickMail(View view) {
    new SendEmailAsyncTask().execute();
}

class SendEmailAsyncTask extends AsyncTask <Void, Void, Boolean> {
    Mail m = new Mail("from@gmail.com", "my password");

    public SendEmailAsyncTask() {
        if (BuildConfig.DEBUG) Log.v(SendEmailAsyncTask.class.getName(), "SendEmailAsyncTask()");
        String[] toArr = { "to mail@gmail.com"};
        m.setTo(toArr);
        m.setFrom("from mail@gmail.com");
        m.setSubject("Email from Android");
        m.setBody("body.");
    }

    @Override
    protected Boolean doInBackground(Void... params) {
        if (BuildConfig.DEBUG) Log.v(SendEmailAsyncTask.class.getName(), "doInBackground()");
        try {
            m.send();
            return true;
        } catch (AuthenticationFailedException e) {
            Log.e(SendEmailAsyncTask.class.getName(), "Bad account details");
            e.printStackTrace();
            return false;
        } catch (MessagingException e) {
            Log.e(SendEmailAsyncTask.class.getName(), m.getTo(null) + "failed");
            e.printStackTrace();
            return false;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }

24

SMTP

使用SMTP是一种方法,其他人已经指出了如何执行此操作的方式。请注意,在执行此操作时,您完全绕过了内置邮件应用程序,并且必须提供SMTP服务器的地址、该服务器的用户名和密码,无论是在代码中静态地提供还是从用户查询获取。

HTTP

另一种方法涉及一个简单的服务器端脚本,例如php,它需要一些URL参数并使用它们发送邮件。这种方式,您只需从设备进行HTTP请求(可以轻松地通过内置库完成),而不需要在设备上存储SMTP登录数据。与直接使用SMTP相比,这是更多的间接性,但由于使用PHP轻松地进行HTTP请求并发送邮件,甚至可能比直接使用SMTP更简单。

邮件应用程序

如果要从用户已经在手机上注册的默认邮件帐户发送邮件,则必须采取其他方法。如果您有足够的时间和经验,您可能希望检查Android电子邮件应用程序的源代码,以查看是否提供了某个入口点以在没有用户交互的情况下发送电子邮件(我不知道,但也许会有一个)。也许您甚至可以找到一种方法来查询用户帐户详细信息(因此您可以将其用于SMTP),尽管我极度怀疑这是可能的,因为这将是一个巨大的安全风险,而Android构建得相当安全。


23

这里有一个备选版本,对我也起作用,并且有附件(已经在上面发布过了,但是完整版本,不像源链接,人们说它缺少数据,无法正常工作)。

import java.util.Date; 
import java.util.Properties; 
import javax.activation.CommandMap; 
import javax.activation.DataHandler; 
import javax.activation.DataSource; 
import javax.activation.FileDataSource; 
import javax.activation.MailcapCommandMap; 
import javax.mail.BodyPart; 
import javax.mail.Multipart; 
import javax.mail.PasswordAuthentication; 
import javax.mail.Session; 
import javax.mail.Transport; 
import javax.mail.internet.InternetAddress; 
import javax.mail.internet.MimeBodyPart; 
import javax.mail.internet.MimeMessage; 
import javax.mail.internet.MimeMultipart; 


public class Mail extends javax.mail.Authenticator { 
  private String _user; 
  private String _pass; 

  private String[] _to; 
  private String _from; 

  private String _port; 
  private String _sport; 

  private String _host; 

  private String _subject; 
  private String _body; 

  private boolean _auth; 

  private boolean _debuggable; 

  private Multipart _multipart; 


  public Mail() { 
    _host = "smtp.gmail.com"; // default smtp server 
    _port = "465"; // default smtp port 
    _sport = "465"; // default socketfactory port 

    _user = ""; // username 
    _pass = ""; // password 
    _from = ""; // email sent from 
    _subject = ""; // email subject 
    _body = ""; // email body 

    _debuggable = false; // debug mode on or off - default off 
    _auth = true; // smtp authentication - default on 

    _multipart = new MimeMultipart(); 

    // There is something wrong with MailCap, javamail can not find a handler for the multipart/mixed part, so this bit needs to be added. 
    MailcapCommandMap mc = (MailcapCommandMap) CommandMap.getDefaultCommandMap(); 
    mc.addMailcap("text/html;; x-java-content-handler=com.sun.mail.handlers.text_html"); 
    mc.addMailcap("text/xml;; x-java-content-handler=com.sun.mail.handlers.text_xml"); 
    mc.addMailcap("text/plain;; x-java-content-handler=com.sun.mail.handlers.text_plain"); 
    mc.addMailcap("multipart/*;; x-java-content-handler=com.sun.mail.handlers.multipart_mixed"); 
    mc.addMailcap("message/rfc822;; x-java-content-handler=com.sun.mail.handlers.message_rfc822"); 
    CommandMap.setDefaultCommandMap(mc); 
  } 

  public Mail(String user, String pass) { 
    this(); 

    _user = user; 
    _pass = pass; 
  } 

  public boolean send() throws Exception { 
    Properties props = _setProperties(); 

    if(!_user.equals("") && !_pass.equals("") && _to.length > 0 && !_from.equals("") && !_subject.equals("") && !_body.equals("")) { 
      Session session = Session.getInstance(props, this); 

      MimeMessage msg = new MimeMessage(session); 

      msg.setFrom(new InternetAddress(_from)); 

      InternetAddress[] addressTo = new InternetAddress[_to.length]; 
      for (int i = 0; i < _to.length; i++) { 
        addressTo[i] = new InternetAddress(_to[i]); 
      } 
        msg.setRecipients(MimeMessage.RecipientType.TO, addressTo); 

      msg.setSubject(_subject); 
      msg.setSentDate(new Date()); 

      // setup message body 
      BodyPart messageBodyPart = new MimeBodyPart(); 
      messageBodyPart.setText(_body); 
      _multipart.addBodyPart(messageBodyPart); 

      // Put parts in message 
      msg.setContent(_multipart); 

      // send email 
      Transport.send(msg); 

      return true; 
    } else { 
      return false; 
    } 
  } 

  public void addAttachment(String filename) throws Exception { 
    BodyPart messageBodyPart = new MimeBodyPart(); 
    DataSource source = new FileDataSource(filename); 
    messageBodyPart.setDataHandler(new DataHandler(source)); 
    messageBodyPart.setFileName(filename); 

    _multipart.addBodyPart(messageBodyPart); 
  } 

  @Override 
  public PasswordAuthentication getPasswordAuthentication() { 
    return new PasswordAuthentication(_user, _pass); 
  } 

  private Properties _setProperties() { 
    Properties props = new Properties(); 

    props.put("mail.smtp.host", _host); 

    if(_debuggable) { 
      props.put("mail.debug", "true"); 
    } 

    if(_auth) { 
      props.put("mail.smtp.auth", "true"); 
    } 

    props.put("mail.smtp.port", _port); 
    props.put("mail.smtp.socketFactory.port", _sport); 
    props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory"); 
    props.put("mail.smtp.socketFactory.fallback", "false"); 

    return props; 
  } 

  // the getters and setters 
  public String getBody() { 
    return _body; 
  } 

  public void setBody(String _body) { 
    this._body = _body; 
  }

  public void setTo(String[] toArr) {
      // TODO Auto-generated method stub
      this._to=toArr;
  }

  public void setFrom(String string) {
      // TODO Auto-generated method stub
      this._from=string;
  }

  public void setSubject(String string) {
      // TODO Auto-generated method stub
      this._subject=string;
  }  

  // more of the getters and setters ….. 
}

并在活动中调用它...

@Override 
public void onCreate(Bundle icicle) { 
  super.onCreate(icicle); 
  setContentView(R.layout.main); 

  Button addImage = (Button) findViewById(R.id.send_email); 
  addImage.setOnClickListener(new View.OnClickListener() { 
    public void onClick(View view) { 
      Mail m = new Mail("gmailusername@gmail.com", "password"); 

      String[] toArr = {"bla@bla.com", "lala@lala.com"}; 
      m.setTo(toArr); 
      m.setFrom("wooo@wooo.com"); 
      m.setSubject("This is an email sent using my Mail JavaMail wrapper from an Android device."); 
      m.setBody("Email body."); 

      try { 
        m.addAttachment("/sdcard/filelocation"); 

        if(m.send()) { 
          Toast.makeText(MailApp.this, "Email was sent successfully.", Toast.LENGTH_LONG).show(); 
        } else { 
          Toast.makeText(MailApp.this, "Email was not sent.", Toast.LENGTH_LONG).show(); 
        } 
      } catch(Exception e) { 
        //Toast.makeText(MailApp.this, "There was a problem sending the email.", Toast.LENGTH_LONG).show(); 
        Log.e("MailApp", "Could not send email", e); 
      } 
    } 
  }); 
} 

@KeyLimePiePhotonAndroid 在你的清单文件中添加网络权限。 - 0xC0DED00D
如果我想使用我的组织的其他电子邮件客户端,如何使用此代码?仅更改主机名和端口是否足够? - roger_that
出现javax.mail.AuthenticationFailedException错误,我该怎么办? - vijay
2
对于 javax.mail.AuthenticationFailedException 异常,您需要打开此设置 https://www.google.com/settings/security/lesssecureapps - Razel Soco
1
为了解决Could not send email android.os.NetworkOnMainThreadException at android.os.StrictMode$AndroidBlockGuardPolicy.onNetwork问题,需要查看此解决方案:https://dev59.com/Deo6XIcBkEYKwwoYIAsf - jgrocha
显示剩余2条评论

18

GmailBackground是一个小型库,可在没有用户交互的情况下后台发送电子邮件:

用法:

    BackgroundMail.newBuilder(this)
            .withUsername("username@gmail.com")
            .withPassword("password12345")
            .withMailto("toemail@gmail.com")
            .withType(BackgroundMail.TYPE_PLAIN)
            .withSubject("this is the subject")
            .withBody("this is the body")
            .withOnSuccessCallback(new BackgroundMail.OnSuccessCallback() {
                @Override
                public void onSuccess() {
                    //do some magic
                }
            })
            .withOnFailCallback(new BackgroundMail.OnFailCallback() {
                @Override
                public void onFail() {
                    //do some magic
                }
            })
            .send();

配置:

repositories {
    // ...
    maven { url "https://jitpack.io" }
 }
 dependencies {
            compile 'com.github.yesidlazaro:GmailBackground:1.2.0'
    }

权限:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>

另外,对于附件,您需要设置 READ_EXTERNAL_STORAGE 权限:

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

源代码

(我已经亲自测试过)


我正在使用它,而且运行得非常完美。但是我对其进行了一些修改,以便与不同的电子邮件提供商一起使用,当我向Gmail发送电子邮件时,它会返回“发件人”头缺失的错误...如何解决? - Erich García
你好,我在我的应用程序中使用这个API,但它不起作用,并且总是调用onfailcallback。 - Jawad Malik

14

如果将“smtp.gmail.com”作为默认的SMTP服务器,需注意以下警告:

由于Google过于热衷于其“可疑活动”政策,他们会强制你频繁更改链接电子邮件帐户密码。实际上,如果在短时间内来自不同国家的重复SMTP请求被视为“可疑活动”,它会将其视为威胁行为。因为他们认为你(电子邮件帐户持有者)一次只能在一个国家。

当Google系统发现“可疑活动”时,它将阻止进一步的电子邮件发送,直到你更改密码。因为你已经将密码硬编码到应用程序中,所以每次发生这种情况,你都需要重新发布该应用程序,这并不理想。我一周内就遇到了三次这样的情况,我甚至将密码存储在另一台服务器上,并动态获取每次Google强制我更改密码。

因此,我建议使用许多免费的SMTP提供商之一而不是“smtp.gmail.com”以避免这种安全问题。使用相同的代码,但将“smtp.gmail.com”更改为新的SMTP转发主机即可。


2
那是一个很好的观点。但是你能否举个例子,说明替代电子邮件提供商如何与代码配合使用(只需替换smtp和登录详细信息)。我已经尝试过hushmail和email.com,但没有成功。将继续尝试其他的。 - Paulo Matuki
@PauloMatuki,@Mark,你们好,你们解决了“可疑活动”问题吗? - Wesley

8

编辑:JavaMail 1.5.5 声称支持Android,所以您不需要其他任何东西。

我已经将最新的JavaMail(1.5.4)移植到了Android上。它可以在Maven Central中获得,只需将以下内容添加到build.gradle中即可~~

compile 'eu.ocathain.com.sun.mail:javax.mail:1.5.4'

您可以按照官方的教程进行操作。

源代码可在此处获取:https://bitbucket.org/artbristol/javamail-forked-android


那个maven/gradle的命令对我没用。你们Bitbucket上的1.5.4下载也没用。它在和普通的非Android javamail一样的地方失败了,就是MimeMessage.setText(text)这一行。 - wrapperapps
@wrapperapps 很抱歉听到这个消息。"在我的电脑上是可以运行的!"。请随意在Bitbucket存储库上开启一个问题。 - artbristol

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接