share_plus 4.2.0 share_plus: ^4.2.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 #
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 #
Android | iOS | MacOS | Web | Linux | Windows |
---|---|---|---|---|---|
✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
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']);
Check out our documentation website to learn more. Plus plugins documentation
Known Issues #
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.