lecle_social_share 0.5.3

A Flutter project support share files to social media (Facebook, Instagram, etc.). If you only want to share files on certain platforms, this plugin is made for you.

lecle_social_share

A Flutter project support share file to social media (Facebook, Instagram, etc.). If you only want to share files on certain platforms, this plugin is made for you.

Current supported platform:

• Facebook
• Instagram
• Messenger
• Telegram
• WhatsApp
• Twitter
• TikTok

There are static instances in LecleSocialShare class represent for:

• F: Facebook
• I: Instagram
• M: Messenger
• T: Telegram
• W: WhatsApp
• TW: Twitter
• TI: TikTok

Simply use LecleSocialShare class and call the instance of which platform you want to share then call the corresponding method from the instance

Android

Paste the following attribute in the manifest tag in the AndroidManifest.xml

xmlns:tools="http://schemas.android.com/tools"

copied to clipboard

For example:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools"
          package="your package...">

copied to clipboard

Add these permissions and queries to your AndroidManifest.xml

<queries>
    <!-- Explicit apps you know in advance about: -->
    <package android:name="com.instagram.android" />
    <package android:name="com.facebook.katana" />
    <package android:name="com.facebook.orca" />
    <package android:name="org.telegram.messenger" />
    <package android:name="com.whatsapp" />
    <package android:name="com.twitter.android" />
    <package android:name="com.zhiliaoapp.musically" />
    <package android:name="com.ss.android.ugc.trill" />
</queries>

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />  

copied to clipboard

Create xml folder and add a provider path file to it (for example: provider_paths_app.xml) in android/app/src/main/res and add the lines below to the created xml file

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path
        name="external_files"
        path="." />
</paths>

copied to clipboard

After created your own file provider and define your own path paste them into this and add to your AndroidManifest.xml

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

copied to clipboard

Facebook app register

• In /android/app/src/main/values folder create a strings.xml file and add your facebook app id and facebook client token.
• To get the facebook client token: Open your app on Meta for developer (link) > Settings > Advanced > Security > Application code
• To get the facebook app id follow the Meta link above and go to your app Settings > Basic information > App ID

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="facebook_app_id">[facebook_app_id]</string>
    <string name="facebook_client_token">[facebook_client_token]</string>
</resources>

copied to clipboard

• After complete the step above add these xml tags to your AndroidManifest.xml
• To create the custom facebook theme: In android/app/src/main/res/values define your custom theme and add to the [your_custom_theme] in the activity below
• Custom theme example:

<style name="com_facebook_activity_theme" parent="@style/Theme.AppCompat.NoActionBar">
  <item name="android:windowIsTranslucent">true</item>
  <item name="android:windowBackground">@android:color/transparent</item>
  <item name="android:windowNoTitle">true</item>
</style>

copied to clipboard

<provider android:name="com.facebook.FacebookContentProvider" android:authorities="com.facebook.app.FacebookContentProvider[your_facebook_app_id]"
    android:exported="true" />

<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id" />
<meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token" />

<activity android:name="com.facebook.FacebookActivity" 
android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
android:theme="@style/[your_custom_theme]" />

<activity android:name="com.facebook.CustomTabMainActivity" />
<activity android:name="com.facebook.CustomTabActivity" android:exported="true" tools:node="merge">
<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="fbconnect" android:host="cct.${applicationId}" />
</intent-filter>
</activity>

copied to clipboard

iOS

Open Xcode and change your deployment target to iOS 11

Add these lines to your Info.plist file

<key>CFBundleURLTypes</key>
<array>
<dict>
    <key>CFBundleURLSchemes</key>
    <array>
        <string>fb[your_facebook_app_id]</string>
        <string>[your_tiktok_app_id]</string>
    </array>
</dict>
</array>

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>instagram</string>
  <string>fb</string>
  <string>fbauth2</string>
  <string>fbshareextension</string>
  <string>fbapi</string>
  <string>facebook-reels</string>
  <string>facebook-stories</string>
  <string>fb-messenger-share-api</string>
  <string>fb-messenger</string>
  <string>tg</string>
  <string>whatsapp</string>
  <string>twitter</string>
  
  <string>tiktokopensdk</string>
  <string>tiktoksharesdk</string>
  <string>snssdk1180</string>
  <string>snssdk1233</string>
</array>

