Flutter社交分享插件share_it的使用

插件介绍

share_it 是一个用于在Flutter应用中实现分享功能的插件。它支持分享文本、链接、图片和文件，并且兼容iOS与Android平台，包括iPad的支持。该插件提供了一个通用的Dart接口方法以及特定平台的方法，以满足不同场景下的需求。

主要特性

• 多平台支持：iOS & Android支持，同时包含对iPad的支持。
• 多种分享类型：可以分享文本、链接、图片和文件。
• 多项目分享：支持一次分享多个不同类型的内容。
• 平台适配性：提供通用的Dart接口及特定于平台的方法，确保最佳用户体验。
• Android版本支持：支持Android >= N 和 < N 的文件分享。

注意事项

• Android 10的内容预览支持正在开发中。
• 需检查外部Android存储对于文件分享的支持情况。
• 对于Android < N的文件分享，目前只对位于/sdcard目录下的文件有效。

使用示例

下面是一个完整的示例代码，展示了如何使用share_it插件来分享不同的内容（如图片、文件、链接等）。此示例还包括了从资产（assets）加载文件并进行分享的功能。

示例代码

import 'dart:io' show File, Platform;
import 'package:flutter/material.dart';
import 'package:share_it/share_it.dart';
import 'package:flutter/services.dart' show rootBundle;
import 'package:path_provider/path_provider.dart' show getExternalStorageDirectory, getApplicationDocumentsDirectory;
import 'package:path/path.dart' show join;

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.center,
            children: <Widget>[
              Image.asset('assets/avatar.png', width: 100),
              TextButton(
                child: Text('Share image'),
                onPressed: () async {
                  ShareIt.file(path: await _imageBundlePath, type: ShareItFileType.image);
                },
              ),
              TextButton(
                child: Text('Share file'),
                onPressed: () async {
                  ShareIt.file(path: await _fileBundlePath, type: ShareItFileType.anyFile);
                },
              ),
              TextButton(
                child: Text('Share link method 1'),
                onPressed: () async {
                  ShareIt.text(content: 'https://www.google.com');
                },
              ),
              TextButton(
                child: Text('Share link method 2'),
                onPressed: () async {
                  ShareIt.link(url: 'https://www.google.com', androidSheetTitle: 'Google');
                },
              ),
              TextButton(
                child: Text('Share image and text'),
                onPressed: () async {
                  ShareIt.list(
                    androidSheetTitle: 'Multiple stuff!',
                    parameters: [
                      ShareItParameters.plainText(content: 'Example text'),
                      ShareItParameters(
                        type: ShareItFileType.image,
                        path: await _imageBundlePath,
                      )
                    ]
                  );
                },
              )
            ],
          ),
        ),
      ),
    );
  }

  Future<String> get _imageBundlePath async {
    return _fileFromBundle(name: 'avatar.png');
  }

  Future<String> get _fileBundlePath async {
    return _fileFromBundle(name: 'Main.java');
  }

  //

  Future<String> _fileFromBundle({required String name}) async {
    final directory = Platform.isIOS ? await getApplicationDocumentsDirectory() : await getExternalStorageDirectory();
    if (directory == null) {
      return Future.error("null");
    }
    final filePath = join(directory.path, name);
    final bundleData = await rootBundle.load('assets/$name');
    List<int> bytes = bundleData.buffer.asUint8List(bundleData.offsetInBytes, bundleData.lengthInBytes);
    final file = await File(filePath).writeAsBytes(bytes);
    return file.path;
  }
}

关键点说明

1. 分享文本或链接

   • 使用ShareIt.text()方法可以直接分享一段文本或者URL。
   • 如果需要自定义Android分享界面标题，可以通过设置androidSheetTitle参数来实现。

2. 分享文件

   • ShareIt.file()方法允许用户分享指定路径下的文件。需要注意的是，对于Android设备来说，文件必须存放在特定的位置（如/sdcard），并且可能需要额外处理权限问题。

3. 多项目分享

   • 利用ShareIt.list()方法，可以一次性分享多个不同类型的项目。例如，在上面的例子中，我们同时分享了一段文字和一张图片。

4. 从资产加载文件

   • _fileFromBundle()函数展示了如何将应用程序中的资源文件复制到本地存储，并返回其路径供后续操作使用。

通过上述内容，您可以轻松地在Flutter应用程序中集成社交分享功能，为用户提供更好的交互体验。如果您有任何疑问或遇到问题，请随时查阅官方文档或社区论坛获取帮助。