cordova-plugin-x-socialsharing

If you cannot use a CLI, follow these steps to manually integrate the plugin:

1. Configure config.xml

Add the appropriate feature tag to your config.xml files:

iOS:

<feature name="SocialSharing">
  <param name="ios-package" value="SocialSharing" />
</feature>

Android:

<feature name="SocialSharing">
  <param name="android-package" value="nl.xservices.plugins.SocialSharing" />
</feature>

Windows Phone:

<feature name="SocialSharing">
  <param name="wp-package" value="SocialSharing"/>
</feature>

2. Platform Specific Requirements

Android: To share remote files (like images) on Android, you must first store them locally. Add this permission to your AndroidManifest.xml:

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

iOS: You must add Social.framework and MessageUI.framework to your project. In Xcode, go to Build Phases > Link Binary With Libraries and add both frameworks.

3. Add JavaScript and Source Files

1. Copy SocialSharing.js to your project and reference it in index.html:

<script type="text/javascript" src="js/SocialSharing.js"></script>

2. Copy the platform-specific source files to the following locations:

• iOS: Copy SocialSharing.h and SocialSharing.m to platforms/ios/<ProjectName>/Plugins
• Android: Copy SocialSharing.java to platforms/android/src/nl/xservices/plugins (create the folders if they don't exist)
• Windows Phone: Copy SocialSharing.cs to platforms/wp8/Plugins/nl.x-services.plugins.socialsharing (create the folders if they don't exist)

<!-- for iOS -->
<feature name="SocialSharing">
  <param name="ios-package" value="SocialSharing" />
</feature>

<!-- for Android (you will find one in res/xml) -->
<feature name="SocialSharing">
  <param name="android-package" value="nl.xservices.plugins.SocialSharing" />
</feature>

<!-- for Windows Phone -->
<feature name="SocialSharing">
  <param name="wp-package" value="SocialSharing"/>
</feature>

You can customize the iOS share sheet by excluding specific activities. Add the SocialSharingExcludeActivities key to your app's main .plist file with an array of activity strings.

Available activities to disable:

• com.apple.UIKit.activity.PostToFacebook
• com.apple.UIKit.activity.PostToTwitter
• com.apple.UIKit.activity.PostToFlickr
• com.apple.UIKit.activity.PostToWeibo
• com.apple.UIKit.activity.PostToVimeo
• com.apple.UIKit.activity.TencentWeibo
• com.apple.UIKit.activity.Message
• com.apple.UIKit.activity.Mail
• com.apple.UIKit.activity.Print
• com.apple.UIKit.activity.CopyToPasteboard
• com.apple.UIKit.activity.AssignToContact
• com.apple.UIKit.activity.SaveToCameraRoll
• com.apple.UIKit.activity.AddToReadingList
• com.apple.UIKit.activity.AirDrop

<key>SocialSharingExcludeActivities</key>
<array>
  <string>com.apple.UIKit.activity.AssignToContact</string>
  <string>com.apple.UIKit.activity.CopyToPasteboard</string>
</array>

You can bypass the general share sheet and target specific applications directly using specialized methods.

Twitter

Use shareViaTwitter(message, [img], [url], [success], [error]).

Facebook

Use shareViaFacebook(message, [img], [url], [success], [error]). Workaround for Facebook prefilled message bugs: Use shareViaFacebookWithPasteMessageHint.

• Android: Shows a Toast message prompting the user to paste.
• iOS: Shows a short message prompting the user to paste (since v4.3.18).
• iOS Requirement: You must whitelist fb:// in your .plist file under LSApplicationQueriesSchemes.

Instagram

Use shareViaInstagram(message, [img], [success], [error]).

• iOS Requirement: Use canShareVia('instagram') first and whitelist the URL scheme.

WhatsApp

Use shareViaWhatsApp(message, [img], [url], [success], [error]).

• Direct to contact (Android): Use shareViaWhatsAppToPhone(phoneNumber, message, [img], [url], [success]).
• Direct to contact (iOS/Android): Use shareViaWhatsAppToReceiver(addressbookIdOrPhoneNumber, message, [img], [url], [success]). On iOS, use the Addressbook ID from the Cordova Contacts Plugin.

The shareWithOptions method is the recommended way to share content as it is the most feature-rich and provides cross-platform compatibility. It allows you to pass a single options object containing all shareable content. It also provides feedback via a success callback, indicating if the share was completed and which app was used (though Android app reporting varies by version).

Options Object Schema:

• message: String. The text to share. (Note: Not supported by some apps like Facebook or Instagram).
• subject: String. The subject line (e.g., for email).
• files: Array of strings. Filenames or URLs (local or remote).
• url: String. A web link to share.
• chooserTitle: String (Android only). Overrides the default share sheet title.
• appPackageName: String (Android only). The ID of a specific app to share with.
• iPadCoordinates: String (iOS only). Format: x,y,width,height to define the popover location.

var options = {
  message: 'share this',
  subject: 'the subject',
  files: ['', ''],
  url: 'https://www.website.com/foo/#bar?a=b',
  chooserTitle: 'Pick an app',
  appPackageName: 'com.apple.social.facebook',
  iPadCoordinates: '0,0,0,0'
};

var onSuccess = function(result) {
  console.log("Share completed? " + result.completed);
  console.log("Shared to app: " + result.app);
};

var onError = function(msg) {
  console.log("Sharing failed with message: " + msg);
};

window.plugins.socialsharing.shareWithOptions(options, onSuccess, onError);