Package detailsv1.5.6

zstandard_ios

iOS implementation of the Zstandard compression plugin for Flutter applications.

iOS

pub.dev API documentation Source code

30-day downloads: 46.7K
Likes: 1
Pub points: 160

Install package

flutter pub add zstandard_ios

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The zstandard_ios package provides an iOS-specific implementation of the Zstandard compression algorithm for Flutter applications. It enables efficient, high-performance data compression and decompression on iOS devices, leveraging the native Zstandard library for optimal speed and compression ratio. Designed for developers seeking advanced file compression capabilities in their iOS apps, it integrates seamlessly with Flutter's platform channel system. The package is particularly useful for reducing storage usage and improving data transfer efficiency in network-heavy or media-rich applications.

Use cases

Compressing app data files
Reducing network payload size
Optimizing local storage usage
Improving backup and sync performance
Handling large media assets

Key features

Native Zstandard integration
High compression ratio
Fast compression/decompression speeds
iOS-only platform support
Flutter-compatible plugin architecture

Suitable for

Developers targeting iOS with heavy data processing
Apps requiring efficient storage optimization
Network-intensive mobile applications
Media or file management apps

Considerations

Limited to iOS platforms
Requires native library setup
May increase app binary size
Not compatible with Android or web
Dependent on external Zstandard library version

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Zstandard

Zstandard (zstd) is a fast, high-compression algorithm developed by Meta (formerly Facebook) designed for real-time compression scenarios. It offers a flexible range of compression levels, allowing both high-speed and high-ratio compression, making it ideal for applications with diverse performance needs. Zstandard is widely used in data storage, transmission, and backup solutions.

This repository contains a federated Flutter plugin and a CLI package for zstandard compression, enabling both in-app and command-line usage. The two main components are:

zstandard: A Flutter plugin for cross-platform compression, supporting mobile, desktop, and web platforms. This package integrates the zstd library through FFI for native platforms and WebAssembly for the web, allowing efficient data compression in any Flutter environment.
zstandard_cli: A pure Dart package providing CLI capabilities for macOS, Windows, and Linux. It enables command-line compression and decompression for data files and streams.

Native platform packages and the CLI share the zstd C source and FFI bindings via the zstandard_native package (zstandard_native/src/zstd/). zstandard_native is published to pub.dev as part of this repo’s release set, so a single copy is used whether you depend on the plugin from the repo or from pub.dev.

Compatibility

	Android	iOS	Web	macOS	Windows	Linux	Fuchsia
Flutter	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark: (wasm)	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	❌
Native	FFI	FFI	WebAssembly	FFI	FFI	FFI	❌
Precompiled	No	No	Yes	No	No	No	❌

	macOS	Windows	Linux
x64	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:
arm64	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:
Precompiled	Yes	Yes	Yes

Documentation

Full documentation is in the docs/ directory, including:

Basic Usage

In-App (Flutter)

import 'package:zstandard/zstandard.dart';

void main() async {
  final zstandard = Zstandard();

  Uint8List originalData = Uint8List.fromList([...]);

  Uint8List? compressed = await zstandard.compress(originalData, 3);
  
  final decompressed = compressed == null
      ? null
      : await zstandard.decompress(compressed, maxOutputSize: 64 * 1024 * 1024);
}

Using extensions:

import 'package:zstandard/zstandard.dart';

void main() async {
  Uint8List originalData = Uint8List.fromList([...]);

  Uint8List? compressed = await originalData.compress();
  
  final decompressed = await compressed.decompress(
    maxOutputSize: 64 * 1024 * 1024,
  );
}

Command Line (zstandard_cli)

# Compress a file with a specified compression level
dart run zstandard_cli:compress --level 3 myfile.txt

# Decompress a file
dart run zstandard_cli:decompress myfile.txt.zstd

Dart Code Example (CLI)

import 'package:zstandard_cli/zstandard_cli.dart';

void main() async {
  var cli = ZstandardCLI();

  final originalData = Uint8List.fromList([...]);

  final compressed = await cli.compress(originalData, compressionLevel: 3);

  final decompressed = await cli.decompress(compressed ?? Uint8List(0));
}

Using extensions in Dart:

import 'package:zstandard_cli/zstandard_cli.dart';

void main() async {
  final originalData = Uint8List.fromList([...]);

  final compressed = await originalData.compress(compressionLevel: 3);

  final decompressed = await compressed.decompress();
}