Flutter社交分享功能插件flutter_social_share_plugin的使用

发布于 1周前 作者 itying888 来自 Flutter

Flutter社交分享功能插件flutter_social_share_plugin的使用

简介

flutter_social_share_plugin 是一个用于Flutter应用的插件，它可以帮助开发者轻松地将内容分享到各大社交平台。支持分享文本和URL，并且可以与Facebook、Instagram、WhatsApp（包括WhatsApp Business）、Twitter、Telegram、短信、邮件以及系统自带的分享UI进行交互。

该插件目前处于开发阶段，部分API可能尚未完善。欢迎提交反馈和Pull Requests以帮助改进插件。

开始使用

添加依赖

首先，在您的 pubspec.yaml 文件中添加 flutter_social_share_plugin 作为依赖项：

dependencies:
  flutter:
    sdk: flutter
  flutter_social_share_plugin: ^2.1.3

请确保检查最新的版本号并根据需要更新。

设置

Android

对于不同的社交平台，您需要在 AndroidManifest.xml 中做相应的配置：

  • WhatsApp：

    <queries>
    <package android:name="com.whatsapp" />
</queries>

  • SMS：

    <uses-permission android:name="android.permission.SEND_SMS" />

  • Instagram：

    <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/file_paths" />
    </provider>
    ...
</application>

iOS

同样地，iOS也需要针对不同平台做一些额外设置：

  • Facebook：

    <key>LSApplicationQueriesSchemes</key>
<array>
    <string>fbauth2</string>
    <string>fb</string>
    <!-- 更多字符串... -->
</array>

  • WhatsApp：

    <key>LSApplicationQueriesSchemes</key>
<array>
    <string>whatsapp</string>
</array>

  • Twitter 和 SMS 类似于 WhatsApp 的配置方式。

使用方法

导入库

在Dart代码中导入插件：

import 'package:flutter_social_share_plugin/flutter_social_share_plugin.dart';

方法调用

以下是几种常用的方法示例：

  • 分享到Facebook：

    await FlutterSocialShare().shareToFacebook(imagePath: imagePath, msg: message);

  • 分享到Instagram：

    await FlutterSocialShare().shareToInstagram(filePath: filePath, fileType: FileType.image);

  • 分享到Twitter：

    await FlutterSocialShare().shareToTwitter(url: url, msg: message);

  • 分享到WhatsApp：

    await FlutterSocialShare().shareToWhatsApp(msg: message, imagePath: imagePath);

  • 发送短信：

    await FlutterSocialShare().shareToSms(msg: message);

  • 发送邮件：

    await FlutterSocialShare().shareToMail(mailBody: body, mailSubject: subject, mailRecipients: recipients);

  • 使用系统分享界面：

    await FlutterSocialShare().shareToSystem(msg: message);

每个方法都返回一个字符串结果，通常为 “success” 表示操作成功。

示例代码

下面是一个完整的示例程序，展示了如何使用 flutter_social_share_plugin 插件来实现各种社交分享功能：

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:flutter_social_share_plugin/flutter_social_share.dart';
import 'package:image_picker/image_picker.dart';
import 'package:permission_handler/permission_handler.dart';