<key>NSPhotoLibraryUsageDescription</key>
<string>$(PRODUCT_NAME) needs permission to access photos and videos on your device</string>
<key>NSMicrophoneUsageDescription</key>
<string>$(PRODUCT_NAME) does not require access to the microphone.</string>
<key>NSCameraUsageDescription</key>
<string>$(PRODUCT_NAME) requires access to the camera.</string>
<key>NSAppleMusicUsageDescription</key>
<string>$(PRODUCT_NAME) requires access to play music</string>

<key>FacebookAppID</key>
<string>[your_facebook_app_id]</string>
<key>FacebookClientToken</key>
<string>[your_facebook_client_token]</string>
<key>FacebookDisplayName</key>
<string>[your_facebook_app_display_name]</string>

<key>NSBonjourServices</key>
<array>
<string>_dartobservatory._tcp</string>
</array>

<key>TikTokAppID</key>
<string>[your_tiktok_app_id]</string>

copied to clipboard

The facebook app id and facebook client token you can get by complete the steps mentioned on Android config

Update your AppDelegate.swift the same as the below example

import UIKit
import Flutter

// Add these lines
import FBSDKCoreKit
import TikTokOpenSDK

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)
        
        // Add these lines
        FBSDKCoreKit.ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )
        TikTokOpenSDKApplicationDelegate.sharedInstance().application(application, didFinishLaunchingWithOptions: launchOptions)
        
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
    
    // Add this method
    override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
        guard let sourceApplication = options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
              let annotation = options[UIApplication.OpenURLOptionsKey.annotation] else {
            return false
        }
        
        if TikTokOpenSDKApplicationDelegate.sharedInstance().application(app, open: url, sourceApplication: sourceApplication, annotation: annotation) {
            return true
        }
        return false
    }
    
    // Add this method
    override func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
        if TikTokOpenSDKApplicationDelegate.sharedInstance().application(application, open: url, sourceApplication: sourceApplication, annotation: annotation) {
            return true
        }
        return false
    }
    
    // Add this method
    override func application(_ application: UIApplication, handleOpen url: URL) -> Bool {
        if TikTokOpenSDKApplicationDelegate.sharedInstance().application(application, open: url, sourceApplication: nil, annotation: "") {
            return true
        }
        return false
    }
}

copied to clipboard

Update your AppDelegate.swift file to register TikTok from the instruction of step 4 in TikTok's document here.

Twitter app register

• To get the Twitter app consumer key and secret key you can follow the instruction in this Stackoverflow link

TikTok app register

• To register a TikTok app for development, you can go to TikTok for developers page and create one. After create an app on TikTok for developers page you can get the client key and the client secret of the app to register and use the TikTok share features of the plugin.
• For the project config you can follow the step 3 and step 4 in this TikTok's document. However, we have integrated the step 3 and step 4 in the AppDelegate.swift file and the Info.plist file above, if you need to find some more information you can check them again in this document.

Facebook features

Working on both platform

Future<dynamic> shareFileToFacebook();
Future<dynamic> shareFeedContentToFacebook();
Future<dynamic> shareLinkContentToFacebook();
Future<dynamic> shareMediaContentFileToFacebook();
Future<dynamic> shareBackgroundAssetFileToFacebookStory();
Future<dynamic> shareStickerAssetToFacebookStory();
Future<dynamic> shareVideoToFacebookReels();
Future<dynamic> shareCameraEffectToFacebook();

copied to clipboard

Features for Android platform

Future<dynamic> shareBitmapImageBackgroundAssetToFacebookStory();
Future<dynamic> shareImageBackgroundAssetContentToFacebookStory();
Future<dynamic> shareVideoBackgroundAssetContentToFacebookStory();

copied to clipboard

Features for iOS platform

Future<dynamic> shareBackgroundImageAndStickerToFacebookStoryiOS();

copied to clipboard

Instagram features

Working on both platform

Future<dynamic> shareFileToInstagram();
Future<dynamic> sendMessageToInstagram();

copied to clipboard

Messsenger features

Working on both platform

Future<dynamic> shareFileToMessenger();
Future<dynamic> sendMessageToMessenger();
Future<dynamic> shareLinkContentToMessenger();

copied to clipboard

Telegram features

Working on both platform

Future<dynamic> sendMessageToTelegram();
Future<dynamic> openTelegramDirectMessage();
Future<dynamic> openTelegramChannelViaShareLink();
Future<dynamic> shareFileToTelegram();

copied to clipboard

WhatsApp features

Working on both platform

Future<dynamic> shareFileToWhatsApp();
Future<dynamic> sendMessageToWhatsApp();

