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

简介

dl_share_plugin 是一个用于实现社交分享功能的 Flutter 插件。它支持多种社交平台的分享，包括钉钉（DD）、微信（WECHAT）等。

使用指南

初始化插件

首先，确保在 pubspec.yaml 文件中添加 dl_share_plugin 依赖：

dependencies:
  dl_share_plugin: ^版本号

然后，在项目的入口文件中初始化插件：

import 'package:dl_share_plugin/share_flutter_api_impl.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with ShareFlutterApiImpl {
  [@override](/user/override)
  void initState() {
    super.initState();
    
    Future.delayed(Duration(milliseconds: 1000), () {
      initPlatformState();
    });
  }

  // 平台消息异步初始化
  Future<void> initPlatformState() async {}
}

分享本地图片

钉钉分享本地图片

void clickShareImage() async {
  String tempDir = await PathProviderAndroid().getExternalStoragePath() ?? '';
  print("tempDir:   $tempDir");
  
  ShareBody shareBody = ShareBody(
    shareType: ShareType.IMG_LOCAL.value,
    mLocalPath: "$tempDir/image_597.png",
  );
  
  UnifyShare.instance
      ?.platform(SharePlatform.DD)
      ?.shareType(ShareType.IMG_LOCAL)
      ?.content(shareBody)
      ?.startShare(shareCallback: (platfrom, shareStatus) {
    print("分享拿到回调了 ");
  });
}

微信分享图片

void wxShareImage() async {
  ShareBody shareBody = ShareBody(
    shareType: ShareType.IMG_LOCAL.value,
    mLocalPath: "tempDir/image_597.png",
  );

  UnifyShare.instance
      ?.platform(SharePlatform.WECHAT)
      ?.shareType(ShareType.IMG_LOCAL)
      ?.content(shareBody)
      ?.startShare(shareCallback: (platfrom, shareStatus) {
    print("分享拿到回调了 ");
  });
}

检查平台安装状态

InkWell(
  onTap: () {
    UnifyShare.instance
        ?.platform(SharePlatform.WECHAT)
        ?.checkPlatformInstall();
  },
  child: Container(
    margin: EdgeInsets.only(top: 20),
    color: Colors.green,
    width: double.infinity,
    height: 40,
    alignment: Alignment.center,
    child: Text("检查安装"),
  ),
)

授权请求

InkWell(
  onTap: () {
    DlPermissionUtil.checkPermission([Permission.storage], onSuccess: () {}, onFailed: () {});
  },
  child: Container(
    color: Colors.green,
    width: double.infinity,
    height: 40,
    alignment: Alignment.center,
    child: Text("授权"),
  ),
)

完整示例代码

以下是完整的示例代码，展示了如何使用 dl_share_plugin 实现社交分享功能。

import 'dart:async';
import 'package:dl_share_plugin/enums.dart';
import 'package:dl_share_plugin/share_api.pigeon.dart' as pigoneShare;
import 'package:dl_share_plugin/share_flutter_api_impl.dart';
import 'package:dl_share_plugin/unify_share.dart';
import 'package:flutter/material.dart';
import 'package:path_provider_android/path_provider_android.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:share_example/permission_util.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with ShareFlutterApiImpl {
  String _platformVersion = 'Unknown';

  pigoneShare.ShareHostApi? hostApi;

  [@override](/user/override)
  void shareCallBack(ShareEnumContainer enumContainer, String message) {
    if (enumContainer.shareStatus == ShareStatus.SUCCESS.value) {
      print(">>>在平台:  ${enumContainer.sharePlatform} 上分享成功");
    }
  }

  [@override](/user/override)
  void initState() {
    super.initState();

    Future.delayed(Duration(milliseconds: 1000), () {
      initPlatformState();
      UnifyShare.init(wxAppId: "", androidPackageName: "");
    });
  }

  // 平台消息异步初始化
  Future<void> initPlatformState() async {}

  void clickShareImage() async {
    String tempDir = await PathProviderAndroid().getExternalStoragePath() ?? '';
    print("tempDir:   $tempDir");

    ShareBody shareBody = ShareBody(
      shareType: ShareType.IMG_LOCAL.value,
      mLocalPath: "$tempDir/image_597.png",
    );

    UnifyShare.instance
        ?.platform(SharePlatform.DD)
        ?.shareType(ShareType.IMG_LOCAL)
        ?.content(shareBody)
        ?.startShare(shareCallback: (platfrom, shareStatus) {
      print("分享拿到回调了 ");
    });
  }

  void wxShareImage() async {
    ShareBody shareBody = ShareBody(
      shareType: ShareType.IMG_LOCAL.value,
      mLocalPath: "tempDir/image_597.png",
    );

    UnifyShare.instance
        ?.platform(SharePlatform.WECHAT)
        ?.shareType(ShareType.IMG_LOCAL)
        ?.content(shareBody)
        ?.startShare(shareCallback: (platfrom, shareStatus) {
      print("分享拿到回调了 ");
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Column(
          children: [
            InkWell(
              onTap: () {
                DlPermissionUtil.checkPermission([Permission.storage], onSuccess: () {}, onFailed: () {});
              },
              child: Container(
                color: Colors.green,
                width: double.infinity,
                height: 40,
                alignment: Alignment.center,
                child: Text("授权"),
              ),
            ),
            InkWell(
              onTap: () {},
              child: Container(
                margin: EdgeInsets.only(top: 20),
                color: Colors.green,
                width: double.infinity,
                height: 40,
                alignment: Alignment.center,
                child: Text("注册"),
              ),
            ),
            InkWell(
              onTap: () {
                UnifyShare.instance
                    ?.platform(SharePlatform.WECHAT)
                    ?.checkPlatformInstall();
              },
              child: Container(
                margin: EdgeInsets.only(top: 20),
                color: Colors.green,
                width: double.infinity,
                height: 40,
                alignment: Alignment.center,
                child: Text("检查安装"),
              ),
            ),
            InkWell(
              onTap: () {
                clickShareImage();
              },
              child: Container(
                margin: EdgeInsets.only(top: 20),
                color: Colors.green,
                width: double.infinity,
                height: 40,
                alignment: Alignment.center,
                child: Text("钉钉分享本地图片"),
              ),
            ),
            InkWell(
              onTap: () {
                wxShareImage();
              },
              child: Container(
                margin: EdgeInsets.only(top: 20),
                color: Colors.green,
                width: double.infinity,
                height: 40,
                alignment: Alignment.center,
                child: Text("微信分享图片"),
              ),
            ),
          ],
        ),
      ),
    );
  }
}