mojo-call-rust

mojo Call Rust:

原理:

• Mojo 通过 FFI 调用 Rust.
• 先使用 Rust cbindgen 把 rust 项目生成 c header.
• 然后 Mojo 使用 c abi 方式调用.

步骤:

1. 编写标准的 rust 项目, 为 raw.rs
2. 针对 raw.rs, 基于 cbindgen, 编写适配 C FFI 的 wrapper.rs,
   • 少数方法需要修改, 大部分只是简单包一层.
   • 分开 2 个文件, 是为了方便维护旧的 rust 项目, 做好隔离.
3. 先编译 rust 项目为 C ABI 二进制库(cargo.toml 设置 crate-type = ["cdylib"]).
4. 依次链接给 Mojo/C 调用, 二者具体使用方式略有不同.

Quickstart:

• 默认已经安装了 rust 和 mojo 开发环境.
• 包括:
  • rust: cargo/rustup
  • mojo: magic(类似 cargo+rustup)

Mojo call Rust:

• 编译+运行:Taskfile.yml

# 快速运行: 
cd repo-root-dir/
task ffi:mr:rm
  

• 说明: 代码内链接 rust 库, 路径是 rustlib/target/debug/librustlib.dylib.
  • 这是执行 cargo build --release 后生成的二进制文件.
  • 也可以根据需要指定 rustlib/target/release/librustlib.dylib

C call Rust:

• 详细编译指令: Taskfile.yml
• 注意编译+链接 rust 库的路径参数.

# 快速编译+运行:
cd repo-root-dir/
task ffi:mr:rc

#
# 详细编译参数, 注意如果编译时, 相对路径不同.
# 要针对性修改 main.c 内 include rustlib.h 路径
#
- mkdir -p build/
- gcc -c src/main.c -I include -o build/main.o
- gcc build/main.o -o build/main -L rustlib/target/debug -l rustlib   # 注意相对路径
- ./build/main

FFI FAQ:

ERROR: rust not FFI-safe

• rust not FFI-safe

Ref

Rust cbindgen:

• https://crates.io/crates/cbindgen

usage:

• https://github.com/getsentry/milksnake/blob/master/example/rust/build.rs#L11