share_to_social Package

is a powerful Flutter package that simplifies sharing files to popular social media platforms like TikTok, Snapchat, and Instagram. With this package, you can enable seamless sharing of images, videos, and other files directly from your app to these platforms, enhancing user engagement and making social media integration effortless.

Features

TikTok Integration:

Share videos directly to TikTok using their official SDK. Support for both private and public sharing.

Snapchat Integration:

Share photos, videos, and more to Snapchat Stories or Chat. Fully compatible with Snapchat's sharing capabilities.

Instagram Integration:

Share photos and videos to Instagram Stories. Includes support for Instagram Reels.

Airdrop for Ios:

Share text as strings.

Table of contents

• Permissions

• Public Android Setup

• Public Ios Setup

• Tiktok Setup

• Snapchat Setup

• Instagram Setup

• AirDrop share

• Issues

• Contribute

• Author

• License

Package Configuration Guide

Permissions

You need to request permission in your app as follows:

var status = await Permission.photos.request();

Public Android setup

Add the following permissions in your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_MEDIA_LOCATION" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.WRITE_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Add Queries

Add the following queries to your AndroidManifest.xml:

<queries>
    <intent>
        <action android:name="android.intent.action.PROCESS_TEXT"/>
        <data android:mimeType="text/plain"/>
    </intent>
    <package android:name="com.snapchat.android" />
</queries>

Add the following provider configuration in your AndroidManifest.xml:

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/provider_paths_app" />
</provider>

Create provider_paths_app.xml

Create a file named provider_paths_app.xml in the res/xml folder with the following content:

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external_files" path="." />
</paths>

Public Ios setup

Add the following configurations in your Info.plist:

<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>
<key>NSPhotoLibraryUsageDescription</key>
<string>I need to access the library because my core logic depends on enabling the user to share files to other apps.</string>

Tiktok Setup

for android

no need to do anything.

for ios

you must Create an app in the TikTok Developer Console. Add the Share Kit to your product. then Add the following configurations in your Info.plist:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>tiktokopensdk</string>
    <string>tiktoksharesdk</string>
    <string>snssdk1180</string>
    <string>snssdk1233</string>
</array>
<key>UIFileSharingEnabled</key>
<true/>
<key>TikTokClientKey</key>
<string>your tiktok client key</string>
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>your tiktok client key</string>
        </array>
    </dict>
</array>

Add Delegate Methods Update your AppDelegate with the following methods:

override func application(_ app: UIApplication, open url: URL,
                 options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    if (TikTokURLHandler.handleOpenURL(url)) {
        return true
    }
    return false
}

override func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if (TikTokURLHandler.handleOpenURL(userActivity.webpageURL)) {
        return true
    }
    return false
}

you can test tiktok by using sandbox client key but you must add your account here

Just then use the package code

try {
if (Platform.isIOS) {
    await Tiktok.shareToIos(
    files: filePaths,
    filesType: fileType,
    redirectUrl:
    "yourapp://tiktok-share");
     } else {
       Tiktok.shareToAndroid(filePaths);
       }
    } catch (e, s) {
      log("error is $e  $s");
      AppToast.showErrorToast(e.toString());
      }

Snapchat Setup

you must create app in snapchat developer Don’t forget to add your applicationID for android and app bundle for ios in your Snapchat app. like this image

for android

no need to do anything

for ios

Add the following configurations in your Info.plist:

<key>SCSDKClientId</key>
<string>snapchat client id</string>
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>snapchat</string>
    <string>bitmoji-sdk</string>
    <string>itms-apps</string>
</array>
<key>UIFileSharingEnabled</key>
<true/>

to use staging client id to need to add testing users in demo user

Just then use the package code

try {
       await SnapChat.share(
       clintID: "add your client id",
       files: filePaths);
    } catch (e, s) {
      log("error is $e  $s");
      AppToast.showErrorToast(e.toString());
      }

try {
       await SnapChat.shareAsSticker(
       clintID: "add your client id", stickerPath: filePath);
    } catch (e, s) {
      log("error is $e  $s");
      AppToast.showErrorToast(e.toString());
      }

Instagram Setup

for android

no need to do anything

for ios

Add the following configurations in your Info.plist:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>instagram</string>
    <string>instagram-stories</string>
    <string>musically</string>
</array>
<key>UIFileSharingEnabled</key>
<true/>

Just then use the package code

try {
       await Instagram.share(filePaths);
    } catch (e, s) {
      log("error is $e  $s");
      AppToast.showErrorToast(e.toString());
      }

AirDrop share

Just then use the package code

try {
       wait AirDrop.share("sharing this text");
    } catch (e, s) {
      log("error is $e  $s");
      AppToast.showErrorToast(e.toString());
      }

Issues

Please file any issues, bugs, or feature requests as an issue on our GitHub page.

Contribute

If you would like to contribute to the plugin (e.g. by improving the documentation, solving a bug, or adding a cool new feature), please send us your pull request.

Author

This share_to_social plugin for Flutter is developed by Mohamed tawfiq. You can contact me at mohamed.adel.dev9@gmail.com

License

This project is licensed under the MIT License.