React Native Zip Archive

Zip archive utility for react-native


npm install react-native-zip-archive --save



react-native link react-native-zip-archive



refer to the official guide


  • Edit android/settings.gradle to look like this (without the +): = 'MyApp'
    include ':app'
    + include ':react-native-zip-archive'
    + project(':react-native-zip-archive').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-zip-archive/android')
  • Edit android/app/build.gradle (note: app folder) to look like this:

    apply plugin: ''
    android {
    dependencies {
      compile fileTree(dir: 'libs', include: ['*.jar'])
      compile ''
      compile 'com.facebook.react:react-native:0.16.+'
    + compile project(':react-native-zip-archive')
  • Edit your (deep in android/app/src/main/java/...) to look like this (note two places to edit):

    package com.myapp;
    + import com.rnziparchive.RNZipArchivePackage;
      protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
    +     new RNZipArchivePackage()


import it into your code

import { zip, unzip, unzipAssets, subscribe } from 'react-native-zip-archive'

you may also want to use something like react-native-fs to access the file system (check its repo for more information)

import { MainBundlePath, DocumentDirectoryPath } from 'react-native-fs'


zip(source: string, target: string): Promise

zip source to target


const targetPath = `${DocumentDirectoryPath}/`
const sourcePath = DocumentDirectoryPath

zip(sourcePath, targetPath)
.then((path) => {
  console.log(`zip completed at ${path}`)
.catch((error) => {

unzip(source: string, target: string): Promise

unzip from source to target


const sourcePath = `${DocumentDirectoryPath}/`
const targetPath = DocumentDirectoryPath

unzip(sourcePath, targetPath)
.then((path) => {
  console.log(`unzip completed at ${path}`)
.catch((error) => {

unzipAssets(assetPath: string, target: string): Promise

unzip file from Android assets folder to target path

Note: Android only.

assetPath is the relative path to the file inside the pre-bundled assets folder, e.g. folder/ Do not pass an absolute directory.

const assetPath = `${DocumentDirectoryPath}/`
const targetPath = DocumentDirectoryPath

unzipAssets(assetPath, targetPath)
.then(() => {
  console.log('unzip completed!')
.catch((error) => {

subscribe(callback: ({ progress: number, filePath: string })): EmitterSubscription

Subscribe to the progress callbacks. Useful for displaying a progress bar on your UI during the process.

Your callback will be passed an object with the following fields:

  • progress (number) a value from 0 to 1 representing the progress of the unzip method. 1 is completed.
  • filePath (string) the zip file path of zipped or unzipped file.

Note: Remember to check the filename while processing progress, to be sure that the unzipped or zipped file is the right one, because the event is global.

Note: Remember to unsubscribe! Run .remove() on the object returned by this method.

componentDidMount() {
  this.zipProgress = subscribe(({ progress, filePath }) => {
    this.setState({ zipProgress: e.progress })

componentWillUnmount() {
  // Important: Unsubscribe from the progress events