copied to clipboard

Twitter features

Working on both platform

Future<dynamic> createTwitterTweet();
Future<dynamic> shareFileToTwitter();

copied to clipboard

TikTok features

Working on both platform

Future<dynamic> shareFilesToTikTok();
Future<dynamic> openTikTokUserPage();

copied to clipboard

Example

Facebook

• Future<dynamic> shareFileToFacebook()

ElevatedButton(
  onPressed: () async {
    var video =
            await _picker.pickImage(source: ImageSource.gallery);
    
    if (video != null) {
      LecleSocialShare.F.shareFileToFacebook(
        filePath: video.path,
        dstPath: 'your_custom_save_folder',
        fileProviderPath: 'your_custom_fileProvider_path',
        fileType: AssetType.image,
      );
    }
  },
  child: const Text('Share file to facebook'),
),

copied to clipboard

• Future<dynamic> shareFeedContentToFacebook()

ElevatedButton(
  onPressed: () {
    LecleSocialShare.F.shareFeedContentToFacebook(
      link: "https://pub.dev",
      linkName: "pub",
      hashtag: "flutter_pub",
    );
  },
  child: const Text('Share feed content to facebook'),
),

copied to clipboard

• Future<dynamic> shareLinkContentToFacebook()

ElevatedButton(
  onPressed: () {
    LecleSocialShare.F.shareLinkContentToFacebook(
      contentUrl: "https://pub.dev",
    );
  },
  child: const Text('Share link content to facebook'),
),

copied to clipboard

• Future<dynamic> shareMediaContentFileToFacebook()

ElevatedButton(
  onPressed: () async {
  imageUrls = (await _picker.pickMultiImage())?.map((image) => image.path).toList();
  videoUrls = (await _pickFile(FileType.video, allowMultiple: true))?.paths;
  
    LecleSocialShare.F.shareMediaContentFileToFacebook(
      imageUrls: imageUrls,
      videoUrls: videoUrls,
      fileProviderPath: 'your_custom_fileProvider_path',
    );
  },
  child: const Text('Share media content file to facebook'),
),

copied to clipboard

• Future<dynamic> shareCameraEffectToFacebook()

ElevatedButton(
  onPressed: () async {
    var texture =
        await _picker.pickImage(source: ImageSource.gallery);

    if (texture != null) {
      LecleSocialShare.F.shareCameraEffectToFacebook(
        cameraEffectTextures: CameraEffectTextures(
          textureKey: 'texture_key',
          textureUrl: texture.path,
        ),
        cameraEffectArguments: const CameraEffectArguments(
          argumentKey: 'argument_key',
          argumentValue: 'argument_value',
          argumentList: ['argument_value'],
        ),
        hashtag: '#helloworld',
        contentUrl: 'https://pub.dev',
      );
    }
  },
  child: const Text('Share camera effect to facebook'),
)

copied to clipboard

• Future<dynamic> shareBackgroundAssetFileToFacebookStory()

ElevatedButton(
  onPressed: () async {
    var image = await _picker.pickVideo(source: ImageSource.gallery);
    
    LecleSocialShare.F.shareBackgroundAssetFileToFacebookStory(
      appId: 'your_facebook_app_id',
      filePath: image?.path,
      fileProviderPath: 'your_custom_fileProvider_path',
      fileType: AssetType.video,
    );
  },
  child: const Text(
    'Share background asset file to facebook story',
  ),
),

copied to clipboard

• Future<dynamic> shareStickerAssetToFacebookStory()

ElevatedButton(
  onPressed: () async {
    var image = await _picker.pickImage(source: ImageSource.gallery);
    LecleSocialShare.F.shareStickerAssetToFacebookStory(
      appId: 'your_facebook_app_id',
      stickerPath: image?.path,
      fileProviderPath: 'your_custom_fileProvider_path',
    );
  },
  child: const Text('Share sticker background asset to facebook story'),
),

copied to clipboard

• Future<dynamic> shareBitmapImageBackgroundAssetToFacebookStory()

// ShareStoryContent class in Facebook SDK is not working for now, you can use 
// Future<dynamic> shareImageBackgroundAssetToFacebookStory() or Future<dynamic> shareStickerAssetToFacebookStory()
// methods instead.
Visibility(
  visible: Platform.isAndroid,
  child: ElevatedButton(
    onPressed: () async {
      var image = await _picker.pickImage(source: ImageSource.gallery);
      LecleSocialShare.F.shareBitmapImageBackgroundAssetToFacebookStory(
        imagePath: image?.path,
        fileProviderPath: 'your_custom_fileProvider_path',
      );
    },
    child: const Text('Share bitmap image background asset to facebook story'),
  ),
),

