docu(share_plus): mimeTypes parameter is missing documentation #545

packages/share_plus/share_plus/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 3.0.3
+
+- Improve documentation for `shareFiles` method
+
 ## 3.0.2
 
 - Apply code improvements

packages/share_plus/share_plus/lib/share_plus.dart

@@ -75,6 +75,17 @@ class Share {
   /// It uses the `ACTION_SEND` Intent on Android and `UIActivityViewController`
   /// on iOS.
   ///
+  /// The optional `mimeTypes` parameter can be used to specify MIME types for
+  /// the provided files.
+  /// Android supports all natively available MIME types (wildcards like image/*
+  /// are also supported) and it's considered best practice to avoid mixing
+  /// unrelated file types (eg. image/jpg & application/pdf). If MIME types are
+  /// mixed the plugin attempts to find the lowest common denominator. Even
+  /// if MIME types are supplied the receiving app decides if those are used
+  /// or handled.
+  /// On iOS image/jpg, image/jpeg and image/png are handled as images, while
+  /// every other MIME type is considered a normal file.
+  ///
   /// The optional `sharePositionOrigin` parameter can be used to specify a global
   /// origin rect for the share sheet to popover from on iPads. It has no effect
   /// on non-iPads.

packages/share_plus/share_plus/pubspec.yaml

@@ -1,6 +1,6 @@
 name: share_plus
 description: Flutter plugin for sharing content via the platform share UI, using the ACTION_SEND intent on Android and UIActivityViewController on iOS.
-version: 3.0.2
+version: 3.0.3
 homepage: https://plus.fluttercommunity.dev/
 repository: https://github.com/fluttercommunity/plus_plugins/tree/main/packages/