Rust_on_OpenHarmony_开发指导.md · Xingwa/devnotes

# Rust on OpenHarmony 开发指导

## 基本信息

### 工具链支持情况

当前 Rust 主线版本已经[支持OpenHarmony](https://doc.rust-lang.org/rustc/platform-support/openharmony.html)。

当前是 Rust 对于 OpenHarmony 是 tire3 支持，无法使用rustup 下载到 openharmony 对应的 std 二进制，需要在编译应用Rust模块时使用 nightly build-std 特性在构建过程中同时编译出 OpenHarmony 的 std。

默认 OpenHarmony 的 std 会和应用Rust模块静态链接，我们也推荐这种做法。

### 应用使用Rust开发

OpenHarmony 对应用只开放了ArkTS API 和 C API(NDK)， 没有 Rust API

应用使用 Rust 开发的程序， 通常是编译成一个 C动态链接库， 即 Rust 中的cdylib， Rust 语言实现，导出 C 函数接口。在系统看来这个Rust语言编写的 动态库和 C/C++ 实现的动态库没有任何区别

应用使用 Rust 语言的依赖限制和使用 C/C++ 语言开发也很类似，即最终只可以依赖包括 libc 在在内的 NDK 库的范围。 例如 Rust 程序可以直接通过 nix crate 和 libc crate 访问 C库中的posix接口， 但是不能通过 openssl-sys crates 访问到系统中的 openssl, 和C/C++代码一样， 需要自行交叉编译 openssl 和应用一起部署。

以下是使用官方的Rust工具链编译一个可以在OpenHarmony运行程序的简单指导， 以 linux 系统为例

Mac和windows系统需要注意 NDK 的对应目录， nightliy 工具链对应名词，以及 wrapper的语法(windows下，通常是一个cmd程序)

## 安装nightly toolchain 和 std 源码

``` 
rustup toolchain install nightly
rustup component add rust-src --toolchain nightly-x86_64-unknown-linux-gnu
```

## 下载和配置 ohos-ndk

1. 从 http://ci.openharmony.cn/workbench/cicd/dailybuild 下载 sdk-full
2. 解压以后，再解压其中的NDK压缩包

```bash
cd /path/to/oh-sdk/linux
unzip native-linux-*
```

## 新建 clang wrapper 文件

参考Rust官方文档：<https://doc.rust-lang.org/rustc/platform-support/openharmony.html>

创建 aarch64-unknown-linux-ohos-clang.sh 文件
编辑文件内容为

```bash
#!/bin/sh
exec /path/to/ohos-sdk/linux/native/llvm/bin/clang \
  -target aarch64-linux-ohos \
  --sysroot=/path/to/ohos-sdk/linux/native/sysroot \
  -D__MUSL__ \
  "$@"
```

## 配置 cargo

参考Rust 官方文档：<https://doc.rust-lang.org/rustc/platform-support/openharmony.html>

编辑 ~/.cargo/config

``` 
[target.aarch64-unknown-linux-ohos]
ar = "/path/to/ohos-sdk/linux/native/llvm/bin/llvm-ar"
linker = "/path/to/aarch64-unknown-linux-ohos-clang.sh"
```

## 测试

### 新建项目 
```bash
cargo init --lib mylib
```

### 修改cargo.toml 指定目标类型为C动态库

```
[lib]
crate-type=["cdylib"]
```

### 编译

```
cargo +nightly build -Z build-std --target aarch64-unknown-linux-ohos
```

至此我们使用Rust语言开发了一个可以跑在OpenHarmony上的动态库，现在可以在App 的Cmake文件中引用这个生成的so文件

Xingwa/devnotes

简介

发行版

贡献者

语言

近期动态

Xingwa/devnotes .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

语言

近期动态

搜索帮助

Xingwa/devnotes