Neapolitan Pizza Margherita

    expo-image-picker
    TypeScript icon, indicating that this package has built-in type declarations

    14.0.2 • Public • Published

    expo-image-picker

    Provides access to the system's UI for selecting images and videos from the phone's library or taking a photo with the camera.

    API documentation

    Installation in managed Expo projects

    For managed Expo projects, please follow the installation instructions in the API documentation for the latest stable release.

    Installation in bare React Native projects

    For bare React Native projects, you must ensure that you have installed and configured the expo package before continuing.

    Add the package to your npm dependencies

    expo install expo-image-picker
    

    Configure for iOS

    This is only required for usage in bare React Native apps.

    Add NSPhotoLibraryUsageDescription, NSCameraUsageDescription, and NSMicrophoneUsageDescription keys to your Info.plist:

    <key>NSPhotoLibraryUsageDescription</key>
    <string>Give $(PRODUCT_NAME) permission to save photos</string>
    <key>NSCameraUsageDescription</key>
    <string>Give $(PRODUCT_NAME) permission to access your camera</string>
    <key>NSMicrophoneUsageDescription</key>
    <string>Give $(PRODUCT_NAME) permission to use your microphone</string>

    Run npx pod-install after installing the npm package.

    Configure for Android

    This is only required for usage in bare React Native apps.

    This package automatically adds the CAMERA, READ_EXTERNAL_STORAGE, and WRITE_EXTERNAL_STORAGE permissions. They are used when picking images from the camera directly, or from the camera roll.

    <!-- Added permissions -->
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

    Config Plugin

    This plugin is applied automatically in EAS Build, only add the config plugin if you want to pass in extra properties.

    After installing this npm package, add the config plugin to the plugins array of your app.json or app.config.js:

    {
      "expo": {
        "plugins": ["expo-image-picker"]
      }
    }

    Next, rebuild your app as described in the "Adding custom native code" guide.

    API

    The plugin provides props for extra customization. Every time you change the props or plugins, you'll need to rebuild (and prebuild) the native app. If no extra properties are added, defaults will be used.

    • photosPermission (string | false): Sets the iOS NSPhotoLibraryUsageDescription permission message to the Info.plist. Setting false will skip adding the permission on iOS and does not skip the permission on Android. Defaults to Allow $(PRODUCT_NAME) to access your photos.
    • cameraPermission (string | false): Sets the iOS NSCameraUsageDescription permission message to the Info.plist. Setting false will skip adding the permission on iOS and does not skip the permission on Android. Defaults to Allow $(PRODUCT_NAME) to access your camera.
    • microphonePermission (string | false): Sets the iOS NSCameraUsageDescription permission message to the Info.plist. Setting false will skip adding the permission on iOS and skips adding the android.permission.RECORD_AUDIO Android permission. Defaults to Allow $(PRODUCT_NAME) to access your photos.

    Example

    {
      "expo": {
        "plugins": [
          [
            "expo-image-picker",
            {
              "photosPermission": "custom photos permission",
              "cameraPermission": "Allow $(PRODUCT_NAME) to open the camera",
    
              "//": "Disables the microphone permission",
              "microphonePermission": false
            }
          ]
        ]
      }
    }

    Contributing

    Contributions are very welcome! Please refer to guidelines described in the contributing guide.

    Install

    npm i expo-image-picker

    DownloadsWeekly Downloads

    84,252

    Version

    14.0.2

    License

    MIT

    Unpacked Size

    262 kB

    Total Files

    60

    Last publish

    Collaborators

    • szdziedzic
    • tsapeta
    • dsokal
    • wkozyra
    • ide
    • lukmccall
    • keith-kurak
    • christopherwalter
    • kbrandwijk
    • fiber-god
    • brentvatne
    • evanbacon
    • quinlanj
    • expoadmin
    • tcdavis
    • exponent
    • wschurman
    • bycedric
    • jonsamp
    • princefleaswallow
    • kudochien