Flutter社交分享插件whatsapp_share的使用

插件介绍

Whatsapp Share Plugin 是一个Flutter插件，它为Android平台提供了一种简单的方法，可以将消息、链接或本地文件分享给特定的WhatsApp联系人。

• 特性:
  • 分享消息或链接到特定联系人。
  • 分享本地文件到特定联系人。

安装配置

添加依赖

首先，在pubspec.yaml文件中添加以下依赖：

dependencies:
  whatsapp_share: ^1.1.1

然后在Dart代码中导入：

import 'package:whatsapp_share/whatsapp_share.dart';

平台特定配置

iOS配置

如果尚未存在，请在ios/podfile文件中的target runner后添加一行：

target 'Runner' do
    use_frameworks!
end

Android配置

如果你打算使用文件分享功能，则需要配置文件提供者（File Provider），这将允许其他应用程序访问文件。

在AndroidManifest.xml中添加如下内容：

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

同时创建res/xml/provider_paths.xml文件，并添加以下内容：

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

更多关于文件提供者的详细信息可参考：FileProvider官方文档

使用方法

以下是展示如何使用该插件的完整示例demo。

import 'dart:async';
import 'dart:io';
import 'dart:developer';

import 'package:flutter/material.dart';
import 'package:whatsapp_share/whatsapp_share.dart';
import 'package:image_picker/image_picker.dart';
import 'package:path_provider/path_provider.dart';
import 'package:screenshot/screenshot.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  final _controller = ScreenshotController();
  File? _image;

  Future<void> share() async {
    await WhatsappShare.share(
      text: 'Example share text',
      linkUrl: 'https://flutter.dev/',
      phone: '911234567890', // Replace with actual phone number
    );
  }

  Future<void> shareFile() async {
    await getImage();
    Directory? directory;
    if (Platform.isAndroid) {
      directory = await getExternalStorageDirectory();
    } else {
      directory = await getApplicationDocumentsDirectory();
    }
    debugPrint('${directory?.path} / ${_image?.path}');

    await WhatsappShare.shareFile(
      phone: '911234567890', // Replace with actual phone number
      filePath: ["${_image?.path}"],
    );
  }

  Future<void> isInstalled() async {
    final val = await WhatsappShare.isInstalled(package: Package.whatsapp);
    debugPrint('Whatsapp is installed: $val');
  }

  Future<void> shareScreenShot() async {
    Directory? directory;
    if (Platform.isAndroid) {
      directory = await getExternalStorageDirectory();
    } else {
      directory = await getApplicationDocumentsDirectory();
    }
    final String localPath =
        '${directory?.path}/${DateTime.now().millisecondsSinceEpoch}.png';

    await _controller.captureAndSave(localPath);

    await Future.delayed(const Duration(seconds: 1));

    await WhatsappShare.shareFile(
      phone: '911234567890', // Replace with actual phone number
      filePath: [localPath],
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Whatsapp Share'),
        ),
        body: Center(
          child: Screenshot(
            controller: _controller,
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.center,
              mainAxisAlignment: MainAxisAlignment.center,
              children: <Widget>[
                ElevatedButton(
                  onPressed: share,
                  child: const Text('Share text and link'),
                ),
                ElevatedButton(
                  onPressed: shareFile,
                  child: const Text('Share Image'),
                ),
                ElevatedButton(
                  onPressed: shareScreenShot,
                  child: const Text('Share screenshot'),
                ),
                ElevatedButton(
                  onPressed: isInstalled,
                  child: const Text('is Installed'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }

  /// Pick Image From gallery using image_picker plugin
  Future getImage() async {
    try {
      XFile? pickedFile =
          // ignore: deprecated_member_use
          await ImagePicker().pickImage(source: ImageSource.gallery);

      if (pickedFile != null) {
        _image = File(pickedFile.path);
      } else {}
    } catch (er) {
      log(er.toString());
    }
  }
}

此示例演示了如何通过按钮触发不同的分享操作，包括文本和链接分享、图片分享以及屏幕截图分享。同时，也展示了如何检查设备上是否安装了WhatsApp应用。请根据实际情况替换示例代码中的电话号码等参数。