large Flutter Favorite logosmall Flutter Favorite logo

share_plus 6.3.0 icon indicating copy to clipboard operation
share_plus: ^6.3.0 copied to clipboard

Flutter plugin for sharing content via the platform share UI, using the ACTION_SEND intent on Android and UIActivityViewController on iOS.

Share plugin #

Flutter Community: share_plus

share_plus pub points pub package

build

A Flutter plugin to share content from your Flutter app via the platform's share dialog.

Wraps the ACTION_SEND Intent on Android and UIActivityViewController on iOS.

Platform Support #

AndroidiOSMacOSWebLinuxWindows
✔️✔️✔️✔️✔️✔️

Also compatible with Windows and Linux by using "mailto" to share text via Email.

Sharing files is not supported on Windows and Linux.

Usage #

To use this plugin, add share_plus as a dependency in your pubspec.yaml file.

Example #

Import the library.

import 'package:share_plus/share_plus.dart';

Then invoke the static share method anywhere in your Dart code.

Share.share('check out my website https://example.com');

The share method also takes an optional subject that will be used when sharing to email.

Share.share('check out my website https://example.com', subject: 'Look what I made!');

To share one or multiple files invoke the static shareFiles method anywhere in your Dart code. Optionally you can also pass in text and subject.

Share.shareFiles(['${directory.path}/image.jpg'], text: 'Great picture');
Share.shareFiles(['${directory.path}/image1.jpg', '${directory.path}/image2.jpg']);

On web you can use SharePlus.shareXFiles(). This uses the Web Share API if it's available. Otherwise it falls back to downloading the shared files. See Can I Use - Web Share API to understand which browsers are supported. This builds on the cross_file package.

Share.shareXFiles([XFile('assets/hello.txt')], text: 'Great picture');

Check out our documentation website to learn more. Plus plugins documentation

Known Issues #

Sharing data created with XFile.fromData #

When sharing data created with XFile.fromData, the plugin will write a temporal file inside the cache directory of the app, so it can be shared.

Althouth the OS should take care of deleting those files, it is advised, that you clean up this data once in a while (e.g. on app start).

You can access this directory using path_provider getTemporaryDirectory.

Alternatively, don't use XFile.fromData and instead write the data down to a File with a path before sharing it, so you control when to delete it.

Mobile platforms (Android and iOS) #

Facebook limitations (WhatsApp, Instagram, Facebook Messenger)

Due to restrictions set up by Facebook this plugin isn't capable of sharing data reliably to Facebook related apps on Android and iOS. This includes eg. sharing text to the Facebook Messenger. If you require this functionality please check the native Facebook Sharing SDK (https://developers.facebook.com/docs/sharing) or search for other Flutter plugins implementing this SDK. More information can be found in this issue.

iPad

share_plus requires iPad users to provide the sharePositionOrigin parameter.

Without it, share_plus will not work on iPads and may cause a crash or letting the UI not responding.

To avoid that problem, provide the sharePositionOrigin.

For example:

// Use Builder to get the widget context
Builder(
  builder: (BuildContext context) {
    return ElevatedButton(
      onPressed: () => _onShare(context),
          child: const Text('Share'),
     );
  },
),

// _onShare method:
final box = context.findRenderObject() as RenderBox?;

await Share.share(
  text,
  subject: subject,
  sharePositionOrigin: box!.localToGlobal(Offset.zero) & box.size,
);

See the main.dart in the example for a complete example.

1879
likes
140
pub points
100%
popularity

Publisher

verified publisher iconfluttercommunity.dev

Flutter plugin for sharing content via the platform share UI, using the ACTION_SEND intent on Android and UIActivityViewController on iOS.

Homepage
Repository (GitHub)
View/report issues

Documentation

API reference

License

Icon for licenses.BSD-3-Clause (LICENSE)

Dependencies

cross_file, ffi, file, flutter, flutter_web_plugins, meta, mime, share_plus_platform_interface, url_launcher_linux, url_launcher_platform_interface, url_launcher_web, url_launcher_windows, win32

More

Packages that depend on share_plus