Null-safety support

.github/workflows/dart.yml

@@ -0,0 +1,30 @@
+name: Analyze & Test
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2      
+      - uses: actions/setup-java@v1
+        with:
+          java-version: '12.x'
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: 'stable'
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Analyze project source
+        run: flutter analyze
+
+      # No test for now
+      # - name: Run tests
+      #  run: flutter test

.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish
+
+on:
+  workflow_run:
+    workflows: ["Analyze & Test"]
+    types: [completed]
+    branches: [master]
+
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Dart and Flutter Package Publisher
+        uses: k-paxian/dart-package-publisher@v1.5.1
+        with:
+          accessToken: ${{ secrets.OAUTH_ACCESS_TOKEN }}
+          refreshToken: ${{ secrets.OAUTH_REFRESH_TOKEN }}
+          skipTests: true
+          flutter: true

.gitignore

@@ -1,18 +1,25 @@
-# Flutter/Dart/Pub related
 .DS_Store
 .dart_tool/
+.idea/
 
 .packages
 .pub/
 pubspec.lock
 
 build/
 
-# IntelliJ related
-*.iml
-*.ipr
-*.iws
-.idea/
-
-# Visual Studio Code related
+# VSCode settings
 .vscode/
+
+android/.settings/
+android/.classpath
+android/.project
+example/android/.settings/
+example/android/.classpath
+example/android/.project
+example/android/app/.settings/
+example/android/app/.classpath
+example/android/app/.project
+
+# FVM
+.fvm/

CHANGELOG.md

@@ -1,3 +1,69 @@
+# 2.5.1
+
+* **Fixed** Android: an issue where files were deleted before being shared to another activity.
+* **Added** public method `clean()` to trigger the cleanup of the temporary files directory.
+
+## 2.5.0
+
+* Update Android `compileSdkVersion` to 35
+* Update Android `minSdkVersion` to 21
+* Update Android `gradle` version to 8.10
+* Update Android example app.
+* On Android sharing now launches in a separate Activity by default. To keep it in the current Activity, set `useSeparateActivity: false` in the `init` method. 
+
+## 2.4.0+1
+
+* **Fixed** Fix share file error on ios.
+
+## 2.4.0
+
+* **Added** new method `init()` for initializing the Share plugin and cleaning up temporary files.
+  This method should be called at app startup or before starting to work with sharing.
+* Implemented automatic deletion of temporary files created in `filesFromStorage` and
+  `fileFromStorage` after sharing is completed (when the share window is closed).
+
+## 2.3.0
+
+* **Added** new methods `fileFromMemory()` and `filesFromMemory()` for sharing small files using
+  byte arrays. These methods should be used cautiously and are **not recommended for large files**
+  due to potential memory issues.
+* **Added** new methods `fileFromStorage()` and `filesFromStorage()` for sharing files using file
+  paths. These methods are **recommended** for general use, especially with large files, to avoid
+  memory-related errors.
+* **Added** explicit namespace declaration for compatibility with latest Android Gradle Plugin.
+* **Deprecated** methods `file()` and `files()`. It is recommended to use `fileFromStorage()` and
+  `filesFromStorage()` instead. For small files, `fileFromMemory()` and `filesFromMemory()` can be
+  used, but they are not recommended for large files due to potential memory issues.
+* **Updated documentation** to clearly state the intended use cases for each method and to guide
+  users toward the recommended approaches.
+* **Breaking change**: If you are using the deprecated methods `file()` and `files()`, please switch
+  to the new methods to avoid possible memory issues.
+
+## 2.2.0
+
+* Fix share file with text. When the text with one file was not shown.
+* Detailed file type processing.
+* **Breaking change**. To `files()` you need to pass the `mimeType` array.
+
+## 2.1.1
+
+* Fixed bug by granting permission. So now granting permission for the uri for each resolvable
+  application.
+
+## 2.1.0
+
+* Published as `esys_flutter_share_plus`.
+* `compileSdkVersion` upgraded to 31.
+
+## 2.0.1
+
+* migrate to V2
+
+## 2.0.0
+
+* migrate to null safety
+* update path_provider to 2.0.0
+
 ## 1.0.3
 
 * update example app
@@ -18,7 +84,10 @@
 
 ## 0.0.9
 
