背景
Rust 是一门静态强类型语言,具有更安全的内存管理、更好的运行性能、原生支持多线程开发等优势。Rust 官方也使用 Cargo 工具来专门为 Rust 代码创建工程和构建编译。 OpenHarmony 为了集成 C/C++ 代码和提升编译速度,使用了 GN + Ninja 的编译构建系统。GN 的构建语言简洁易读,Ninja 的汇编级编译规则直接高效。 为了在 OpenHarmony 中集成 Rust 代码,并最大程度发挥 Rust 和 OpenHarmony 中原有 C/C++ 代码的交互性,采用 GN 作为统一构建工具,即通过 GN 构建 Rust 源码文件(xxx.rs),并增加与 C/C++ 互操作、编译时 lint、测试、IDL 转换、三方库集成、IDE 等功能。同时扩展 gn 框架,支持接口自动化转换,最大程度简化开发。
基本概念
配置规则
OpenHarmony 提供了用于 Rust 代码编译构建的各类型 GN 模板,可以用于编译 Rust 可执行文件,动态库和静态库等。各类型模板说明如下:
配置 Rust 静态库示例
该示例用于测试 Rust 可执行 bin 文件和静态库 rlib 文件的编译,以及可执行文件对静态库的依赖,使用模板 ohos_rust_executable 和 ohos_rust_static_library。操作步骤如下:
1.创建 build/rust/tests/test_rlib_crate/src/simple_printer.rs,如下所示:
//! simple_printer
/// struct RustLogMessage
pub struct RustLogMessage {
/// i32: id
pub id: i32,
/// String: msg
pub msg: String,
}
/// function rust_log_rlib
pub fn rust_log_rlib(msg: RustLogMessage) {
println!("id:{} message:{:?}", msg.id, msg.msg)
}
2.创建 build/rust/tests/test_rlib_crate/src/main.rs,如下所示:
//! rlib_crate example for Rust.
extern crate simple_printer_rlib;
use simple_printer_rlib::rust_log_rlib;