react-native-share 11.1.0 → 12.0.1

package/README.md

@@ -6,6 +6,67 @@ React Native Share, is a simple tool for sharing messages and files with other a
 
 ---
 
+## 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
+<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.
+
+```xml
+<queries>
+  <package android:name="com.facebook.katana" />
+  <package android:name="com.instagram.android" />
+  <package android:name="com.twitter.android" />
+  <package android:name="com.zhiliaoapp.musically" />
+</queries>
+```
+
+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
@@ -22,6 +83,8 @@ After that, we need to install the dependencies to use the project on iOS(you ca
 
 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

package/app.plugin.js

@@ -0,0 +1,2 @@
+// eslint-disable-next-line no-undef, import/no-commonjs
+module.exports = require('./plugin/build');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-share",
   "description": "Social share, sending simple data to other apps.",
-  "version": "11.1.0",
+  "version": "12.0.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/react-native-community/react-native-share.git"
@@ -22,7 +22,9 @@
     "RNShare.podspec",
     "!**/__tests__",
     "!**/__fixtures__",
-    "!**/__mocks__"
+    "!**/__mocks__",
+    "app.plugin.js",
+    "plugin"
   ],
   "devDependencies": {
     "@babel/core": "^7.23.3",
@@ -30,6 +32,7 @@
     "@babel/runtime": "^7.23.2",
     "@commitlint/cli": "^11.0.0",
     "@commitlint/config-conventional": "^11.0.0",
+    "@expo/config-plugins": "^9.0.10",
     "@react-native/eslint-config": "^0.74.0",
     "@react-native/metro-config": "^0.73.2",
     "@semantic-release/commit-analyzer": "^11.1.0",
@@ -37,6 +40,7 @@
     "@semantic-release/github": "^9.2.1",
     "@semantic-release/npm": "^11.0.1",
     "@semantic-release/release-notes-generator": "^12.1.0",
+    "@tsconfig/node-lts": "^22.0.0",
     "@tsconfig/react-native": "^3.0.2",
     "@types/react": "^18.2.37",
     "@types/react-native": "^0.72.6",
@@ -60,7 +64,9 @@
     "typescript": "^5.2.2"
   },
   "resolutions": {
-    "eslint-plugin-prettier": "5.0.1"
+    "eslint-plugin-prettier": "5.0.1",
+    "wrap-ansi": "7.0.0",
+    "string-width": "4.1.0"
   },
   "keywords": [
     "react-native",
@@ -90,9 +96,10 @@
     "start:ios": "react-native run-ios",
     "lint": "eslint \"src/**/*.{js,ts,tsx}\"  --max-warnings=0",
     "typescript": "tsc --noEmit",
+    "build:expo-plugin": "tsc --project ./plugin/tsconfig.json",
     "validate": "yarn lint && yarn typescript",
     "ci:publish": "npx semantic-release",
-    "prepare": "bob build",
+    "prepare": "bob build && yarn build:expo-plugin",
     "windows": "react-native run-windows"
   },
   "husky": {

package/plugin/build/index.d.ts

@@ -0,0 +1 @@
+export {};

package/plugin/build/index.js

@@ -0,0 +1,77 @@
+import { withAndroidManifest, createRunOncePlugin, } from '@expo/config-plugins';
+// eslint-disable-next-line import/no-commonjs, @typescript-eslint/no-var-requires
+const pkg = require('../../package.json');
+/**
+ * @type {import('./types').ManifestQueries}
+ * what we are trying to add:
+ * <queries>
+    <package android:name="com.facebook.katana"/>
+    <package android:name="com.instagram.android"/>
+    <package android:name="com.twitter.android"/>
+    <package android:name="com.zhiliaoapp.musically"/>
+    <intent></intent>
+      <action android:name="android.intent.action.VIEW"/>
+      <category android:name="android.intent.category.BROWSABLE"/>
+      <data android:scheme="https"/>
+    </intent>
+  </queries>
+ */
+/**
+ * @param {import('@expo/config-plugins').ExportedConfig} config
+ */
+const withAndroidManifestService = (config, props) => {
+    return withAndroidManifest(config, (config) => {
+        config.modResults.manifest = {
+            ...config.modResults.manifest,
+            queries: {
+                package: props?.android?.map((social) => ({
+                    $: {
+                        'android:name': social,
+                    },
+                })),
+                intent: [
+                    {
+                        action: {
+                            $: {
+                                'android:name': 'android.intent.action.VIEW',
+                            },
+                        },
+                        category: {
+                            $: {
+                                'android:name': 'android.intent.category.BROWSABLE',
+                            },
+                        },
+                        data: {
+                            $: {
+                                'android:scheme': 'https',
+                            },
+                        },
+                    },
+                ],
+            },
+        };
+        return config;
+    });
+};
+const withInfoPlist = (config, props) => {
+    return {
+        ...config,
+        ios: {
+            ...config.ios,
+            infoPlist: {
+                ...config.ios?.infoPlist,
+                LSApplicationQueriesSchemes: {
+                    ...config.ios?.infoPlist?.LSApplicationQueriesSchemes,
+                    ...props?.ios,
+                },
+            },
+        },
+    };
+};
+function withSocialShare(config, props) {
+    config = withAndroidManifestService(config, props); // Android
+    config = withInfoPlist(config, props); // iOS
+    return config;
+}
+// eslint-disable-next-line import/no-commonjs
+module.exports = createRunOncePlugin(withSocialShare, pkg.name, pkg.version);

package/plugin/src/index.ts

@@ -0,0 +1,94 @@
+import {
+  withAndroidManifest,
+  createRunOncePlugin,
+  ExportedConfigWithProps,
+  ExportedConfig,
+} from '@expo/config-plugins';
+
+// eslint-disable-next-line import/no-commonjs, @typescript-eslint/no-var-requires
+const pkg = require('../../package.json');
+
+/**
+ * @type {import('./types').ManifestQueries}
+ * what we are trying to add:
+ * <queries>
+    <package android:name="com.facebook.katana"/>
+    <package android:name="com.instagram.android"/>
+    <package android:name="com.twitter.android"/>
+    <package android:name="com.zhiliaoapp.musically"/>
+    <intent></intent>
+      <action android:name="android.intent.action.VIEW"/>
+      <category android:name="android.intent.category.BROWSABLE"/>
+      <data android:scheme="https"/>
+    </intent>
+  </queries>
+ */
+
+/**
+ * @param {import('@expo/config-plugins').ExportedConfig} config
+ */
+const withAndroidManifestService = (config: ExportedConfig, props: WithSocialShareProps) => {
+  return withAndroidManifest(config, (config: ExportedConfigWithProps) => {
+    config.modResults.manifest = {
+      ...config.modResults.manifest,
+      queries: {
+        package: props?.android?.map((social) => ({
+          $: {
+            'android:name': social,
+          },
+        })),
+        intent: [
+          {
+            action: {
+              $: {
+                'android:name': 'android.intent.action.VIEW',
+              },
+            },
+            category: {
+              $: {
+                'android:name': 'android.intent.category.BROWSABLE',
+              },
+            },
+            data: {
+              $: {
+                'android:scheme': 'https',
+              },
+            },
+          },
+        ],
+      },
+    };
+
+    return config;
+  });
+};
+
+const withInfoPlist = (config: ExportedConfig, props: WithSocialShareProps) => {
+  return {
+    ...config,
+    ios: {
+      ...config.ios,
+      infoPlist: {
+        ...config.ios?.infoPlist,
+        LSApplicationQueriesSchemes: {
+          ...config.ios?.infoPlist?.LSApplicationQueriesSchemes,
+          ...props?.ios,
+        },
+      },
+    },
+  };
+};
+
+type WithSocialShareProps = {
+  ios: string[];
+  android: string[];
+};
+
+function withSocialShare(config: ExportedConfig, props: WithSocialShareProps) {
+  config = withAndroidManifestService(config, props); // Android
+  config = withInfoPlist(config, props); // iOS
+  return config;
+}
+
+// eslint-disable-next-line import/no-commonjs
+module.exports = createRunOncePlugin(withSocialShare, pkg.name, pkg.version);

package/plugin/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "build",
+    "rootDir": "src",
+    "declaration": true
+  },
+  "include": ["./src"]
+}