Flutter即时通讯插件wa_me的使用

Flutter即时通讯插件wa_me的使用

1. 插件简介

wa_me 是 whatsapp_share2 的一个分支，旨在支持除官方 WhatsApp 应用之外的其他版本，例如 GBWhatsApp。该插件提供了以下功能：

• 向特定联系人分享文本或链接。
• 向特定联系人分享本地文件。

2. 安装

2.1 添加依赖

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

dependencies:
  wa_me: latest_version

然后在 Dart 代码中导入插件：

import 'package:wa_me/wa_me.dart';

2.2 平台特定配置

2.2.1 iOS 配置

如果 ios/podfile 文件中没有以下内容，请添加：

target 'Runner' do
    use_frameworks!
    ...
end

2.2.2 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>

3. 使用方法

3.1 检查设备上是否安装了WhatsApp

你可以使用 WaMe.isInstalled() 方法来检查设备上是否安装了特定版本的 WhatsApp。例如，检查是否安装了 GBWhatsApp：

Future<void> isInstalled() async {
  final val = await WaMe.isInstalled(
    package: Package.gbWhatsapp, // 你可以选择其他包名
  );
  print('GBWhatsApp 是否已安装: $val');
}

注意：如果 WhatsApp 未安装，请不要调用 WaMe.share() 和 WaMe.shareFile() 方法。

3.2 分享文本或链接

你可以使用 WaMe.share() 方法向特定联系人分享文本或链接。以下是一个示例：

Future<void> share() async {
  await WaMe.share(
    text: '这是通过 WaMe 插件分享的文本', // 要分享的文本
    linkUrl: 'https://flutter.dev/', // 要分享的链接（可选）
    phone: '91xxxxxxxxxx', // 目标联系人的电话号码（带国家代码）
  );
}

3.3 分享图片或文件

你可以使用 WaMe.shareFile() 方法向特定联系人分享图片或其他文件。以下是一个示例：

Future<void> shareFile() async {
  await WaMe.shareFile(
    text: '这是通过 WaMe 插件分享的文件', // 可选的附加文本
    phone: '91xxxxxxxxxx', // 目标联系人的电话号码（带国家代码）
    filePath: [_image1.path, _image2.path], // 文件路径列表
  );
}

注意：_image1.path 和 _image2.path 是你要分享的文件的路径。你需要确保这些文件路径是有效的，并且文件存在于设备上。

4. 完整示例 Demo

以下是一个完整的 Flutter 示例应用，展示了如何使用 wa_me 插件进行文本、链接和文件分享。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('WaMe 示例')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () => isInstalled(),
                child: Text('检查 GBWhatsApp 是否已安装'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () => share(),
                child: Text('分享文本和链接'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () => shareFile(),
                child: Text('分享文件'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> isInstalled() async {
    final val = await WaMe.isInstalled(
      package: Package.gbWhatsapp, // 你可以选择其他包名
    );
    print('GBWhatsApp 是否已安装: $val');
  }

  Future<void> share() async {
    await WaMe.share(
      text: '这是通过 WaMe 插件分享的文本',
      linkUrl: 'https://flutter.dev/',
      phone: '91xxxxxxxxxx', // 替换为实际的电话号码
    );
  }

  Future<void> shareFile() async {
    // 假设你已经获取了文件路径
    String imagePath1 = '/path/to/image1.jpg'; // 替换为实际的文件路径
    String imagePath2 = '/path/to/image2.png'; // 替换为实际的文件路径

    await WaMe.shareFile(
      text: '这是通过 WaMe 插件分享的文件',
      phone: '91xxxxxxxxxx', // 替换为实际的电话号码
      filePath: [imagePath1, imagePath2],
    );
  }
}