Flutter邮件发送插件mailer的使用

简介

mailer 是一个用于在Dart中轻松编写和发送电子邮件的库。它支持文件附件和HTML电子邮件。

注意事项

• Flutter开发者：此库不适用于Flutter Web，因为通过HTTP发送邮件的技术上不可行。
• 安全警告：请勿将您的凭证与mailer一起使用，提取它们非常容易，任何人都可以使用您的账户发送邮件。如果使用的是Gmail凭证，情况更糟，攻击者甚至可以读取您的邮件。
• 替代方案：Johannes Milke创建了一个优秀的教程，介绍了如何在不嵌入凭证的情况下使用mailer。教程链接

SMTP配置

Mailer为一些常见的SMTP服务器提供了配置。如果需要添加新的SMTP配置，请参考以下步骤：

1. 复制 lib/smtp_server/gmail.dart 到 lib/smtp_server/xxx.dart
2. 修改代码（参见 lib/smtp_server.dart 以了解可能的参数）
3. 在 lib/smtp_server.dart 中导出新创建的SMTP服务器
4. 创建合并请求

功能特性

• 支持纯文本和HTML邮件
• Unicode支持
• 文件附件
• 安全性（过滤和根据上下文对所有字段进行消毒）
• 支持任何SMTP服务器（如Gmail、Live、SendGrid、Amazon SES等）
• SSL/TLS支持
• 预配置服务（只需填写用户名和密码）

示例代码

发送邮件

import 'package:mailer/mailer.dart';
import 'package:mailer/smtp_server.dart';

void main() async {
  // 使用Gmail发送邮件时，只有启用了两步验证并创建了应用密码才有效。
  // 替代方案是使用OAuth。
  String username = 'your.email@gmail.com';
  String password = 'yourpassword';

  final smtpServer = gmail(username, password);

  // 创建邮件消息
  final message = Message()
    ..from = Address(username, 'Your Name')
    ..recipients.add('recipient@example.com')
    ..ccRecipients.addAll(['destCc1@example.com', 'destCc2@example.com'])
    ..bccRecipients.add(Address('bccAddress@example.com'))
    ..subject = 'Test Dart Mailer library :: 😀 :: ${DateTime.now()}'
    ..text = 'This is the plain text.\nThis is line 2 of the text part.'
    ..html = "<h1>Test</h1>\n<p>Hey! Here's some HTML content</p>";

  try {
    final sendReport = await send(message, smtpServer);
    print('Message sent: ' + sendReport.toString());
  } on MailerException catch (e) {
    print('Message not sent.');
    for (var p in e.problems) {
      print('Problem: ${p.code}: ${p.msg}');
    }
  }

  // 发送另一封邮件，使用稍微不同的语法
  final equivalentMessage = Message()
    ..from = Address(username, 'Your name 😀')
    ..recipients.add(Address('destination@example.com'))
    ..ccRecipients.addAll([Address('destCc1@example.com'), 'destCc2@example.com'])
    ..bccRecipients.add('bccAddress@example.com')
    ..subject = 'Test Dart Mailer library :: 😀 :: ${DateTime.now()}'
    ..text = 'This is the plain text.\nThis is line 2 of the text part.'
    ..html = '<h1>Test</h1>\n<p>Hey! Here is some HTML content</p><img src="cid:myimg@3.141"/>'
    ..attachments = [
      FileAttachment(File('exploits_of_a_mom.png'))
        ..location = Location.inline
        ..cid = '<myimg@3.141>'
    ];

  final sendReport2 = await send(equivalentMessage, smtpServer);

  // 使用持久连接发送多封邮件
  var connection = PersistentConnection(smtpServer);

  // 发送第一封邮件
  await connection.send(message);

  // 发送第二封邮件
  await connection.send(equivalentMessage);

  // 关闭连接
  await connection.close();
}

许可证

本库采用MIT许可证。

希望这个指南能帮助你更好地理解和使用mailer插件。如果你有任何问题或需要进一步的帮助，请随时提问！