-* Breaking change. Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires   any Android apps using this plugin to [also migrate](https://developer.android.com/jetpack/androidx/migrate) if they're using the original support library.
+* Breaking change. Migrate from the deprecated original Android Support Library to AndroidX. This
+  shouldn't result in any functional changes, but it requires any Android apps using this plugin
+  to [also migrate](https://developer.android.com/jetpack/androidx/migrate) if they're using the
+  original support library.
 
 ## 0.0.8
 

README.md

@@ -1,4 +1,6 @@
-# esys_flutter_share
+# esys_flutter_share_plus
+
+It's fork of [esys_flutter_share](https://github.com/esysberlin/esys-flutter-share).
 
 A [Flutter](https://flutter.io) plugin for sharing files & text with other applications.
 
@@ -28,12 +30,28 @@ end
 
 Instead, if you have already a non-swift project, you can check this issue to solve the problem: [Friction adding swift plugin to objective-c project](https://github.com/flutter/flutter/issues/16049).
 
+## IMPORTANT Note for Android
+On Android, the Share function launches by default in a separate system task and activity. This maintains the cleanliness of your application's navigation stack. However, in this mode, the application cannot wait for the process to complete or reliably receive its result.
+
+Therefore, we cannot determine precisely whether the user has finished sharing the file to safely delete the temporary files. As a result, the temporary file directory is cleared each time a new sharing operation is initiated.
+
+You can also force a cleanup when you are certain the user has finished with the Share function (for example, when leaving the screen of your app from which sharing was launched). To do this, use the `clean()` method.
+
+Alternative option: You can disable launching in a separate system activity by setting the parameter `useSeparateActivity: false` in the `init()` method. In this case, the result of the Share operation will be returned to your application, and the cleanup of temporary files will happen automatically.
+
 ## Usage
 
 Import:
 
 ```dart
-import 'package:esys_flutter_share/esys_flutter_share.dart';
+import 'package:esys_flutter_share_plus/esys_flutter_share_plus.dart';
+```
+
+Initialize the plugin (required):
+
+```dart
+// Call this method at app startup or before starting to work with sharing
+await Share.init();
 ```
 
 Share text:
@@ -42,21 +60,49 @@ Share text:
 Share.text('my text title', 'This is my text to share with other applications.', 'text/plain');
 ```
 
-Share file:
+Share File from Storage (Recommended):
+**Note:** This method is recommended for sharing files, especially large files, to avoid potential memory issues.
+
+```dart
+await EsysFlutterShare.fileFromStorage(
+  'Share File',
+  'example.pdf',
+  '/path/to/your/example.pdf',
+  'application/pdf',
+  text: 'Check out this file!',
+);
+```
+
+Share File from Memory (Use with Caution):
+**Warning:** Use this method only for small files. For large files, use fileFromStorage to avoid potential out-of-memory errors.
 
 ```dart
 final ByteData bytes = await rootBundle.load('assets/image1.png');
-await Share.file('esys image', 'esys.png', bytes.buffer.asUint8List(), 'image/png', text: 'My optional text.');
+await Share.fileFromMemory('esys image', 'esys.png', bytes.buffer.asUint8List(), 'image/png', text: 'My optional text.');
+```
+
+Share Multiple Files from Storage (Recommended):
+
+```dart
+await EsysFlutterShare.filesFromStorage(
+  'Share Files',
+  {
+    'image1.png': '/path/to/your/image1.png',
+    'document.pdf': '/path/to/your/document.pdf',
+  },
+  {'image/png', 'application/pdf'},
+  text: 'Here are some files!',
+);
 ```
 
-Share files:
+Share Multiple Files from Memory (Use with Caution):
 
 ```dart
 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 Share.files(
+await Share.filesFromMemory(
     'esys images',
     {
         'esys.png': bytes1.buffer.asUint8List(),
@@ -73,7 +119,7 @@ Share file from url:
 var request = await HttpClient().getUrl(Uri.parse('https://shop.esys.eu/media/image/6f/8f/af/amlog_transport-berwachung.jpg'));
 var response = await request.close();
 Uint8List bytes = await consolidateHttpClientResponseBytes(response);
-await Share.file('ESYS AMLOG', 'amlog.jpg', bytes, 'image/jpg');
+await Share.fileFromMemory('ESYS AMLOG', 'amlog.jpg', bytes, 'image/jpg');
 ```
 
 Check out the example app in the Repository for further information.