如何使用flutter_open_whatsapp包发送图片？求可行解决方案

阿华AIGC实验室

2026-5-8

解决flutter_open_whatsapp无法发送多媒体的替代方案

Hey there, I totally get where you're coming from—you're building a Flutter app that needs to send both text and images to a specific WhatsApp number, but the flutter_open_whatsapp package doesn't support media files. Don't worry, we've got solid workarounds to make this happen.

方案1：直接用WhatsApp URL Scheme（跨平台基础方案）

WhatsApp本身支持通过URL Scheme传递媒体内容，不过核心前提是确保WhatsApp能访问到你的媒体文件（它没法直接读取你的应用私有目录）。

具体步骤：

先处理图片存储：把图片复制到公共可访问目录（比如Android的外部存储、iOS的共享目录）

import 'dart:io';
import 'package:path_provider/path_provider.dart';

Future<String> saveImageToPublicDir(File imageFile) async {
  // Android：获取外部存储目录，创建WhatsApp可识别的子目录
  final directory = await getExternalStorageDirectory();
  final publicImageDir = '${directory!.path}/WhatsApp/Media/WhatsApp Images';
  await Directory(publicImageDir).create(recursive: true);
  
  // 复制图片到公共目录，用时间戳命名避免重复
  final targetFile = await imageFile.copy('$publicImageDir/${DateTime.now().millisecondsSinceEpoch}.jpg');
  return targetFile.path;
}

构造URL唤起WhatsApp：

import 'package:url_launcher/url_launcher.dart';

void sendMediaToWhatsApp(String phoneNumber, String message, String imagePath) async {
  // 注意：phoneNumber必须带国际区号（比如+628xxxxxx），不能有空格
  final encodedMessage = Uri.encodeComponent(message);
  final whatsappUrl = 'whatsapp://send?phone=$phoneNumber&text=$encodedMessage&attachment=$imagePath';

  if (await canLaunchUrl(Uri.parse(whatsappUrl))) {
    await launchUrl(Uri.parse(whatsappUrl));
  } else {
    throw 'Could not launch WhatsApp—make sure it\'s installed on the device';
  }
}

iOS额外配置：在Info.plist中添加WhatsApp的Scheme白名单，否则无法唤起：
```
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>whatsapp</string>
</array>
```

方案2：用更全面的第三方包

如果不想手动处理URL和文件路径的细节，试试这些支持多媒体的专用包：

share_plus：通过系统分享面板唤起WhatsApp，用户选择后即可发送文本+图片（缺点是需要用户手动选择WhatsApp，不能直接指定号码）

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

void shareToWhatsApp(String message, File imageFile, BuildContext context) async {
  final renderBox = context.findRenderObject() as RenderBox?;
  await Share.shareXFiles(
    [XFile(imageFile.path)],
    text: message,
    sharePositionOrigin: renderBox!.localToGlobal(Offset.zero) & renderBox.size,
  );
}

whatsapp_unilink：专门封装WhatsApp链接逻辑，支持媒体发送，用法更简洁：

import 'package:whatsapp_unilink/whatsapp_unilink.dart';
import 'package:url_launcher/url_launcher.dart';

void sendMediaViaUnilink(String phoneNumber, String message, String imagePath) async {
  final link = WhatsAppUnilink(
    phoneNumber: phoneNumber,
    text: message,
    attachment: WhatsAppAttachment(imagePath),
  );
  await launchUrl(Uri.parse(link.toString()));
}

方案3：Android专属隐式Intent调用

如果你的应用只针对Android，可以直接通过原生Intent唤起WhatsApp，控制更精准：

Flutter端调用MethodChannel：

import 'package:flutter/services.dart';

void sendImageViaAndroidIntent(String phoneNumber, String message, String imagePath) async {
  const platform = MethodChannel('com.your.app/whatsapp_share');
  try {
    await platform.invokeMethod('shareImage', {
      'phoneNumber': phoneNumber,
      'message': message,
      'imagePath': imagePath,
    });
  } on PlatformException catch (e) {
    print("Error sending image: ${e.message}");
  }
}

Android原生实现（MainActivity.kt）：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.your.app/whatsapp_share"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "shareImage") {
                val phone = call.argument<String>("phoneNumber")
                val msg = call.argument<String>("message")
                val imgPath = call.argument<String>("imagePath")
                shareToWhatsApp(phone, msg, imgPath)
                result.success(null)
            } else {
                result.notImplemented()
            }
        }
    }

    private fun shareToWhatsApp(phone: String?, msg: String?, imgPath: String?) {
        val fileUri = File(imgPath).toUri()
        val intent = Intent(Intent.ACTION_SEND).apply {
            type = "image/*"
            putExtra(Intent.EXTRA_TEXT, msg)
            putExtra(Intent.EXTRA_STREAM, fileUri)
            setPackage("com.whatsapp") // 直接指定唤起WhatsApp
        }
        startActivity(intent)
    }
}