Flutter/Dart 패키지로, Dart 프로젝트에 Rust 코드를 원활하게 통합할 수 있게 해줍니다. 빌드 훅을 사용하여 Rust 라이브러리를 자동으로 컴파일하고 Dart 코드와 함께 번들링함으로써 다중 언어 개발을 간소화합니다. 암호화, 데이터 처리 또는 시스템 수준 작업과 같은 성능이 중요한 구성 요소에 적합합니다. Android, iOS, Linux, macOS, Windows 등 모든 주요 플랫폼을 지원합니다.
It's opinionated.
That might sound bad, but it's opinionated in the way that keeps you from shooting yourself in the foot.
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
Install rustup, for Rust, on your development computer
(if you are a library author, consumers of your package will have to do the same)
Run flutter pub add native_toolchain_rust hooks for Flutter or dart pub add native_toolchain_rust hooks for Dart-only
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';
voidmain(List<String> args) async {
awaitbuild(args, (input, output) async {
awaitRustBuilder(
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",
]