Flutter社交分享插件vocsy_esys_flutter_share的使用

vocsy_esys_flutter_share 是一个用于在Flutter应用中与其他应用程序共享文件和文本的插件。该插件是从 esys_flutter_share 分叉而来，并支持空安全（null-safety）。

重要注意事项

iOS项目配置

如果你正在创建一个新的Flutter应用，请确保使用以下命令创建项目：

flutter create -i swift

否则，你可能会遇到如下错误信息：

The "Swift Language Version" (SWIFT_VERSION) build setting must be set to a supported value for targets which use Swift. Supported values are: 3.0, 4.0, 4.2.

如果遇到上述问题，可以尝试修改iOS项目的 Podfile 文件：

target 'Runner' do
  use_frameworks!  # required by simple_permission
  ...
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['SWIFT_VERSION'] = '4.0'  # required by simple_permission
      config.build_settings['ENABLE_BITCODE'] = 'NO'
    end
  end
end

功能特性

示例截图

使用方法

导入包

import 'package:vocsy_esys_flutter_share/vocsy_esys_flutter_share.dart';

示例代码

下面是一个完整的示例demo，展示了如何使用 vocsy_esys_flutter_share 插件进行各种类型的分享：

import 'dart:async';
import 'dart:io';
import 'dart:typed_data';

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:vocsy_esys_flutter_share/vocsy_esys_flutter_share.dart';

void main() => runApp(
  MaterialApp(
    debugShowCheckedModeBanner: false,
    home: MyHomePage(),
  ),
);

class MyHomePage extends StatefulWidget {
  MyHomePage();

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Vocsy Esys Share Plugin Sample'),
      ),
      body: Center(
        child: IntrinsicWidth(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                child: Text('Share text'),
                onPressed: () async => await _shareText(),
              ),
              ElevatedButton(
                child: Text('Share image'),
                onPressed: () async => await _shareImage(),
              ),
              ElevatedButton(
                child: Text('Share images'),
                onPressed: () async => await _shareImages(),
              ),
              ElevatedButton(
                child: Text('Share CSV'),
                onPressed: () async => await _shareCSV(),
              ),
              ElevatedButton(
                child: Text('Share mixed'),
                onPressed: () async => await _shareMixed(),
              ),
              ElevatedButton(
                child: Text('Share image from url'),
                onPressed: () async => await _shareImageFromUrl(),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> _shareText() async {
    try {
      VocsyShare.text('my text title', 'This is my text to share with other applications.', 'text/plain');
    } catch (e) {
      print('error: $e');
    }
  }

  Future<void> _shareImage() async {
    try {
      final ByteData bytes = await rootBundle.load('assets/image1.png');
      await VocsyShare.file('esys image', 'esys.png', bytes.buffer.asUint8List(), 'image/png', text: 'My optional text.');
    } catch (e) {
      print('error: $e');
    }
  }

  Future<void> _shareImages() async {
    try {
      final ByteData bytes1 = await rootBundle.load('assets/image1.png');
      final ByteData bytes2 = await rootBundle.load('assets/image2.png');

      await VocsyShare.files(
        'esys images',
        {
          'esys.png': bytes1.buffer.asUint8List(),
          'bluedan.png': bytes2.buffer.asUint8List(),
        },
        'image/png',
      );
    } catch (e) {
      print('error: $e');
    }
  }

  Future<void> _shareCSV() async {
    try {
      final ByteData bytes = await rootBundle.load('assets/addresses.csv');
      await VocsyShare.file('addresses', 'addresses.csv', bytes.buffer.asUint8List(), 'text/csv');
    } catch (e) {
      print('error: $e');
    }
  }

  Future<void> _shareMixed() async {
    try {
      final ByteData bytes1 = await rootBundle.load('assets/image1.png');
      final ByteData bytes2 = await rootBundle.load('assets/image2.png');
      final ByteData bytes3 = await rootBundle.load('assets/addresses.csv');

      await VocsyShare.files(
        'esys images',
        {
          'esys.png': bytes1.buffer.asUint8List(),
          'bluedan.png': bytes2.buffer.asUint8List(),
          'addresses.csv': bytes3.buffer.asUint8List(),
        },
        '*/*',
        text: 'My optional text.',
      );
    } catch (e) {
      print('error: $e');
    }
  }

  Future<void> _shareImageFromUrl() async {
    try {
      var request = await HttpClient().getUrl(Uri.parse('https://cdn.shopware.store/r/4/9/Q2AEt/thumbnail/5d/d6/aa/1612969110/leiterplatte_800x800.png'));
      var response = await request.close();
      Uint8List bytes = await consolidateHttpClientResponseBytes(response);
      await VocsyShare.file('ESYS AMLOG', 'amlog.jpg', bytes, 'image/jpg');
    } catch (e) {
      print('error: $e');
    }
  }
}