背景

Rust是一門(mén)靜態(tài)強(qiáng)類(lèi)型語(yǔ)言，具有更安全的內(nèi)存管理、更好的運(yùn)行性能、原生支持多線程開(kāi)發(fā)等優(yōu)勢(shì)。Rust官方也使用Cargo工具來(lái)專(zhuān)門(mén)為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)建工具，即通過(guò)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)化開(kāi)發(fā)。

基本概念

配置規(guī)則

OpenHarmony提供了用于Rust代碼編譯構(gòu)建的各類(lèi)型GN模板，可以用于編譯Rust可執(zhí)行文件，動(dòng)態(tài)庫(kù)和靜態(tài)庫(kù)等。各類(lèi)型模板說(shuō)明如下：

配置Rust靜態(tài)庫(kù)示例

該示例用于測(cè)試Rust可執(zhí)行bin文件和靜態(tài)庫(kù)rlib文件的編譯，以及可執(zhí)行文件對(duì)靜態(tài)庫(kù)的依賴(lài)，使用模板ohos_rust_executable和ohos_rust_static_library。操作步驟如下：

1. 創(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)
   }
   

2. 創(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);
   }
   

3. 配置gn腳本build/rust/tests/test_rlib_crate/BUILD.gn，如下所示：

```json
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" ]
}

4. 執(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ù)示例

1. 增加依賴(lài)

// GN 里增加依賴(lài)
ohos_rust_executable("test_dylib_crate") {
  sources = [ "src/main.rs" ]
  deps = [ ":simple_printer_dylib" ]
  # 增加外部依賴(lài)
  external_deps = [ "hilog:hilog_rust" ]
}

// bundle.json 里增加依賴(lài)
"components": [
  "hilog"
],

2. 增加調(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.");
}

3. 運(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其他開(kāi)源代碼可以混合使用，如rust可以生成C/C庫(kù)，給其他C/C應(yīng)用使用，反之C/C++庫(kù)也可以給rust應(yīng)用調(diào)用
![](https://file1.elecfans.com//web2/M00/BF/BF/wKgaomW3baaAS-P1AABB9oinNkM39.webp)

審核編輯 黃宇