OpenHarmony 4.0 的 Rust 開發(fā)
想了解更多關(guān)于開源的內(nèi)容，請(qǐng)?jiān)L問：
背景
Rust是一門靜態(tài)強(qiáng)類型語(yǔ)言，具有更安全的內(nèi)存管理、更好的運(yùn)行性能、原生支持多線程開發(fā)等優(yōu)勢(shì)。Rust官方也使用Cargo工具來專門為Rust代碼創(chuàng)建工程和構(gòu)建編譯。 OpenHarmony為了集成C/C++ 代碼和提升編譯速度，使用了GN + Ninja的編譯構(gòu)建系統(tǒng)。GN的構(gòu)建語(yǔ)言簡(jiǎn)潔易讀，Ninja的匯編級(jí)編譯規(guī)則直接高效。 為了在OpenHarmony中集成Rust代碼，并最大程度發(fā)揮Rust和OpenHarmony中原有C/C++ 代碼的交互性，采用GN作為統(tǒng)一構(gòu)建工具，即通過GN構(gòu)建Rust源碼文件(xxx.rs)，并增加與C/C++互操作、編譯時(shí)lint、測(cè)試、IDL轉(zhuǎn)換、三方庫(kù)集成、IDE等功能。同時(shí)擴(kuò)展gn框架，支持接口自動(dòng)化轉(zhuǎn)換，最大程度簡(jiǎn)化開發(fā)。
基本概念
術(shù)語(yǔ) | 描述 |
Cargo | Cargo是Rust官方使用的構(gòu)建工具,允許Rust項(xiàng)目聲明其各種依賴項(xiàng)，并確保您始終獲得可重復(fù)的構(gòu)建。 |
crate | crate是一個(gè)獨(dú)立的可編譯單元。 |
Lint | Lint是指出常見編程錯(cuò)誤、錯(cuò)誤、樣式錯(cuò)誤和可疑結(jié)構(gòu)的工具?？梢詫?duì)程序進(jìn)行更加廣泛的錯(cuò)誤分析。 |
配置規(guī)則
OpenHarmony提供了用于Rust代碼編譯構(gòu)建的各類型GN模板，可以用于編譯Rust可執(zhí)行文件，動(dòng)態(tài)庫(kù)和靜態(tài)庫(kù)等。各類型模板說明如下：
GN模板 | 功能 | 輸出 |
ohos_rust_executable | rust可執(zhí)行文件 | rust可執(zhí)行文件，不帶后綴 |
ohos_rust_shared_library | rust動(dòng)態(tài)庫(kù) | rust dylib動(dòng)態(tài)庫(kù)，默認(rèn)后綴.dylib.so |
ohos_rust_static_library | rust靜態(tài)庫(kù) | rust rlib靜態(tài)庫(kù)，默認(rèn)后綴.rlib |
ohos_rust_proc_macro | rust proc_macro | rust proc_macro庫(kù)， 默認(rèn)后綴.so |
ohos_rust_shared_ffi | rust FFI動(dòng)態(tài)庫(kù) | rust cdylib動(dòng)態(tài)庫(kù)，給C/C++模塊調(diào)用，默認(rèn)后綴.so |
ohos_rust_static_ffi | rust FFI靜態(tài)庫(kù) | rust staticlib庫(kù)，給C/C++模塊調(diào)用，默認(rèn)后綴.a |
ohos_rust_cargo_crate | 三方包Cargo crate | rust三方crate，支持rlib、dylib、bin |
ohos_rust_systemtest | rust系統(tǒng)測(cè)試用例 | rust可執(zhí)行系統(tǒng)測(cè)試用例，不帶后綴 |
ohos_rust_unittest | rust單元測(cè)試用例 | rust可執(zhí)行單元測(cè)試用例，不帶后綴 |
ohos_rust_fuzztest | rust Fuzz測(cè)試用例 | rust可執(zhí)行Fuzz測(cè)試用例，不帶后綴 |
配置Rust靜態(tài)庫(kù)示例
該示例用于測(cè)試Rust可執(zhí)行bin文件和靜態(tài)庫(kù)rlib文件的編譯，以及可執(zhí)行文件對(duì)靜態(tài)庫(kù)的依賴，使用模板ohos_rust_executable和ohos_rust_static_library。操作步驟如下：
- 創(chuàng)建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)
}創(chuàng)建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;
use simple_printer_rlib::RustLogMessage;
fn main() {
let msg: RustLogMessage = RustLogMessage {
id: 0,
msg: "string in rlib crate".to_string(),
};
rust_log_rlib(msg);
}配置gn腳本build/rust/tests/test_rlib_crate/BUILD.gn，如下所示：
import("http://build/ohos.gni")
ohos_rust_executable("test_rlib_crate") {
sources = [ "src/main.rs" ]
deps = [ ":simple_printer_rlib" ]
}
ohos_rust_static_library("simple_printer_rlib") {
sources = [ "src/simple_printer.rs" ]
crate_name = "simple_printer_rlib"
crate_type = "rlib"
features = [ "std" ]
}執(zhí)行編譯得到的可執(zhí)行文件，運(yùn)行結(jié)果如下：
./build.sh --product-name rk3568 --build-target build/rust/tests:tests --no-prebuilt-sdk
hdc_std.exe shell mount -o rw,remount /
hdc_std.exe shell file send test_dylib_crate /data/local/tmp
hdc_std.exe file send libsimple_printer_dylib.dylib.so /system/lib
hdc_std.exe shell
# cd /data/local/tmp
# chmod +x test_dylib_crate
# ./test_dylib_crate
id:0 message:"string in rlib crate"配置Rust應(yīng)用系統(tǒng)庫(kù)示例
增加依賴：
// GN 里增加依賴
ohos_rust_executable("test_dylib_crate") {
sources = [ "src/main.rs" ]
deps = [ ":simple_printer_dylib" ]
# 增加外部依賴
external_deps = [ "hilog:hilog_rust" ]
}
// bundle.json 里增加依賴
"components": [
"hilog"
],增加調(diào)用：
extern crate simple_printer_dylib;
use simple_printer_dylib::rust_log_dylib;
use simple_printer_dylib::RustLogMessage;
//! 增加引用
use std::ffi::{ c_char, CString };
use hilog_rust::{hilog, info, HiLogLabel, LogType};
const LOG_LABEL: HiLogLabel = HiLogLabel {
log_type: LogType::LogCore,
domain: 0xD002220,
tag: "TEST_RUST",
};
fn main() {
let msg: RustLogMessage = RustLogMessage {
id: 0,
msg: "string in rlib crate".to_string(),
};
rust_log_dylib(msg);
//! 增加調(diào)用
info!(LOG_LABEL, "Fnished enable all keys.");
}運(yùn)行測(cè)試：
// 運(yùn)行
# ./test_dylib_crate
id:0 message:"string in rlib crate"
// 查看hilog
# hilog | grep Fnished
08-17 05:14:18.121 29293 29293 I C02220/TEST_RUST: Fnished enable all keys.注意：rust和openharmony其他開源代碼可以混合使用，如rust可以生成C/C庫(kù)，給其他C/C應(yīng)用使用，反之C/C++庫(kù)也可以給rust應(yīng)用調(diào)用
總結(jié)
- OpenHarmony已經(jīng)全面支持的rust開發(fā)，一些工具部件如hilog也有對(duì)應(yīng)的rust版本。
- 社區(qū)文檔：https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build-rust-compilation.md。
- 社區(qū)樣例：https://gitee.com/openharmony/build rust目錄下有各種樣例。
