Flutter社交分享插件flutter_social_share的使用

Flutter社交分享插件flutter_social_share的使用

在本教程中，我们将学习如何使用flutter_social_share插件在Flutter应用中分享内容到社交媒体。该插件允许用户将图片或视频分享到Instagram故事。

准备工作

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

dependencies:
  flutter:
    sdk: flutter
  flutter_social_share: ^0.1.3

然后运行flutter pub get来安装该插件。

Android

在Android项目中，你需要进行以下配置：

1. 权限配置

   在android/src/main/AndroidManifest.xml中添加读写存储权限：

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       package="your.package.name">
       
       <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
       
       ...
   </manifest>
   

2. Provider配置

   在android/src/main/AndroidManifest.xml中添加FileProvider：

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

3. 文件路径配置

   在android/src/main/res/xml/file_provider_paths.xml中添加以下内容：

   <paths xmlns:android="http://schemas.android.com/apk/res/android">
       <external-path name="external" path="." />
       <external-files-path name="external_files" path="." />
       <external-cache-path name="external_cache" path="." />
       <files-path name="files" path="." />
   </paths>
   

4. 查询配置

   如果你的应用运行在Android 11或更高版本上，还需要添加以下内容到android/src/main/AndroidManifest.xml：

   对于图片：

   <queries>
       <intent>
           <action android:name='com.instagram.share.ADD_TO_STORY' />
           <data android:mimeType='image/*' />
       </intent>
   </queries>
   

   对于视频：

   <queries>
       <intent>
           <action android:name='com.instagram.share.ADD_TO_STORY' />
           <data android:mimeType='video/*' />
       </intent>
   </queries>
   

iOS

在iOS项目中，你需要进行以下配置：

1. URL Scheme配置

   在ios/Runner/Info.plist中添加以下内容：

   <key>LSApplicationQueriesSchemes</key>
   <array>
       <string>instagram-stories</string>
   </array>
   

使用示例

下面是一个完整的示例，演示如何在Flutter应用中使用flutter_social_share插件分享内容到Instagram故事。

import 'dart:io';

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

import 'package:flutter/services.dart';
import 'package:flutter_social_share/flutter_social_share.dart';
import 'package:path_provider/path_provider.dart';
import 'package:permission_handler/permission_handler.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

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

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

  // 平台消息异步处理，初始化时调用
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await FlutterSocialShare.platformVersion ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  // 获取资产文件并保存到本地
  Future<File> getImageFileFromAssets(String path) async {
    final byteData = await rootBundle.load('assets/$path');

    final file = File('${(await getApplicationDocumentsDirectory()).path}/$path');
    await file.writeAsBytes(byteData.buffer
        .asUint8List(byteData.offsetInBytes, byteData.lengthInBytes));

    return file;
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    [Permission.storage].request().then((val) {
      val.forEach((key, value) {
        if (value.isPermanentlyDenied) {
          openAppSettings();
        }
      });
    });

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
          brightness: Brightness.dark,
        ),
        body: Center(
          child: SingleChildScrollView(
            child: Column(
              children: [
                Text('Running on: $_platformVersion\n'),
                ElevatedButton(
                  onPressed: () async {
                    var image = (await getImageFileFromAssets("example.jpg")).uri;
                    var movie = (await getImageFileFromAssets("example.mp4")).uri;
                    var share = await FlutterSocialShare.shareToInstagram(
                      //backgroundAssetUri: movie,
                      stickerAssetUri: image,
                      // topColor: Colors.deepPurple,
                      // bottomColor: Colors.pinkAccent
                    );
                    print(share);
                  },
                  child: Text("Share to Instagram Story"),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}