Flutter Social Platform Share

A Flutter plugin for sharing images to social platforms like Facebook through their native SDKs.

Features

  • Share images to Facebook using the official Facebook SDK
  • Native Android implementation
  • Simple and easy-to-use API
  • Proper error handling and callbacks

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_social_platform_share: ^1.0.0

Usage

Initialize and Share

import 'package:flutter_social_platform_share/flutter_social_share.dart';

// Initialize Facebook SDK (reads from --dart-define)
await FlutterSocialShare.facebook.init();

// Or pass credentials explicitly
await FlutterSocialShare.facebook.init(
  appId: 'YOUR_FACEBOOK_APP_ID',
  clientToken: 'YOUR_FACEBOOK_CLIENT_TOKEN',
);

// Share an image to Facebook
final result = await FlutterSocialShare.facebook.shareImage(
  '/path/to/your/image.jpg',
  caption: 'Check out this image!',
);

if (result.isSuccess) {
  print('Successfully shared to Facebook!');
} else if (result.isCancelled) {
  print('User cancelled the share');
} else {
  print('Error: ${result.errorMessage}');
}

Running with Credentials

Use --dart-define to pass your Facebook credentials:

flutter run --dart-define=FB_APP_ID=your_app_id --dart-define=FB_CLIENT_TOKEN=your_client_token

For building:

flutter build apk --dart-define=FB_APP_ID=your_app_id --dart-define=FB_CLIENT_TOKEN=your_client_token

Requirements

  • Flutter ≥ 3.3.0
  • Dart ≥ 3.6.0
  • Android SDK ≥ 24
  • Facebook App with valid App ID and Client Token

Getting Facebook Credentials

  1. Go to Facebook Developers
  2. Create a new app or use an existing one
  3. Get your App ID from the app dashboard
  4. Generate a Client Token in App Settings > Advanced

Limitations

  • Currently only supports Android platform
  • Caption parameter is not supported in the current Facebook SDK version
  • Requires Facebook app to be installed on the device

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Libraries

flutter_social_share