react-native-story-share
Share your images to instagram stories.
OS | Type | Supported |
---|---|---|
iOS | BASE64 | YES |
FILE | YES | |
Android | BASE64 | YES |
FILE | YES |
Getting started
$ yarn add react-native-story-share
or
$ npm install react-native-story-share --save
Installation
- Either choose
Mostly automatic installation
orManual installation
- Follow the
Integration
guide
Mostly automatic installation
$ react-native link react-native-story-share
Manual installation
iOS
- In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
- Go to
node_modules
➜react-native-story-share
and addRNStoryShare.xcodeproj
- In XCode, in the project navigator, select your project. Add
libRNStoryShare.a
to your project'sBuild Phases
➜Link Binary With Libraries
- Run your project (
Cmd+R
)
Android
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.jobeso.RNStorySharePackage;
to the imports at the top of the file - Add
new RNStorySharePackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':react-native-story-share' project(':react-native-story-share').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-story-share/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':react-native-story-share')
Integration
iOS
Swift
- Under
Build Settings
sectionBuild Options
setAlways Embed Swift Started Libraries
totrue
- Make sure you have the following under
library search paths
$(inherited)
$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
Info.plist
- add
instagram-stories
to theLSApplicationQueriesSchemes
key in your app's Info.plist.
...
<key>LSApplicationQueriesSchemes</key>
<array>
...
+ <string>instagram-stories</string>
</array>
...
Usage
Share To Instagram
import RNStoryShare from "react-native-story-share";
RNStoryShare.isInstagramAvailable()
.then(isAvailable => {
if(isAvailable){
RNStoryShare.shareToInstagram({
type: RNStoryShare.BASE64, // or RNStoryShare.FILE
attributionLink: 'https://myproject.com',
backgroundAsset: 'data:image/png;base64,iVBO...',
stickerAsset: 'data:image/png;base64,iVBO...',
backgroundBottomColor: '#f44162',
backgroundTopColor: '#f4a142'
});
}
})
.catch(e => console.log(e));
API
Constants
Name | Value |
---|---|
BASE64 | "base64" |
FILE | "file" |
Methods
isInstagramAvailable(): Promise<boolean>
Return a boolean indicating if Instagram is available on the phone.
shareToInstagram(config: ShareConfigObject): Promise<void>
type ShareConfigObject = {
type: "base64" || "file",
attributionLink: string,
backgroundAsset: string,
stickerAsset: string,
stickerOptions: {
height: integer,
width: integer
}
}
Shares a file or base64 image as background, sticker or both to Instagram. The background colors are only applyed when no background asset is set.