### Install Dependencies and Run on iOS

Source: https://github.com/expensify/react-native-share-menu/blob/master/example/README.md

Installs project dependencies using yarn, sets up iOS native dependencies with CocoaPods, and runs the application on an iOS simulator or device. Requires Node.js, Yarn, and Xcode.

```shell
yarn install
```

```shell
cd ios/ && pod install
```

```shell
yarn react-native run-ios
```

--------------------------------

### Install react-native-share-menu

Source: https://github.com/expensify/react-native-share-menu/blob/master/README.md

Installs the react-native-share-menu package using npm. This is the initial step to integrate the library into your React Native project.

```bash
npm i --save react-native-share-menu
```

--------------------------------

### Install Pods

Source: https://github.com/expensify/react-native-share-menu/blob/master/IOS_INSTRUCTIONS.md

Command to install or update CocoaPods dependencies after modifying the Podfile.

```shell
pod install
```

--------------------------------

### Add Share Extension Files

Source: https://github.com/expensify/react-native-share-menu/blob/master/IOS_INSTRUCTIONS.md

Instructions for adding the ShareViewController.swift file from the library to your Xcode Share Extension target. Ensures the correct file is linked and not copied.

```shell
On the pop-up, select `node_modules/react-native-share-menu/ios/ShareViewController.swift`. Make sure `Copy items if needed` is NOT selected and that the selected target is your newly created Share Extension
```

--------------------------------

### Register ShareMenuPackage in MainApplication.java

Source: https://github.com/expensify/react-native-share-menu/blob/master/ANDROID_INSTRUCTIONS.md

This snippet shows how to register the `ShareMenuPackage` within your `MainApplication.java` file. This is crucial for initializing the library with the React Native application context.

```java
import com.meedan.ShareMenuPackage;  // <--- import

public class MainApplication extends Application implements ReactApplication {
  ......
  @Override
  protected List<ReactPackage> getPackages() {
    return Arrays.<ReactPackage>asList(
      new MainReactPackage(),
      new ShareMenuPackage()  // <------ add here
    );
  }
  ......

}
```

--------------------------------

### Update Podfile for Share Extension

Source: https://github.com/expensify/react-native-share-menu/blob/master/IOS_INSTRUCTIONS.md

Modifies the Podfile to include the react-native-share-menu pod within the Share Extension target and sets APPLICATION_EXTENSION_API_ONLY to 'NO' for all targets.

```diff
target '<PROJECT_NAME>' do
  config = use_native_modules!

  use_react_native!(:path => config["reactNativePath"])

  target '<PROJECT_NAME>Tests' do
    inherit! :complete
    # Pods for testing
  end

  # Enables Flipper.
  #
  # Note that if you have use_frameworks! enabled, Flipper will not work and
  # you should disable these next few lines.
  use_flipper!
  post_install do |installer|
    flipper_post_install(installer)
+    installer.pods_project.targets.each do |target|
+      target.build_configurations.each do |config|
+        config.build_settings['APPLICATION_EXTENSION_API_ONLY'] = 'NO'
+      end
+    end
  end
end

+target '<SHARE_EXTENSION_NAME>' do
+  use_react_native!
+
+  pod 'RNShareMenu', :path => '../node_modules/react-native-share-menu'
+  # Manually link packages here to keep your extension bundle size minimal
+end
```

--------------------------------

### App Info.plist Configuration

Source: https://github.com/expensify/react-native-share-menu/blob/master/IOS_INSTRUCTIONS.md

Adds the necessary URL scheme configuration to the main application's Info.plist file, allowing the app to be opened via custom URL schemes.

```openstep property list
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>A_URL_SCHEME_UNIQUE_TO_YOUR_APP</string>
            <!-- This url scheme doesn't contain :// at the end - E.g. "mycustomscheme"-->
        </array>
    </dict>
</array>
```

--------------------------------

### Run on Android

Source: https://github.com/expensify/react-native-share-menu/blob/master/example/README.md

Runs the application on an Android emulator or connected device. Ensure an Android development environment is set up. May require starting the Metro bundler separately.

```shell
yarn react-native run-android
```

```shell
yarn start
```

--------------------------------

### Share Extension Info.plist Configuration

Source: https://github.com/expensify/react-native-share-menu/blob/master/IOS_INSTRUCTIONS.md

Configures the Share Extension's Info.plist with the host app's bundle identifier and URL scheme, and defines activation rules for supported content types.

```openstep property list
<key>HostAppBundleIdentifier</key>
<string>YOUR_APP_TARGET_BUNDLE_ID</string>
<key>HostAppURLScheme</key>
<string>YOUR_APP_URL_SCHEME_DEFINED_ABOVE</string>
<!-- This url scheme CONTAINS :// at the end - E.g. "mycustomscheme://"-->
<key>NSExtension</key>
<dict>
    <key>NSExtensionAttributes</key>
    <dict>
        <key>NSExtensionActivationRule</key>
        <dict>
            <!-- For a full list of available options, visit https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212-SW10 -->
            <key>NSExtensionActivationSupportsImageWithMaxCount</key>
            <integer>1</integer>
            <key>NSExtensionActivationSupportsText</key>
            <true/>
            <key>NSExtensionActivationSupportsWebURLWithMaxCount</key>
            <integer>1</integer>
        </dict>
    </dict>
    <key>NSExtensionMainStoryboard</key>
    <string>MainInterface</string>
    <key>NSExtensionPointIdentifier</key>
    <string>com.apple.share-services</string>
</dict>
```

