Search packages, repositories and app categories

Package detailsv1.1.1

native_toolchain_rust

Rust support for Dart's build hooks. Automatically builds and bundles your Rust code with your Dart code!

AndroidiOSLinuxmacOSWindows
30-day downloads
83.8K
Likes
29
Pub points
160

Install package

flutter pub add native_toolchain_rust

Package Overview

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

A Flutter/Dart package that enables seamless integration of Rust code into Dart projects. It automatically compiles and bundles Rust libraries alongside Dart code using build hooks, simplifying cross-language development. Ideal for performance-critical components like cryptography, data processing, or system-level operations. Supports all major platforms including Android, iOS, Linux, macOS, and Windows.

Use cases

  • Integrating high-performance Rust libraries into Flutter apps
  • Building cryptographic functions with Rust
  • Optimizing data-heavy computations
  • Creating platform-specific native extensions
  • Enabling safe low-level system access

Key features

  • Automatic Rust compilation via build hooks
  • Cross-platform support (Android, iOS, Linux, macOS, Windows)
  • Seamless Dart-Rust interoperability
  • Minimal boilerplate setup
  • Built-in dependency management

Suitable for

  • Developers needing high-performance native code in Flutter
  • Teams using Rust for core logic
  • Projects requiring secure, fast computation
  • Cross-platform native extensions
  • Dart developers exploring Rust integration

Considerations

  • Requires Rust toolchain installed on the host machine
  • May increase build times due to Rust compilation
  • Limited debugging support for Rust code
  • Platform-specific build configurations may be needed
  • Learning curve for Rust beginners

Original README

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

🧱 native_toolchain_rust 🦀

Build Status Github Stars MIT License


Rust support for Dart's build hooks.

Why native_toolchain_rust?

  1. It's opinionated. That might sound bad, but it's opinionated in the way that keeps you from shooting yourself in the foot.
  2. Does more with less. The API is incredibly easy to use: the only thing you need to provide is assetName, and the rest is auto-magically figured out. (But you can still tweak the functionality as much as you need to!)

Getting Started

  1. Install rustup, for Rust, on your development computer (if you are a library author, consumers of your package will have to do the same)
  2. Run flutter pub add native_toolchain_rust hooks for Flutter or dart pub add native_toolchain_rust hooks for Dart-only
  3. See Code Setup

Code Setup

native_toolchain_rust will look (by default) for native/ or rust/ (customizable) in your Dart package's root. If you haven't already, create a Cargo.toml and rust-toolchain.toml in your chosen Rust directory; keep reading for what these two files must contain (but don't worry if you forget, you'll get a helpful error message).

hook/build.dart
import 'package:hooks/hooks.dart';
import 'package:native_toolchain_rust/native_toolchain_rust.dart';

void main(List<String> args) async {
  await build(args, (input, output) async {
    await RustBuilder(
      assetName: 'src/my_ffi_bindings.g.dart',
      // ...maybe enable some Cargo features or something in here too
    ).run(input: input, output: output);
  });
}
Cargo.toml

Keep at least the following in your Cargo.toml.

[package]
name = "my-crate-name" # pick a name, doesn't matter

[lib]
crate-type = ["staticlib", "cdylib"] # THESE ARE IMPORTANT!
rust-toolchain.toml

Keep at least the following in your rust-toolchain.toml.

[toolchain]
# WARNING: *do not* use `stable`, `beta`, or `nightly` (alone) for the channel!
# You must specify a version number/date in order to ensure reproducible builds.
channel = "1.90.0" # or newer. another example: `nightly-2025-01-01`

# The targets you want to support; these are the default:
targets = [
  # Android
  "armv7-linux-androideabi",
  "aarch64-linux-android",
  "x86_64-linux-android",

  # iOS (device + simulator)
  "aarch64-apple-ios",
  "aarch64-apple-ios-sim",
  "x86_64-apple-ios",

  # Windows
  "aarch64-pc-windows-msvc",
  "x86_64-pc-windows-msvc",

  # Linux
  "aarch64-unknown-linux-gnu",
  "x86_64-unknown-linux-gnu",

  # macOS
  "aarch64-apple-darwin",
  "x86_64-apple-darwin",
]

Categories

Dependencies

Dependency list 6 items

Source repository

Projects using this package

No data available yet.

Rankings