capa-zip v7.0.3

capa-zip

A simple Zip/Unzip plugin for Capacitor v7, supporting iOS and Android platforms.

Overview

This plugin provides zip and unzip functionality for Capacitor applications:

• iOS Implementation: Uses SSZipArchive library for efficient compression/decompression
• Android Implementation: Leverages Java's built-in ZipInputStream/ZipOutputStream
• Platform Support: iOS and Android (Web platform not supported)

Install

npm install capa-zip
npx cap sync

API

• addListener('zipProgress', ...)
• unzip(...)
• zip(...)
• removeAllListeners()
• Interfaces

Zip file manipulation plugin for Capacitor

Events

The plugin emits progress events during zip/unzip operations:

Zip.addListener('zipProgress', (progress: ZipPluginProgress) => {
  const percentage = (progress.loaded / progress.total) * 100;
  console.log(`Progress: ${percentage.toFixed(2)}%`);
});

Examples

Unzip a file with progress monitoring

// Add progress listener
Zip.addListener('zipProgress', (progress: ZipPluginProgress) => {
  const percentage = (progress.loaded / progress.total) * 100;
  updateProgressUI(percentage);
});

// Perform unzip
try {
  await Zip.unzip({
    sourceFile: 'path/to/archive.zip',
    destinationPath: 'path/to/destination'
  });
  console.log('Unzip completed successfully');
} catch (error) {
  console.error('Unzip failed:', error);
}

Zip a directory

try {
  await Zip.zip({
    sourcePath: 'path/to/directory',
    destinationPath: 'path/to/archive.zip'
  });
  console.log('Zip completed successfully');
} catch (error) {
  console.error('Zip failed:', error);
}

Zip specific files from a directory

try {
  await Zip.zip({
    sourcePath: 'path/to/directory',
    destinationPath: 'path/to/archive.zip',
    files: ['file1.txt', 'subdirectory/file2.jpg']
  });
  console.log('Zip completed successfully');
} catch (error) {
  console.error('Zip failed:', error);
}

addListener('zipProgress', ...)

addListener(eventName: 'zipProgress', listenerFunc: (progress: ZipPluginProgress) => void) => Promise<PluginListenerHandle>

Adds a listener for zip progress events.

Returns: Promise<PluginListenerHandle>

unzip(...)

unzip(options: { sourceFile: string; destinationPath: string; }) => Promise<void>

Unzips a file to a specified destination directory.

Since: 1.0.0

zip(...)

zip(options: { sourcePath: string; destinationPath: string; files?: string[]; }) => Promise<void>

Creates a zip file from a directory or list of files.

Since: 1.1.0

removeAllListeners()

removeAllListeners() => Promise<void>

Removes all registered event listeners.

Since: 7.0.0

Interfaces

PluginListenerHandle

ZipPluginProgress

Progress event data for zip operations