--------------------------------

### Automatic Linking (iOS)

Source: https://github.com/expensify/react-native-share-menu/blob/master/README.md

Installs native iOS dependencies using CocoaPods. This command should be executed within the 'ios' directory for React Native versions 0.60 and above.

```bash
pod install
```

--------------------------------

### AppDelegate.m Share Menu Integration

Source: https://github.com/expensify/react-native-share-menu/blob/master/IOS_INSTRUCTIONS.md

Integrates the ShareMenuManager into the AppDelegate.m file to handle incoming URLs from the Share Extension, ensuring proper communication between the extension and the main app.

```objective-c
... 
#import <RNShareMenu/ShareMenuManager.h>

... 

@implementation AppDelegate
    ... 

    - (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
    {
      return [ShareMenuManager application:app openURL:url options:options];
    }
@end
```

--------------------------------

### Add Share Menu Dependency in app/build.gradle

Source: https://github.com/expensify/react-native-share-menu/blob/master/ANDROID_INSTRUCTIONS.md

This snippet demonstrates adding the compiled react-native-share-menu library as a project dependency in your `android/app/build.gradle` file. This step links the library to your application module.

```gradle
dependencies {
    ... 
    compile project(':react-native-share-menu')
}
```

--------------------------------

### Include Share Menu in Gradle settings.gradle

Source: https://github.com/expensify/react-native-share-menu/blob/master/ANDROID_INSTRUCTIONS.md

This snippet shows how to include the react-native-share-menu library project in your Android project's `settings.gradle` file. It ensures the library is recognized by the Gradle build system.

```gradle
include ':react-native-share-menu', ':app'
project(':react-native-share-menu').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-share-menu/android')
```

--------------------------------

### Example Usage: Handling Shared Content

Source: https://github.com/expensify/react-native-share-menu/blob/master/README.md

Demonstrates how to use the ShareMenu API to receive shared data (text, images, files) from other applications. It includes listeners for initial shares and new shares, and logic to display different content types.

```javascript
import React, { useState, useEffect, useCallback } from "react";
import { AppRegistry, Text, View, Image, Button } from "react-native";
import ShareMenu, { ShareMenuReactView } from "react-native-share-menu";

type SharedItem = {
  mimeType: string,
  data: string,
  extraData: any,
};

const Test = () => {
  const [sharedData, setSharedData] = useState(null);
  const [sharedMimeType, setSharedMimeType] = useState(null);

  const handleShare = useCallback((item: ?SharedItem) => {
    if (!item) {
      return;
    }

    const { mimeType, data, extraData } = item;

    setSharedData(data);
    setSharedMimeType(mimeType);
    // You can receive extra data from your custom Share View
    console.log(extraData);
  }, []);

  useEffect(() => {
    ShareMenu.getInitialShare(handleShare);
  }, []);

  useEffect(() => {
    const listener = ShareMenu.addNewShareListener(handleShare);

    return () => {
      listener.remove();
    };
  }, []);

  if (!sharedMimeType && !sharedData) {
    // The user hasn't shared anything yet
    return null;
  }

  if (sharedMimeType === "text/plain") {
    // The user shared text
    return <Text>Shared text: {sharedData}</Text>;
  }

  if (sharedMimeType.startsWith("image/")) {
    // The user shared an image
    return (
      <View>
        <Text>Shared image:</Text>
        <Image source={{ uri: sharedData }} />
      </View>
    );
  }

  // The user shared a file in general
  return (
    <View>
      <Text>Shared mime type: {sharedMimeType}</Text>
      <Text>Shared file location: {sharedData}</Text>
    </View>
  );
};

const Share = () => {
  const [sharedData, setSharedData] = useState("");
  const [sharedMimeType, setSharedMimeType] = useState("");

  useEffect(() => {
    ShareMenuReactView.data().then(({ mimeType, data }) => {
      setSharedData(data);
      setSharedMimeType(mimeType);
    });
  }, []);

  return (
    <View>
      <Button
        title="Dismiss"
        onPress={() => {
          ShareMenuReactView.dismissExtension();
        }}
      />
      <Button
        title="Send"
        onPress={() => {
          // Share something before dismissing
          ShareMenuReactView.dismissExtension();
        }}
      />
      <Button
        title="Dismiss with Error"
        onPress={() => {
          ShareMenuReactView.dismissExtension("Something went wrong!");
        }}
      />
      <Button
        title="Continue In App"
        onPress={() => {
          ShareMenuReactView.continueInApp();
        }}
      />
      <Button
        title="Continue In App With Extra Data"
        onPress={() => {
          ShareMenuReactView.continueInApp({ hello: "from the other side" });
        }}
      />
      {sharedMimeType === "text/plain" && <Text>{sharedData}</Text>}
      {sharedMimeType.startsWith("image/") && (
        <Image source={{ uri: sharedData }} />
      )}
    </View>
  );
};

AppRegistry.registerComponent("Test", () => Test);
AppRegistry.registerComponent("ShareMenuModuleComponent", () => Share);

```

