Repository files navigation

React Native Share, is a simple tool for sharing messages and files with other apps.

For Expo projects, you will need to be on a managed workflow and use the following command:

npx expo install react-native-share

Configure youapp.config.ts orapp.json to use the permissions needed by the library:

{"plugins": [    ["react-native-share",      {"ios": ["fb","instagram","twitter","tiktoksharesdk",        ],"android": ["com.facebook.katana","com.instagram.android","com.twitter.android","com.zhiliaoapp.musically",        ],"enableBase64ShareAndroid":true      }    ]  ]}

ios parameter will take care of adding queries (LSApplicationQueriesSchemes) to the Info.plist.

<key>LSApplicationQueriesSchemes</key><array>  <string>fb</string>  <string>instagram</string>  <string>twitter</string>  <string>tiktoksharesdk</string></array>

android parameter will take care of adding queries to the AndroidManifest.xml.

<queries>  <packageandroid:name="com.facebook.katana" />  <packageandroid:name="com.instagram.android" />  <packageandroid:name="com.twitter.android" />  <packageandroid:name="com.zhiliaoapp.musically" /></queries>

enableBase64ShareAndroid will take care of adding the permission to the AndroidManifest.xml.

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

And prebuild the project withexpo prebuild.

If you are usingreact-native >= 0.7X and/or the new arch you just need to do a simple:

yarn add react-native-share

Or if are using npm:

npm i react-native-share --save

After that, we need to install the dependencies to use the project on iOS(you can skip this part if you are using this on Android).

Now run a simple:npx pod-install orcd ios && pod install. After that, you should be able to use the library on both Platforms, iOS and Android.

Then simply import:

importSharefrom'react-native-share';Share.open(options).then((res)=>{console.log(res);}).catch((err)=>{err&&console.log(err);});

Which you do something similar to this:

If you are using a older version ofreact-native orreact-native-share, having any problem or want to know how useShare.open and other functions, please refer to our newdocs and help us improve that.🚀