copied to clipboard

• Future<dynamic> shareImageBackgroundAssetContentToFacebookStory()

// ShareStoryContent class in Facebook SDK is not working for now, you can use 
// Future<dynamic> shareImageBackgroundAssetToFacebookStory() or Future<dynamic> shareStickerAssetToFacebookStory()
// methods instead.
Visibility(
  visible: Platform.isAndroid,
  child: ElevatedButton(
    onPressed: () async {
      var image = await _picker.pickImage(source: ImageSource.gallery);
      LecleSocialShare.F.shareImageBackgroundAssetContentToFacebookStory(
        photoBackgroundAssetPath: image?.path,
        fileProviderPath: 'your_custom_fileProvider_path',
      );
    },
    child: const Text('Share photo background asset to facebook story'),
  ),
),

copied to clipboard

• Future<dynamic> shareVideoBackgroundAssetContentToFacebookStory()

// ShareStoryContent class in Facebook SDK is not working for now, you can use 
// Future<dynamic> shareVideoBackgroundAssetToFacebookStory() method instead.
Visibility(
  visible: Platform.isAndroid,
  child: ElevatedButton(
    onPressed: () async {
      var video = await _picker.pickVideo(source: ImageSource.gallery);
      LecleSocialShare.F.shareVideoBackgroundAssetContentToFacebookStory(
        videoBackgroundAssetPath: video?.path,
        fileProviderPath: 'your_custom_fileProvider_path',
      );
    },
    child: const Text('Share video background asset to facebook story'),
  ),
),

copied to clipboard

• Future<dynamic> shareVideoToFacebookReels()

ElevatedButton(
  onPressed: () async {
    var sticker = await _picker.pickImage(source: ImageSource.gallery);
    var video = await _pickFile(FileType.video);
    
    LecleSocialShare.F.shareVideoToFacebookReels(
      filePath: video?.paths[0],
      fileProviderPath: 'your_custom_fileProvider_path',
      appId: 'your_facebook_app_id',
      stickerPath: sticker?.path,
    );
  },
  child: const Text('Share video asset (and sticker on Android) to facebook reels'),
),

copied to clipboard

• Future<dynamic> shareBackgroundImageAndStickerToFacebookStoryiOS()

Visibility(
  visible: Platform.isIOS,
  child: ElevatedButton(
    onPressed: () async {
      var images = await _picker.pickMultiImage();
      var stickers = await _picker.pickMultiImage();

      LecleSocialShare.F.shareBackgroundImageAndStickerToFacebookStoryiOS(
        photoBackgroundAssetPaths: images?.map((image) => image.path).toList(),
        stickerAssetPaths: stickers?.map((image) => image.path).toList(),
        appId: 'your_facebook_app_id',
      );
    },
    child: const Text('Share background image and sticker asset to facebook story iOS'),
  ),
),

copied to clipboard

Instagram

• Future<dynamic> shareFileToInstagram()

ElevatedButton(
  onPressed: () async {
    var video = await _picker.pickImage(source: ImageSource.gallery);
  
    if (video != null) {
      LecleSocialShare.I.shareFileToInstagram(
        filePath: video.path,
        fileProviderPath: 'your_custom_fileProvider_path',
        fileType: AssetType.image,
      );
    }
  },
  child: const Text('Share file to instagram'),
),

copied to clipboard

• Future<dynamic> sendMessageToInstagram()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.I.sendMessageToInstagram(
      message: 'Hello world',
    );
  },
  child: const Text('Send message to instagram'),
),

copied to clipboard

Messenger

• Future<dynamic> shareFileToMessenger()

ElevatedButton(
  onPressed: () async {
    var video = await _picker.pickVideo(source: ImageSource.gallery);
    
    LecleSocialShare.M.shareFileToMessenger(
      filePath: video?.path,
      fileProviderPath: 'your_custom_fileProvider_path',
      fileType: AssetType.video,
      hashtag: '#helloworld',
      contentUrl: 'https://pub.dev',
    );
  },
  child: const Text('Share file to messenger'),
),

copied to clipboard

