🚀Feature Request

Description

The requested feature is to integrate File Manager functionality into the app, enabling users to share files directly from their device’s file manager using an implicit intent. The app will declare support for file transfers in the manifest and handle incoming intents for file sharing using both Bluetooth and Wi-Fi Direct modes. This feature will enhance the app’s usability by allowing users to initiate file transfers seamlessly from other apps.

Expected behavior

The app should be listed as an option when users attempt to share files from their file manager.
The app should handle the file transfer using either Bluetooth or Wi-Fi Direct, based on the user's preference.
The app should prompt users to select the transfer mode when an intent is received.

Current behavior

The app does not currently support sharing files directly from the file manager, and there is no intent handling for external file transfers initiated by other apps.

Steps to reproduce

Open the default File Manager on the device.
Select any file(s) to share.
In the share menu, the app should appear as an option.
Select the app and proceed to transfer the file via Bluetooth or Wi-Fi Direct, based on user choice.

Possible Solution

Declare File Sharing Support in the Manifest:
- Add the necessary <intent-filter> in the Android manifest to declare the app as a file receiver for file transfer intents. This will enable the app to receive shared files using implicit intents.
```
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="*/*" />
</intent-filter>
```
Handle Incoming Intents:
- In the main activity (or another relevant activity), handle incoming file intents using Intent.ACTION_SEND or Intent.ACTION_SEND_MULTIPLE. Extract the file URI(s) from the intent and process them accordingly.
```
if (Intent.ACTION_SEND == intent.action && intent.type != null) {
val fileUri: Uri? = intent.getParcelableExtra(Intent.EXTRA_STREAM)
fileUri?.let {
// Handle the file URI and proceed with transfer
}
}
```
Prompt for Transfer Mode:
- After receiving the intent, prompt the user to select the transfer mode (Bluetooth or Wi-Fi Direct).
- Based on the user’s selection, initiate the respective file transfer method.
  - For Bluetooth, start the Bluetooth transfer activity.
  - For Wi-Fi Direct, initiate the connection and begin file transfer over Wi-Fi Direct.
Handle File Transfer Logic:
- Ensure that the file is transferred appropriately depending on the selected mode (Bluetooth or Wi-Fi Direct).
- Provide feedback on the transfer status, including success or failure.

Why is this feature important to you?

This feature is essential because it streamlines the process of sharing files between devices, allowing users to initiate file transfers directly from the file manager or other apps. It enhances user experience by eliminating the need to open the app separately to share files, making the file transfer process more seamless and efficient.

Additional context (Bonus)

Ensure that permissions for Bluetooth, Wi-Fi Direct, and file access are handled correctly. Request runtime permissions where necessary to ensure smooth operation.
Consider adding error handling for cases where the chosen transfer mode (Bluetooth/Wi-Fi Direct) is unavailable.
Future enhancements could include more sharing options (e.g., NFC, Cloud), or the ability to batch-transfer multiple files at once using Intent.ACTION_SEND_MULTIPLE. (This is a bonus addition that would be considered during final evaluation for additional weightage.

This integration will make the app more versatile by embedding it into the Android ecosystem’s sharing infrastructure, giving users a faster and more intuitive file-sharing experience.

ContriHUB / Just-Share

Implement File Manager Integration for File Sharing via Implicit Intents with Bluetooth and Wi-Fi Direct Support #6