使用Flutter share_plus打开分享面板并预填充收件人邮箱的问题

share_plus 的 shareXFiles 方法本身没有提供预填充邮件收件人的参数——这是因为跨平台的系统分享API没有统一支持这一特性。要实现需求，有两种可行方案：

方案一：单独提供邮件发送入口（简单直接） #

如果可以接受在通用分享面板之外单独加一个「发送邮件」按钮，推荐用 url_launcher 插件直接构造带参数的mailto链接，完全控制邮件的收件人、主题、正文等字段。

步骤： #

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

dependencies:
  url_launcher: ^6.2.5

2. 修改现有代码，新增邮件发送逻辑：

import 'package:url_launcher/url_launcher.dart';

static Future<void> exportFile({
  required BuildContext context,
  required String filename,
  required List<int> bytes,
  String? text,
  String? subject,
  String? recipientEmail, // 新增收件人参数
}) async {
  final box = context.findRenderObject() as RenderBox?;
  final directory = await getTemporaryDirectory();
  String filePath = '${directory.path}/$filename';
  final file = File(filePath);
  await file.writeAsBytes(bytes, flush: true);

  // 保留原有的通用分享面板（所有分享选项，不预填收件人）
  await Share.shareXFiles(
    [XFile(file.path)],
    text: text,
    subject: subject,
    sharePositionOrigin: box!.localToGlobal(Offset.zero) & box.size,
  );

  // 单独的邮件发送入口（可绑定到独立按钮的点击事件）
  if (recipientEmail != null) {
    final Uri emailUri = Uri(
      scheme: 'mailto',
      path: recipientEmail,
      queryParameters: {
        'subject': subject ?? '',
        'body': text ?? '',
      },
    );
    await launchUrl(emailUri);
  }
}

注意：mailto链接的附件支持在不同邮件客户端表现不一致，如果需要稳定的附件发送，可改用 email_launcher 插件，它专门针对邮件发送场景做了优化。

方案二：自定义平台原生分享（保留通用面板+预填收件人） #

如果必须在系统分享面板中点击邮件选项时自动预填收件人，需要通过 MethodChannel 直接调用原生代码，分别处理Android和iOS平台：

Android端实现 #

1. 在 MainActivity 中添加MethodChannel逻辑：

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
import android.content.Intent
import android.net.Uri
import androidx.core.content.FileProvider
import java.io.File

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.yourapp.share/share_with_recipient"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "shareFileWithRecipient") {
                val filePath = call.argument<String>("filePath") ?: run {
                    result.error("INVALID_ARG", "Missing file path", null)
                    return@setMethodCallHandler
                }
                val subject = call.argument<String>("subject")
                val text = call.argument<String>("text")
                val recipient = call.argument<String>("recipient")

                // 构建分享Intent
                val shareIntent = Intent(Intent.ACTION_SEND)
                shareIntent.type = "*/*"
                val fileUri = FileProvider.getUriForFile(this, "${packageName}.fileprovider", File(filePath))
                shareIntent.putExtra(Intent.EXTRA_STREAM, fileUri)
                shareIntent.putExtra(Intent.EXTRA_SUBJECT, subject)
                shareIntent.putExtra(Intent.EXTRA_TEXT, text)
                // 添加收件人参数
                if (recipient != null) shareIntent.putExtra(Intent.EXTRA_EMAIL, arrayOf(recipient))
                shareIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)

                startActivity(Intent.createChooser(shareIntent, "分享文件"))
                result.success(null)
            } else {
                result.notImplemented()
            }
        }
    }
}

2. 在 AndroidManifest.xml 中配置FileProvider：

<application>
    ...
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

3. 在 res/xml 目录下创建 file_paths.xml：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <cache-path name="cache_files" path="." />
</paths>

iOS端实现 #

1. 在 AppDelegate 中添加MethodChannel逻辑：

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    private let CHANNEL = "com.yourapp.share/share_with_recipient"

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(name: CHANNEL, binaryMessenger: controller.binaryMessenger)
        
        channel.setMethodCallHandler { [weak self] call, result in
            guard let self = self else { return }
            if call.method == "shareFileWithRecipient" {
                guard let filePath = call.arguments?["filePath"] as? String else {
                    result.error("INVALID_ARG", "Missing file path", nil)
                    return
                }
                let subject = call.arguments?["subject"] as? String
                let text = call.arguments?["text"] as? String
                let recipient = call.arguments?["recipient"] as? String
                let origin = call.arguments?["sharePositionOrigin"] as? [String: Double]

                let fileUrl = URL(fileURLWithPath: filePath)
                let activityVC = UIActivityViewController(activityItems: [fileUrl, text ?? ""], applicationActivities: nil)
                
                // 设置邮件收件人
                if let recipient = recipient {
                    activityVC.setValue([recipient], forKey: "toRecipients")
                }
                // 设置邮件主题
                if let subject = subject {
                    activityVC.setValue(subject, forKey: "subject")
                }

                // 处理iPad弹窗位置
                if let popover = activityVC.popoverPresentationController, let origin = origin {
                    let rect = CGRect(
                        x: origin["x"] ?? 0,
                        y: origin["y"] ?? 0,
                        width: origin["width"] ?? 0,
                        height: origin["height"] ?? 0
                    )
                    popover.sourceRect = rect
                    popover.sourceView = controller.view
                }

                self.present(activityVC, animated: true)
                result.success(null)
            } else {
                result.notImplemented()
            }
        }

        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

Flutter端调用自定义方法 #

替换原有的 Share.shareXFiles 调用：

import 'package:flutter/services.dart';

static const MethodChannel _shareChannel = MethodChannel('com.yourapp.share/share_with_recipient');

static Future<void> exportFile({
  required BuildContext context,
  required String filename,
  required List<int> bytes,
  String? text,
  String? subject,
  String? recipientEmail,
}) async {
  final box = context.findRenderObject() as RenderBox?;
  final directory = await getTemporaryDirectory();
  String filePath = '${directory.path}/$filename';
  final file = File(filePath);
  await file.writeAsBytes(bytes, flush: true);

  // 调用自定义平台分享方法
  await _shareChannel.invokeMethod('shareFileWithRecipient', {
    'filePath': filePath,
    'subject': subject,
    'text': text,
    'recipient': recipientEmail,
    'sharePositionOrigin': {
      'x': box!.localToGlobal(Offset.zero).dx,
      'y': box.localToGlobal(Offset.zero).dy,
      'width': box.size.width,
      'height': box.size.height,
    },
  });
}

内容的提问来源于stack exchange，提问作者Rami Dhouib