Flutter邮件发送插件flutter_emailer的使用

功能特性

该插件支持以下功能：

• 打开默认的邮件应用程序。
• 发送邮件给单个或多个接收者。
• 包含抄送（CC）和密送（BCC）接收者。
• 添加邮件主题或正文。

可用方法

1. 打开邮件应用程序

   openEmailApp()
   

2. 单个接收者且无主题

   openEmailWithForSingleReceiverOnly(String receiverEmailId, List<String>? cc, List<String>? bcc)
   

3. 多个接收者且无主题

   openEmailWithForMultipleReceiverOnly(List<String> receiverEmailIdList, List<String>? cc, List<String>? bcc)
   

4. 单个接收者且有主题

   openEmailWithForSingleReceiverWithSubject(String receiverEmailId, String subject, List<String>? cc, List<String>? bcc)
   

5. 多个接收者且有主题

   openEmailWithForMultipleReceiverWithSubject(List<String> receiverEmailIdList, String subject, List<String>? cc, List<String>? bcc)
   

6. 只有正文

   openEmailWithBodyOnly(String body, List<String>? cc, List<String>? bcc)
   

权限

Android

在 AndroidManifest.xml 文件中添加以下权限：

<queries>
  <intent>
    <action android:name="android.intent.action.SENDTO" />
    <data android:scheme="mailto" />
  </intent>
</queries>

iOS

在 Info.plist 文件中添加以下权限：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>mailto</string>
</array>

实现步骤

1. 在 pubspec.yaml 文件中添加依赖：

   dependencies:
     flutter_emailer: ^0.0.1
   

2. 导入插件包：

   import 'package:flutter_emailer/flutter_emailer.dart';
   

3. 使用示例：

   void _openEmailApp() async {
     try {
       await FlutterEmailer.openEmailApp();
     } catch (e) {
       debugPrint('Error: $e');
     }
   }
   
   void _openEmailWithSubject() async {
     try {
       await FlutterEmailer.openEmailWithForSingleReceiverWithSubject('receiverEmail@gmail.com', "Test Subject");
     } catch (e) {
       debugPrint('Error: $e');
     }
   }
   
   void _openEmailWithForSingleReceiverOnly() async {
     try {
       await FlutterEmailer.openEmailWithForSingleReceiverOnly("receiverEmail@gmail.com");
     } catch (e) {
       debugPrint('Error: $e');
     }
   }
   
   void _openEmailWithForMultipleReceiverOnly() async {
     try {
       await FlutterEmailer.openEmailWithForMultipleReceiverOnly(["receiverEmail@gmail.com", "receiverEmail2@gmail.com"]);
     } catch (e) {
       debugPrint('Error: $e');
     }
   }
   
   void _openEmailWithForMultipleReceiverWithSubject() async {
     try {
       await FlutterEmailer.openEmailWithForMultipleReceiverWithSubject(["receiverEmail@gmail.com", "receiverEmail2@gmail.com"], "Multiple receiver subject");
     } catch (e) {
       debugPrint('Error: $e');
     }
   }
   
   void _shareEmailWithBodyOnly() async {
     try {
       await FlutterEmailer.openEmailWithBodyOnly('This is the body of the email.');
     } catch (e) {
       debugPrint('Error: $e');
     }
   }
   

完整示例代码

import 'package:flutter/material.dart';
import 'package:flutter_emailer/flutter_emailer.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  void _openEmailApp() async {
    try {
      await FlutterEmailer.openEmailApp();
    } catch (e) {
      debugPrint('Error: $e');
    }
  }

  void _openEmailWithSubject() async {
    try {
      await FlutterEmailer.openEmailWithForSingleReceiverWithSubject('receiverEmail@gmail.com', "Test Subject");
    } catch (e) {
      debugPrint('Error: $e');
    }
  }

  void _openEmailWithForSingleReceiverOnly() async {
    try {
      await FlutterEmailer.openEmailWithForSingleReceiverOnly("receiverEmail@gmail.com");
    } catch (e) {
      debugPrint('Error: $e');
    }
  }

  void _openEmailWithForMultipleReceiverOnly() async {
    try {
      await FlutterEmailer.openEmailWithForMultipleReceiverOnly(["receiverEmail@gmail.com", "receiverEmail2@gmail.com"]);
    } catch (e) {
      debugPrint('Error: $e');
    }
  }

  void _openEmailWithForMultipleReceiverWithSubject() async {
    try {
      await FlutterEmailer.openEmailWithForMultipleReceiverWithSubject(["receiverEmail@gmail.com", "receiverEmail2@gmail.com"], "Multiple receiver subject");
    } catch (e) {
      debugPrint('Error: $e');
    }
  }

  void _shareEmailWithBodyOnly() async {
    try {
      await FlutterEmailer.openEmailWithBodyOnly('This is the body of the email.');
    } catch (e) {
      debugPrint('Error: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Emailer Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter Emailer Example'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: [
              ElevatedButton(
                onPressed: _openEmailApp,
                child: const Text('Open Email App'),
              ),
              ElevatedButton(
                onPressed: _openEmailWithSubject,
                child: const Text('Open Email with Specific Subject'),
              ),
              ElevatedButton(
                onPressed: _openEmailWithForSingleReceiverOnly,
                child: const Text('Open Email with single receiver'),
              ),
              ElevatedButton(
                onPressed: _openEmailWithForMultipleReceiverOnly,
                child: const Text('Open Email with multiple receiver'),
              ),
              ElevatedButton(
                onPressed: _openEmailWithForMultipleReceiverWithSubject,
                child: const Text('Open Email with multiple receiver with subject'),
              ),
              ElevatedButton(
                onPressed: _shareEmailWithBodyOnly,
                child: const Text('Share Email with Body Only'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}