--------------------------------

### Configure Intent Filter in AndroidManifest.xml

Source: https://github.com/expensify/react-native-share-menu/blob/master/ANDROID_INSTRUCTIONS.md

This snippet illustrates how to add an intent filter to your main activity in `AndroidManifest.xml`. This configuration allows your application to receive shared data (like plain text or images) from other apps.

```xml
<activity
  ... 
  android:documentLaunchMode="never">
  ...
  <intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="text/plain" />
    <data android:mimeType="image/*" />
    <!-- Any other mime types you want to support -->
  </intent-filter>
</activity>
```

--------------------------------

### ShareMenu API Methods

Source: https://github.com/expensify/react-native-share-menu/blob/master/API_DOCS.md

Provides methods for retrieving initial shared data when the app launches and for registering listeners to receive subsequent shared data from other applications.

```APIDOC
ShareMenu:
  getInitialShare(callback: ShareCallback) : void
    Gets the shared item the app was opened with, if any.

  addNewShareListener(callback: ShareCallback) : ShareListener
    Adds a listener for receiving shared data from other apps. Call `listener.remove()` to remove it on unmount.

ShareCallback:
  (share: ShareData?) => void

ShareListener:
  remove(): void
    Removes a previously registered listener.

ShareData:
  mimeType: String
    The mime type of the shared data.
  data: String
    Either the shared text, or the location of the shared file.
  extraData: Object | null
    Can be null. Any optional extra data your Share Extension React View opened the app with.
```

--------------------------------

### Manual Linking (React Native < 0.60)

Source: https://github.com/expensify/react-native-share-menu/blob/master/README.md

Manually links the native modules for older React Native versions (0.36+). This command is run from the project's root directory.

```bash
react-native link
```

--------------------------------

### Registering Share Extension Component

Source: https://github.com/expensify/react-native-share-menu/blob/master/SHARE_EXTENSION_VIEW.md

Registers the main React Native component for the Share Extension view using `AppRegistry`. This JavaScript code specifies the entry point for the Share Menu Module Component.

```javascript
import { AppRegistry } from "react-native";

AppRegistry.registerComponent(
  "ShareMenuModuleComponent",
  () => MyShareComponent
);
```

--------------------------------

### Run Script Phase for Bundling React Native Assets

Source: https://github.com/expensify/react-native-share-menu/blob/master/SHARE_EXTENSION_VIEW.md

A shell script phase added to the Share Extension's build settings. It bundles React Native code and assets, essential for release builds or when running outside the simulator.

```shell
export NODE_BINARY=node
export ENTRY_FILE=index.share.js
../node_modules/react-native/scripts/react-native-xcode.sh
```

--------------------------------

### Info.plist Configuration for Share Extension

Source: https://github.com/expensify/react-native-share-menu/blob/master/SHARE_EXTENSION_VIEW.md

Configures the Share Extension's Info.plist file with custom background color settings for the React Native view and allows arbitrary loads for localhost to facilitate development.

```openstep property list
<key>ReactShareViewBackgroundColor</key>
<dict>
    <key>Red</key>
    <integer>1</integer>
    <key>Green</key>
    <integer>1</integer>
    <key>Blue</key>
    <integer>1</integer>
    <key>Alpha</key>
    <integer>1</integer>
    <key>Transparent</key>
    <false/>
</dict>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>localhost</key>
        <dict>
            <key>NSExceptionAllowsInsecureHTTPLoads</key>
            <true/>
        </dict>
    </dict>
</dict>
```

--------------------------------

### ShareMenuReactView API Methods

Source: https://github.com/expensify/react-native-share-menu/blob/master/API_DOCS.md

Enables interaction with the Share Extension, allowing it to dismiss itself, open the main application, defer handling to the app, or retrieve shared data.

```APIDOC
ShareMenuReactView:
  dismissExtension(error?: String) : void
    Dismisses the open Share Extension. Send an error message as a parameter to notify the system that the share action was canceled.

  openApp() : void
    Opens the App from the Share Extension.

  continueInApp(extraData?: Object) : void
    Defers the handling of this share action to the main App. You can send any object as a parameter if you need more context to handle the share in-app.

  data() : Promise<ShareData>
    Gets the shared data this Share Extension was opened with.

ShareData:
  mimeType: String
    The mime type of the shared data.
  data: String
    Either the shared text, or the location of the shared file.
```

--------------------------------

### Objective-C Bridging Header Imports

Source: https://github.com/expensify/react-native-share-menu/blob/master/SHARE_EXTENSION_VIEW.md

Imports necessary React Native components into the Objective-C bridging header file for the Share Extension. These imports enable communication between native iOS code and the React Native bridge.

```objective-c
#import <React/RCTBridge.h>
#import <React/RCTBundleURLProvider.h>
#import <React/RCTBridgeDelegate.h>
#import <React/RCTRootView.h>
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.