Package detailsv1.5.6

zstandard_android

Android implementation of the Zstandard compression plugin for Flutter applications.

Android

pub.dev API documentation Source code

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

Install package

flutter pub add zstandard_android

Package Overview

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

The zstandard_android package provides an Android-specific implementation of the Zstandard compression algorithm for Flutter applications. It enables efficient data compression and decompression directly on Android devices, leveraging the high-performance Zstandard library. This plugin is ideal for reducing storage usage and improving transfer speeds for large datasets or files within mobile apps. Designed for seamless integration, it works with Flutter's platform channels to expose native compression functionality. The package is maintained by vyp.dev and hosted on GitHub for transparency and community contributions.

Use cases

Compressing app data before storage
Reducing network payload size
Optimizing file transfers
Improving app performance with smaller assets
Handling large datasets efficiently

Key features

High-speed compression and decompression
Native Android performance
Seamless Flutter integration
Open-source and transparent
Lightweight and efficient

Suitable for

Apps requiring fast data compression
Mobile apps handling large files
Network-intensive applications
Developers seeking high-performance compression
Android-focused Flutter projects

Considerations

Limited to Android platform
Requires native setup for full functionality
May increase app size slightly
Dependent on external native library
Not compatible with iOS or other platforms

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();
}