17
Watch
2k
Star
113
Fork
335
Issue

High-level memory-safe binding generator for Flutter/Dart <-> Rust

fzyzcjy
fzyzcjy
pushedAt 40 seconds ago

fzyzcjy/flutter_rust_bridge

flutter_rust_bridge: High-level memory-safe binding generator for Flutter/Dart <-> Rust

Rust Package Flutter Package Stars CI Example Codacy Badge

Logo

Want to combine the best between Flutter, a cross-platform hot-reload rapid-development UI toolkit, and Rust, a language empowering everyone to build reliable and efficient software? Here it comes!

🚀 Advantages

  • Memory-safe: Never need to think about malloc/free.
  • Feature-rich: enums with values, platform-optimized Vec, possibly recursive struct, zero-copy big arrays, opaque types on arbitrary structs/classes, Stream (iterator) abstraction, error (Result) handling, cancellable tasks, concurrency control, and more. See full features here.
  • Async programming: Rust code will never block the Flutter. Call Rust naturally from Flutter's main isolate (thread).
  • Lightweight: This is not a huge framework that includes everything, so you are free to use your favorite Flutter and Rust libraries. For example, state-management with Flutter library (e.g. MobX) can be elegant and simple (contrary to implementing in Rust); implementing a photo manipulation algorithm in Rust will be fast and safe (countrary to implementing in Flutter).
  • Cross-platform: Android, iOS, Windows, Linux, MacOS, and Web.
  • Easy to code-review & convince yourself: This package simply simulates how humans write boilerplate code. If you want to convince yourself (or your team) that it is safe, there is not much code to look at. No magic at all! (More about safety concerns.)
  • Fast: It is only a thin (though feature-rich) wrapper, without overhead such as protobuf serialization, thus performant. (More benchmarks later) (Throw away components like thread-pool to make it even faster)
  • Pure-Dart compatible: Despite the name, this package is 100% compatible with pure Dart.

💡 User Guide

Check out the user guide for show-me-the-code, tutorials, features and much more.

📎 P.S. Achieve ~60 FPS, no matter how janky the Flutter app was due to build/layout

Here is my another open-source library :) https://github.com/fzyzcjy/flutter_smooth.

Contributors

All Contributors

Thanks goes to these wonderful people (emoji key following all-contributors specification):

fzyzcjy
fzyzcjy

💻 📖 💡 🤔 🚧
Viet Dinh
Viet Dinh

💻 ⚠️ 📖
Joshua Wade
Joshua Wade

💻
Marcel
Marcel

💻
rustui
rustui

📖
Michael Bryan
Michael Bryan

💻
bus710
bus710

📖
Sebastian Urban
Sebastian Urban

💻
Daniel
Daniel

💻
Kevin Li
Kevin Li

💻 📖
Patrick Auernig
Patrick Auernig

💻
Anton Lazarev
Anton Lazarev

💻
Unoqwy
Unoqwy

💻
Febrian Setianto
Febrian Setianto

📖
syndim
syndim

💻
sagu
sagu

💻 📖
Ikko Ashimine
Ikko Ashimine

📖
alanlzhang
alanlzhang

💻 📖
Sai Chaitanya
Sai Chaitanya

💻
Ares Andrew
Ares Andrew

📖
raphaelrobert
raphaelrobert

📖
thomas725
thomas725

📖
Daniel Porteous (dport)
Daniel Porteous (dport)

📖
Wouter Ensink
Wouter Ensink

📖
老董
老董

💻 📖
Lattice 0
Lattice 0

💻 📖
orange soeur
orange soeur

📖
Rom's
Rom's

💻 📖
Cupnfish
Cupnfish

💻
SoLongAndThanksForAllThePizza
SoLongAndThanksForAllThePizza

💻 📖
Sam Nystrom
Sam Nystrom

📖
hsfzxjy
hsfzxjy

💻
muji
muji

📖
Zaitam
Zaitam

💻
Alex Procelewski
Alex Procelewski

📖
Vincent Herlemont
Vincent Herlemont

💻
CicadaCinema
CicadaCinema

💻
rogurotus
rogurotus

💻 📖
huang12zheng
huang12zheng

💻 📖

More specifically, thanks for all these contributions:

  • Desdaemon: Support not only simple enums but also enums with fields which gets translated to native enum or freezed class in Dart. Support the Option type as nullable types in Dart. Support Vec of Strings type. Support comments in code. Add marker attributes for future usage. Add Linux and Windows support for with-flutter example, and make CI works for that. Avoid parameter collision. Overhaul the documentation and add several chapters to demonstrate configuring a Flutter+Rust project in all five platforms. Refactor command module. Precompiled binary CI workflow. Fix bugs. Add support for the Web platform, parallel to the existing mobile/desktop platforms, via WASM and JavaScript as intermediate values. GitHub retry actions. Implement draft of opaque types.
  • SecondFlight: Allow structs and enums to be imported from other files within the crate by creating source graph. Auto-create relavent dir. Fix store_dart_post_cobject error with ffigen 6.0.
  • Unoqwy: Add struct mirrors, such that types in the external crates can be imported and used without redefining and copying.
  • rogurotus: Add opaque types, enabling arbitrary Rust structs to be used as opaque Dart objects, by generating wrappers and raw Arc pointers.
  • antonok-edm: Avoid converting syn types to strings before parsing to improve code and be more robust.
  • lattice0: Support methods, such that Rust struct impls can be converted to Dart class methods. StreamSink at any argument.
  • sagudev: Make code generator a lib. Add error types. Depend on cbindgen. Fix LLVM paths. Update deps. Fix CI errors.
  • surban: Support unit return type. Skip unresolvable modules. Ignore prefer_const_constructors. Non-final Dart fields.
  • Roms1383: Fix build_runner calling bug. Remove global ffigen dependency. Improve version check. Fix enum name-variant conflicts. Support Chrono date time and UUID types. Migrate to Rust 1.64 workspace. Update and refactor CI. Update header comments. Code cleanup.
  • trobanga: Add support for [T;N] structs. Add usize support. Add a cmd argument. Separate dart tests.
  • dbsxdbsx: Allow generating multiple Rust and Dart files.
  • SoLongAndThanksForAllThePizza: Refactor and enhance SyncReturn to support more types.
  • hsfzxjy: Fix SyncReturn use-after-free bug.
  • Cupnfish: Support arrays as function paramters. Allow multi mirror.
  • alanlzhang: Add generation for Dart metadata. Enhance module parser.
  • Zaitam: Fix when method return struct.
  • AlienKevin: Add flutter example for macOS. Add doc for Android NDK bug.
  • huang12zheng: Tweak code generation.
  • banool: Fix pubspec parsing. Fix symbol-stripping doc.
  • efc-mw: Improve Windows encoding handling.
  • valeth: Rename callFfi's port.
  • sccheruku: Prevent double-generating utility.
  • w-ensink: Improve doc. Fix CI. Refactor. Add tests.
  • Michael-F-Bryan: Detect broken bindings.
  • bus710: Add a case in troubleshooting.
  • Syndim: Add a bracket to box.
  • TENX-S: Improve doc. Reproduce a bug.
  • vincent-herlemont: Loosen version.
  • CicadaCinema: Bump version.
  • raphaelrobert: Remove oudated doc.
  • alexthe2: Improve doc.
  • tmpfs: Improve doc.
  • thomas725: Improve doc.
  • juzi5201314: Improve doc.
  • Stonks3141: Fix doc credit.
  • feber: Fix doc link.
  • rustui: Fix a typo.
  • eltociear: Fix a typo.