Skip to content

Trunkrs/react-native-image-compressor

Repository files navigation

react-native-image-compressor

A simple image resizing and compression package, taking care of the resizing process on the native side. Supports iOS and Android out of the box.

Getting started

$ npm install @trunkrs/react-native-image-compressor --save

$ yarn add @trunkrs/react-native-image-compressor

Mostly automatic installation

$ react-native link @trunkrs/react-native-image-compressor

Manual installation

iOS

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-image-compressor and add TRNReactNativeImageCompressor.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libTRNReactNativeImageCompressor.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<

Android

  1. Open up android/app/src/main/java/[...]/MainApplication.java
  • Add import com.trunkrs.imagecompressor.TRNReactNativeImageCompressorPackage; to the imports at the top of the file
  • Add new TRNReactNativeImageCompressorPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':@trunkrs_react-native-image-compressor'
    project(':@trunkrs_react-native-image-compressor').projectDir = new File(rootProject.projectDir, 	'../node_modules/@trunkrs/react-native-image-compressor/android')
    
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
      implementation project(':@trunkrs_react-native-image-compressor')
    

Usage

import ImageCompressor from '@trunkrs/react-native-image-compressor'

const result = await ImageCompressor.compress('file://bowling-alleys/the-dude.jpg', {
    maxWidth: 1000,
})

API

ImageCompressor

  • compress(value: string, options?: CompressorOptions): Promise<string>

    Compresses the input file URI or base-64 string with the specified options. Promise returns a string after compression has completed. Resizing will always keep the original aspect ratio of the image, the maxWidth and maxHeight are used as a boundary.

CompressorOptions

  • maxWidth: number (default: 1024)

    The maximum width boundary used as the main boundary in resizing a landscape image.

  • maxHeight: number (default: 1024)

    The maximum height boundary used as the main boundary in resizing a portrait image.

  • quality: number (default: 1.0)

    The quality modifier for the JPEG file format, can be specified when output is PNG but will be ignored.

  • input: InputType (default: base64)

    Can be either uri or base64, defines the contentents of the value parameter.

  • output: OutputType (default: jpg)

    Can be either jpg or png, defines the output image format.