nativescript-social-share

NativeScript Social Share

A NativeScript module to use the native social sharing widget on Android and iOS. Currently this module only supports image sharing.

Installation

Run npm install nativescript-social-share --save from your project's inner app directory:

.
├── app
│   ├── app <------------- run npm install from here
│   │   ├── app.css
│   │   ├── app.js
│   │   ├── bootstrap.js
│   │   ├── main-page.js
│   │   ├── main-page.xml
│   │   ├── node_modules
│   │   │   └── nativescript-social-share <-- The install will place the module's code here
│   │   │       └── ...
│   │   └── package.json <-- The install will register “nativescript-social-share” as a dependency here
│   └── tns_modules
│       └── ...
└── platforms
    ├── android
    └── ios

As is, using npm within NativeScript is still experimental, so it's possible that you'll run into some issues. A more complete solution is in the works, and you can check out this issue for an update on its progress and to offer feedback.

If npm doesn't end up working for you, you can just copy and paste this repo's social-share.android.js and social-share.ios.js files into your app and reference them directly.

Usage

To use the social share module you must first require() it:

var socialShare = require( "./node_modules/nativescript-social-share/social-share" );

After you have a reference to the module, you can its shareImage() method, which expects an ImageSource object. The code below loads an image from the app and invokes the share widget with it:

var socialShare = require( "./node_modules/nativescript-social-share/social-share" );
var imageSource = require( "image-source" );

var image = imageSource.fromFile( "~/path/to/myImage.jpg" );
socialShare.shareImage(image);

Screenshots