• Future<dynamic> sendMessageToMessenger()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.M.sendMessageToMessenger(
      message: 'https://pub.dev',
      quote: 'Hello world',
      hashtag: '#hello',
    );
  },
  child: const Text('Send message to messenger'),
),

copied to clipboard

• Future<dynamic> shareLinkContentToMessenger()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.M.shareLinkContentToMessenger(
      contentUrl: 'https://pub.dev',
      quote: 'Hello world',
      hashtag: '#hello',
    );
  },
  child: const Text('Share link content to messenger'),
),

copied to clipboard

Telegram

• Future<dynamic> sendMessageToTelegram()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.T.sendMessageToTelegram(
      message: 'Hello world',
    );
  },
  child: const Text('Send message to Telegram'),
),

copied to clipboard

• Future<dynamic> openTelegramDirectMessage()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.T.openTelegramDirectMessage(
      username: 'user_name',
    );
  },
  child: const Text('Open Telegram direct message'),
),

copied to clipboard

• Future<dynamic> openTelegramChannelViaShareLink()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.T.openTelegramChannelViaShareLink(
      inviteLink: 'your_invite_link',
    );
  },
  child: const Text('Open Telegram group via invite link'),
),

copied to clipboard

• Future<dynamic> shareFileToTelegram()

ElevatedButton(
  onPressed: () async {
    var video = await _picker.pickVideo(source: ImageSource.gallery);
  
    LecleSocialShare.T.shareFileToTelegram(
      filePath: video?.path,
      fileProviderPath: 'your_custom_fileProvider_path',
      fileType: AssetType.any,
      message: 'Hello world',
    );
  },
  child: const Text('Share file to Telegram'),
),

ElevatedButton(
  onPressed: () async {
    var image = await _picker.pickImage(source: ImageSource.gallery);

    LecleSocialShare.T.shareFileToTelegram(
      filePath: image?.path,
      fileProviderPath: 'your_custom_fileProvider_path',
      fileType: AssetType.any,
      message: 'Hello world',
    );
  },
  child: const Text('Share file to Telegram'),
),

copied to clipboard

WhatsApp

• Future<dynamic> shareFileToWhatsApp()

ElevatedButton(
onPressed: () async {
    var file = await _pickFile(FileType.any);
  
    LecleSocialShare.W.shareFileToWhatsApp(
      filePath: file?.paths[0],
      fileType: AssetType.pdf,
      fileProviderPath: 'your_custom_fileProvider_path',
      message: 'Hello world',
    );
  },
  child: const Text('Share file to WhatsApp'),
),

copied to clipboard

• Future<dynamic> sendMessageToWhatsApp()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.W.sendMessageToWhatsApp(
      message: 'https://pub.dev',
      phoneNumber: "receiver_phone_number",
    );
  },
  child: const Text('Send message to WhatsApp'),
),

copied to clipboard

Twitter

• Future<dynamic> createTwitterTweet()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.TW.createTwitterTweet(
      title: 'Hello world',
      attachedUrl: "https://pub.dev",
      hashtags: [
        'hello',
        'world',
      ],
      via: 'abc',
      related: ['twitter', 'twitterapi'],
    );
  },
  child: const Text('Create Twitter tweet'),
),

copied to clipboard

• Future<dynamic> shareFileToTwitter()

ElevatedButton(
  onPressed: () async {
    var file = await _picker.pickImage(source: ImageSource.gallery);
  
    LecleSocialShare.TW.shareFileToTwitter(
      filePath: file?.path,
      fileProviderPath: 'your_custom_fileProvider_path',
      fileType: AssetType.image,
      iOSConsumerKey: 'abc',
      iOSSecretKey: 'xyz',
      title: "Hello world",
    );
  },
  child: const Text('Share file to Twitter'),
),

copied to clipboard

TikTok

• Future<dynamic> shareFilesToTikTok()

ElevatedButton(
  onPressed: () async {
    var res = await _picker.pickMultiImage();
    
    LecleSocialShare.TI.shareFilesToTikTok(
      fileUrls: res?.map((e) => e.path).toList(),
      fileType: AssetType.image,
      fileProviderPath: 'your_custom_fileProvider_path',
    );
  },
  child: const Text('Share files to TikTok'),
),

copied to clipboard

• Future<dynamic> openTikTokUserPage()

ElevatedButton(
  onPressed: () async {
    LecleSocialShare.TI.openTikTokUserPage(
      username: 'username',
    );
  },
  child: const Text('Open TikTok user page'),
),

copied to clipboard