Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/react-native-share/react-native-share
Social share, sending simple data to other apps.
https://github.com/react-native-share/react-native-share
android bridge intent ios react react-native share uwp
Last synced: about 1 hour ago
JSON representation
Social share, sending simple data to other apps.
- Host: GitHub
- URL: https://github.com/react-native-share/react-native-share
- Owner: react-native-share
- License: mit
- Created: 2015-09-30T02:27:34.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T18:52:59.000Z (3 months ago)
- Last Synced: 2024-10-29T15:27:11.357Z (3 months ago)
- Topics: android, bridge, intent, ios, react, react-native, share, uwp
- Language: Java
- Homepage: https://react-native-share.github.io/react-native-share
- Size: 12.1 MB
- Stars: 3,637
- Watchers: 60
- Forks: 945
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# react-native-share [](https://app.circleci.com/pipelines/github/react-native-share/react-native-share) [](http://badge.fury.io/js/react-native-share) [](https://github.com/semantic-release/semantic-release)
React Native Share, is a simple tool for sharing messages and files with other apps.
# Getting started 🚀
---
## Expo Managed Workflow
For Expo projects, you will need to be on a managed workflow and use the following command:
```shell
npx expo install react-native-share
```
Configure you `app.config.ts` or `app.json` to use the permissions needed by the library:
```json
{
"plugins": [
[
"react-native-share",
{
"ios": [
"fb",
"instagram",
"twitter",
"tiktoksharesdk",
],
"android": [
"com.facebook.katana",
"com.instagram.android",
"com.twitter.android",
"com.zhiliaoapp.musically",
]
}
]
]
}
```
`ios` parameter will take care of adding queries (LSApplicationQueriesSchemes) to the Info.plist.
```xml
LSApplicationQueriesSchemes
fb
instagram
twitter
tiktoksharesdk
```
`android` parameter will take care of adding queries to the AndroidManifest.xml.
```xml
```
And prebuild the project with `expo prebuild`.
## Bare React Native
If you are using `react-native >= 0.7X` and/or the new arch you just need to do a simple:
```shell
yarn add react-native-share
```
Or if are using npm:
```shell
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` or `cd ios && pod install`. After that, you should be able to use the library on both Platforms, iOS and Android.
# Usage
Then simply import:
```js
import Share from 'react-native-share';
Share.open(options)
.then((res) => {
console.log(res);
})
.catch((err) => {
err && console.log(err);
});
```
Which you do something similar to this:
# Documentation
If you are using a older version of `react-native` or `react-native-share`, having any problem or want to know how use `Share.open` and other functions, please refer to our new [docs](https://react-native-share.github.io/react-native-share) and help us improve that.🚀