iOS/Android image picker with support for camera, video, configurable compression, multiple images and cropping
Go to file
Ivan Pusic fdb2c15548 update ios instructions 2016-08-06 04:23:44 +02:00
android improvements for includeBase64 flag feature 2016-08-05 20:41:03 +02:00
example dynamic base64 mime type when returning image 2016-08-05 20:43:33 +02:00
images first commit 2016-05-18 12:07:36 +02:00
ios improvements for includeBase64 flag feature 2016-08-05 20:41:03 +02:00
.gitignore [ANDROID] show only local files 2016-07-24 01:17:43 +02:00
.npmignore [Android] Before publishing remove android/build 2016-07-30 20:10:33 +02:00
README.md update ios instructions 2016-08-06 04:23:44 +02:00
index.js first commit 2016-05-18 12:07:36 +02:00
package.json release 0.5.5 2016-08-05 20:58:20 +02:00

README.md

react-native-image-crop-picker

iOS/Android image picker with support for multiple images and cropping

Result

iOS

Android

Usage

Import library

import ImagePicker from 'react-native-image-crop-picker';

Call single image picker with cropping

ImagePicker.openPicker({
  width: 300,
  height: 400,
  cropping: true
}).then(image => {
  console.log(image);
});

Call multiple image picker

ImagePicker.openPicker({
  multiple: true
}).then(images => {
  console.log(images);
});

Request Object

Property Type Description
cropping bool (default false) Enable or disable cropping
width number Width of result image when used with cropping option
height number Height of result image when used with cropping option
multiple bool (default false) Enable or disable multiple image selection
includeBase64 bool (default false) Enable or disable returning base64 data with image
maxFiles (ios only) number (default 5) Max number of files to select when using multiple option

Response Object

Property Type Description
path string Selected image location
width number Selected image width
height number Selected image height
mime string Selected image MIME type (image/jpeg, image/png)
size number Selected image size in bytes

Install

npm install react-native-image-crop-picker --save

iOS

pod 'react-native-image-crop-picker', :path => '../node_modules/react-native-image-crop-picker/ios'

- Step By Step tutorial

Android

// file: android/settings.gradle
...

include ':react-native-image-crop-picker'
project(':react-native-image-crop-picker').projectDir = new File(settingsDir, '../node_modules/react-native-image-crop-picker/android')
// file: android/app/build.gradle
...

dependencies {
    ...
    compile project(':react-native-image-crop-picker')
}
// file: MainApplication.java
...

import com.reactnative.picker.PickerPackage; // import package

public class MainApplication extends ReactApplication {
...
   /**
   * A list of packages used by the app. If the app uses additional views
   * or modules besides the default ones, add more packages here.
   */
    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            new PickerPackage() // Add package
        );
    }
...
}

How it works?

It is basically wrapper around few libraries

Android

  • Native Image Picker
  • uCrop

iOS

  • QBImagePickerController
  • RSKImageCropper

iOS Step by Step installation

  • Create new react native project with Pods support
react-native init picker
cd picker
npm i react-native-image-crop-picker --save
cd ios
pod init
  • Inside ios directory change Podfile to following
platform :ios, '8.0'

target 'picker' do
    source 'https://github.com/CocoaPods/Specs.git'
    pod 'React', :path => '../node_modules/react-native'
    pod 'react-native-image-crop-picker', :path => '../node_modules/react-native-image-crop-picker/ios'
end
  • Run
pod install
  • open project_name.xcworkspace
  • Add $(inherited) to other linker flags under Build Settings

Done!

License

MIT