enum Share {
  facebook,
  twitter,
  whatsapp,
  whatsapp_business,
  share_system,
  share_instagram,
  share_telegram,
  share_sms,
  share_mail,
}

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  File? file;
  ImagePicker picker = ImagePicker();
  bool videoEnable = false;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Plugin example app'),
        ),
        body: Container(
          width: double.infinity,
          child: Column(
            children: [
              SizedBox(height: 30),
              ElevatedButton(onPressed: pickImage, child: Text('Pick Image')),
              ElevatedButton(onPressed: pickVideo, child: Text('Pick Video')),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.twitter),
                child: Text('share to twitter'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.whatsapp),
                child: Text('share to WhatsApp'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.whatsapp_business),
                child: Text('share to WhatsApp Business'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.facebook),
                child: Text('share to Facebook'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.share_instagram),
                child: Text('share to Instagram'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.share_telegram),
                child: Text('share to Telegram'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.share_system),
                child: Text('share to System'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.share_sms),
                child: Text('share to sms'),
              ),
              ElevatedButton(
                onPressed: () => onButtonTap(Share.share_mail),
                child: Text('share to mail'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> pickImage() async {
    PermissionStatus status = await Permission.photos.request();
    if (!status.isGranted) {
      await Permission.photos.request();
    }
    final XFile? xFile = await picker.pickImage(source: ImageSource.gallery);
    if (xFile != null) {
      file = File(xFile.path);
      setState(() {
        videoEnable = false;
      });
    }
  }

  Future<void> pickVideo() async {
    final XFile? xFile = await picker.pickVideo(source: ImageSource.gallery);
    if (xFile != null) {
      file = File(xFile.path);
      setState(() {
        videoEnable = true;
      });
    }
  }

  Future<void> onButtonTap(Share share) async {
    String msg =
        'Flutter share is great!!\n Check out full example at https://pub.dev/packages/flutter_social_share_plugin';
    String url = 'https://pub.dev/packages/flutter_social_share_plugin';

    String? response;
    final FlutterSocialShare flutterShareMe = FlutterSocialShare();
    switch (share) {
      case Share.facebook:
        response = await flutterShareMe.shareToFacebook(
            imagePath: file!.path, msg: msg);
        break;
      case Share.twitter:
        response = await flutterShareMe.shareToTwitter(url: url, msg: msg);
        break;
      case Share.whatsapp:
        if (file != null) {
          response = await flutterShareMe.shareToWhatsApp(
              imagePath: file!.path,
              fileType: videoEnable ? FileType.video : FileType.image);
        } else {
          response = await flutterShareMe.shareToWhatsApp(msg: msg);
        }
        break;
      case Share.whatsapp_business:
        response = await flutterShareMe.shareToWhatsApp4Biz(msg: msg);
        break;
      case Share.share_instagram:
        response = await flutterShareMe.shareToInstagram(
            filePath: file!.path,
            fileType: videoEnable ? FileType.video : FileType.image);
        break;
      case Share.share_system:
        response = await flutterShareMe.shareToSystem(msg: msg);
        break;
      case Share.share_telegram:
        response = await flutterShareMe.shareToTelegram(msg: msg);
        break;
      case Share.share_sms:
        response = await flutterShareMe.shareToSms(msg: msg);
        break;
      case Share.share_mail:
        response = await flutterShareMe.shareToMail(
            mailBody: msg,
            mailSubject: 'Flutter Social Share',
            mailRecipients: ['fluttersocialshare@pub.dev']);
        break;
    }
    debugPrint(response);
  }
}

以上就是关于 flutter_social_share_plugin 插件的基本介绍及其使用方法。希望这些信息能够帮助您快速上手并集成到您的项目中！如果有任何问题或建议，请随时访问 GitHub仓库 获取更多信息。


更多关于Flutter社交分享功能插件flutter_social_share_plugin的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter社交分享功能插件flutter_social_share_plugin的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，下面是一个关于如何使用 flutter_social_share_plugin 插件来实现 Flutter 应用中的社交分享功能的代码示例。这个插件允许你将文本、图片、URL 等内容分享到不同的社交平台。

首先，确保你已经在 pubspec.yaml 文件中添加了 flutter_social_share_plugin 依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_social_share_plugin: ^x.y.z  # 请替换为最新版本号

然后，运行 flutter pub get 来获取依赖。

接下来，在 Dart 文件中导入插件并编写分享功能代码。以下是一个简单的示例：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Social Share Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final FlutterSocialSharePlugin socialShare = FlutterSocialSharePlugin();

  void _shareText() async {
    String shareText = "Hello, I am sharing this text!";
    try {
      var result = await socialShare.shareTo(
        sharePosition: SharePosition.bottom,
        text: shareText,
      );
      print("Share result: $result");
    } catch (e) {
      print("Error: $e");
    }
  }

  void _shareImage() async {
    String imagePath = "path/to/your/image.jpg";  // 替换为你的图片路径
    try {
      var result = await socialShare.shareImageTo(
        sharePosition: SharePosition.bottom,
        filePath: imagePath,
      );
      print("Share result: $result");
    } catch (e) {
      print("Error: $e");
    }
  }

  void _shareUrl() async {
    String shareUrl = "https://www.example.com";
    try {
      var result = await socialShare.shareWebpageTo(
        sharePosition: SharePosition.bottom,
        title: "Example Website",
        url: shareUrl,
        description: "This is an example website.",
        imageUrl: "https://www.example.com/image.jpg",  // 可选
      );
      print("Share result: $result");
    } catch (e) {
      print("Error: $e");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("Social Share Example"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            ElevatedButton(
              onPressed: _shareText,
              child: Text("Share Text"),
            ),
            SizedBox(height: 16),
            ElevatedButton(
              onPressed: _shareImage,
              child: Text("Share Image"),
            ),
            SizedBox(height: 16),
            ElevatedButton(
              onPressed: _shareUrl,
              child: Text("Share URL"),
            ),
          ],
        ),
      ),
    );
  }
}

注意事项

  1. 图片路径：在 _shareImage 方法中，你需要提供一张本地图片的路径。这通常是在应用的 assets 文件夹中或者通过其他方式获取的本地文件路径。

  2. 权限：在某些平台上（特别是 Android），你可能需要在 AndroidManifest.xml 中声明必要的权限，例如读取存储权限，以便能够访问本地图片。

  3. 错误处理：在实际应用中，你应该添加更多的错误处理逻辑，以优雅地处理分享过程中可能出现的各种错误。

  4. 平台差异：不同平台的分享行为可能有所不同，你可能需要根据具体平台进行适配。

通过上述代码，你可以轻松地在 Flutter 应用中实现社交分享功能。希望这对你有所帮助！

回到顶部