RUST跨平台编译鸿蒙Native库

最新推荐文章于 2025-11-15 11:41:16 发布
原创 最新推荐文章于 2025-11-15 11:41:16 发布 · 1k 阅读 · 21 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#rust #鸿蒙

RUST跨平台编译鸿蒙Native库

1. 前言

Rust是一种系统级编程语言，由Mozilla开发，专注于安全性、并发性和性能。它通过所有权系统、借用检查器和生命周期管理等机制，在编译时防止数据竞争和内存安全问题，同时无需垃圾回收机制。Rust还支持零成本抽象和与C/C++的高效交互（通过FFI），适合开发高性能分布式系统、游戏引擎等场景。实际应用中，Rust相比Python等语言能显著降低资源消耗。

鸿蒙OS（HarmonyOS）是华为开发的分布式操作系统，主要面向全场景智能设备（如手机、物联网、车载系统等）。其核心特点是分布式架构，支持跨设备协同、低延迟和高安全性。从技术实现来看，鸿蒙提供原生开发工具链（如DevEco Studio）和跨平台编译支持（如针对aarch64/armv7/x86_64等多架构的交叉编译能力）。

实际项目中，由RUST开发的基础库可便捷地应用到各大主流操作系统，在最新的Rust版本中已经支持跨平台编译鸿蒙OS的Native库，本文介绍如何编译。

2. 环境准备

2.1 下载配置ohos-ndk

2.1.1 下载

您可以从OpenHarmony社区获取最新的release版本(当前为5.1.0-Release)的Public SDK包

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

# 下载SDK包
wget https://repo.huaweicloud.com/openharmony/os/5.1.0-Release/ohos-sdk-windows_linux-public.tar.gz
# 解压SDK包
tar -xvzf ohos-sdk-windows_linux-public.tar.gz
# 解压ndk压缩包
cd /path/to/ohos-sdk/linux
unzip native-linux-*
2.1.2 配置

主要是配置各种版本的编译脚本，不必全部配置，选择你需要的平台即可。依次创建以下脚本：

aarch64-unknown-linux-ohos-clang.sh

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

#!/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__ \
  "$@"

armv7-unknown-linux-ohos-clang.sh

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

#!/bin/sh
exec /path/to/ohos-sdk/linux/native/llvm/bin/clang \
  -target arm-linux-ohos \
  --sysroot=/path/to/ohos-sdk/linux/native/sysroot \
  -D__MUSL__ \
  -march=armv7-a \
  -mfloat-abi=softfp \
  -mtune=generic-armv7-a \
  -mthumb \
  "$@"

x86_64-unknown-linux-ohos-clang.sh

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

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

记得要赋予执行权限

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

chmod +x aarch64-unknown-linux-ohos-clang.sh
chmod +x armv7-unknown-linux-ohos-clang.sh
chmod +x x86_64-unknown-linux-ohos-clang.sh

2.2 配置rust

2.2.1 添加目标平台的工具链

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

rustup target add aarch64-unknown-linux-ohos
rustup target add armv7-unknown-linux-ohos
rustup target add x86_64-unknown-linux-ohos
2.2.2 配置目标平台的ar和linker

修改~/.cargo/config.toml文件，添加以下内容

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

[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"

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

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

ar用于编译静态库，linker用于编译动态库，视需要配置即可。

注意，以上配置是全局性的，如果不想全局配置，还有以下两种方案：

  1. 1.

    在项目根目录配置.cargo/config.toml，需要注意此时路径是相对于项目根目录的路径

  2. 2.

    无需配置config.toml，直接通过命令行传递，例如:

    --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown 
    cargo build  --target  aarch64-unknown-linux-ohos  --config target.aarch64-unknown-linux-ohos.linker=\"/path/to/aarch64-unknown-linux-ohos-clang.sh\"

3.编译

3.1 创建Rust项目

如果已经有现成项目则省略此步骤。

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

cargo new --lib hello #生成rust项目，此项目的生成物是一个动态库

添加以下代码：

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

#[unsafe(no_mangle)]
pub extern "C" fn add(left: u64, right: u64) -> u64 {
    left + right
}

上述代码实现一个简单的C接口，将输入的两个参数加起来并返回计算后的结果。

另外，我们这里只编译静态库即可。Cargo.toml配置如下:

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

[package]
name = "hello"
version = "0.1.0"
edition = "2024"

[dependencies]

[lib]
path="src/lib.rs"
crate-type = ["cdylib"]

3.2 编译项目

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

cargo build --release --target aarch64-unknown-linux-ohos
cargo build --release --target armv7-unknown-linux-ohos
cargo build --release --target x86_64-unknown-linux-ohos

编译成功即可生成各种平台的动态库

4.注意事项

4.1 可能遇到的问题

  1. 1.

    部分crate在ohos下不被支持

    1. 1.

      例如socket2的0.5.4版本无法在ohos下编译通过，需要升级到0.5.10

  2. 2.

    部分crate由于需要编译C代码，需要指定TARGET_CC的地址

    1. 1.

      例如ring crate需要编译C代码，则需要显式地指定ohos的编译器地址，命令参考:

      TARGET_CC=/path/to/x86_64-unknown-linux-ohos-clang cargo.sh build --target x86_64-unknown-linux-ohos

4.2 小贴士

如果期望项目能够在不同的环境中编译，而ohos sdk的路径会发生变化，可以在脚本中用环境变量代替ohos路径，编译时之前设置环境变量的值即可。

5.参考资料

[1] https://doc.rust-lang.org/rustc/platform-support/openharmony.html

[2]OpenHarmony RUST 应用开发指导

1. 前言

Rust是一种系统级编程语言，由Mozilla开发，专注于安全性、并发性和性能。它通过所有权系统、借用检查器和生命周期管理等机制，在编译时防止数据竞争和内存安全问题，同时无需垃圾回收机制。Rust还支持零成本抽象和与C/C++的高效交互（通过FFI），适合开发高性能分布式系统、游戏引擎等场景。实际应用中，Rust相比Python等语言能显著降低资源消耗。

鸿蒙OS（HarmonyOS）是华为开发的分布式操作系统，主要面向全场景智能设备（如手机、物联网、车载系统等）。其核心特点是分布式架构，支持跨设备协同、低延迟和高安全性。从技术实现来看，鸿蒙提供原生开发工具链（如DevEco Studio）和跨平台编译支持（如针对aarch64/armv7/x86_64等多架构的交叉编译能力）。

实际项目中，由RUST开发的基础库可便捷地应用到各大主流操作系统，在最新的Rust版本中已经支持跨平台编译鸿蒙OS的Native库，本文介绍如何编译。

2. 环境准备

2.1 下载配置ohos-ndk

2.1.1 下载

您可以从OpenHarmony社区获取最新的release版本(当前为5.1.0-Release)的Public SDK包

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

# 下载SDK包
wget https://repo.huaweicloud.com/openharmony/os/5.1.0-Release/ohos-sdk-windows_linux-public.tar.gz
# 解压SDK包
tar -xvzf ohos-sdk-windows_linux-public.tar.gz
# 解压ndk压缩包
cd /path/to/ohos-sdk/linux
unzip native-linux-*
2.1.2 配置

主要是配置各种版本的编译脚本，不必全部配置，选择你需要的平台即可。依次创建以下脚本：

aarch64-unknown-linux-ohos-clang.sh

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

#!/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__ \
  "$@"

armv7-unknown-linux-ohos-clang.sh

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

#!/bin/sh
exec /path/to/ohos-sdk/linux/native/llvm/bin/clang \
  -target arm-linux-ohos \
  --sysroot=/path/to/ohos-sdk/linux/native/sysroot \
  -D__MUSL__ \
  -march=armv7-a \
  -mfloat-abi=softfp \
  -mtune=generic-armv7-a \
  -mthumb \
  "$@"

x86_64-unknown-linux-ohos-clang.sh

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

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

记得要赋予执行权限

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

chmod +x aarch64-unknown-linux-ohos-clang.sh
chmod +x armv7-unknown-linux-ohos-clang.sh
chmod +x x86_64-unknown-linux-ohos-clang.sh

2.2 配置rust

2.2.1 添加目标平台的工具链

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

rustup target add aarch64-unknown-linux-ohos
rustup target add armv7-unknown-linux-ohos
rustup target add x86_64-unknown-linux-ohos
2.2.2 配置目标平台的ar和linker

修改~/.cargo/config.toml文件，添加以下内容

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

[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"

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

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

ar用于编译静态库，linker用于编译动态库，视需要配置即可。

注意，以上配置是全局性的，如果不想全局配置，还有以下两种方案：

  1. 1.

    在项目根目录配置.cargo/config.toml，需要注意此时路径是相对于项目根目录的路径

  2. 2.

    无需配置config.toml，直接通过命令行传递，例如:

    --javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown 
    cargo build  --target  aarch64-unknown-linux-ohos  --config target.aarch64-unknown-linux-ohos.linker=\"/path/to/aarch64-unknown-linux-ohos-clang.sh\"

3.编译

3.1 创建Rust项目

如果已经有现成项目则省略此步骤。

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

cargo new --lib hello #生成rust项目，此项目的生成物是一个动态库

添加以下代码：

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

#[unsafe(no_mangle)]
pub extern "C" fn add(left: u64, right: u64) -> u64 {
    left + right
}

上述代码实现一个简单的C接口，将输入的两个参数加起来并返回计算后的结果。

另外，我们这里只编译静态库即可。Cargo.toml配置如下:

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

[package]
name = "hello"
version = "0.1.0"
edition = "2024"

[dependencies]

[lib]
path="src/lib.rs"
crate-type = ["cdylib"]

3.2 编译项目

--javascripttypescriptshellbashsqljsonhtmlcssccppjavarubypythongorustmarkdown

cargo build --release --target aarch64-unknown-linux-ohos
cargo build --release --target armv7-unknown-linux-ohos
cargo build --release --target x86_64-unknown-linux-ohos

编译成功即可生成各种平台的动态库

4.注意事项

4.1 可能遇到的问题

  1. 1.

    部分crate在ohos下不被支持

    1. 1.

      例如socket2的0.5.4版本无法在ohos下编译通过，需要升级到0.5.10

  2. 2.

    部分crate由于需要编译C代码，需要指定TARGET_CC的地址

    1. 1.

      例如ring crate需要编译C代码，则需要显式地指定ohos的编译器地址，命令参考:

      TARGET_CC=/path/to/x86_64-unknown-linux-ohos-clang cargo.sh build --target x86_64-unknown-linux-ohos

4.2 小贴士

如果期望项目能够在不同的环境中编译，而ohos sdk的路径会发生变化，可以在脚本中用环境变量代替ohos路径，编译时之前设置环境变量的值即可。

5.参考资料

[1] https://doc.rust-lang.org/rustc/platform-support/openharmony.html

[2]OpenHarmony RUST 应用开发指导

鸿蒙OS与Rust整合开发流程
lpfasd123的博客
08-28 721
本文档详细介绍如何在鸿蒙OS应用中集成Rust代码，通过将Rust编译为SO库，实现鸿蒙应用（ArkTS/Java）与Rust的交互。这种整合方式可以充分利用Rust的性能优势和内存安全性，同时发挥鸿蒙OS的生态优势。通过本文档介绍的方法，我们可以在鸿蒙OS应用中成功集成Rust代码，充分利用两种技术的优势。这种整合方式不仅可以提升应用的性能和安全性，还能复用已有的Rust生态系统资源。随着鸿蒙OS的不断发展，相信Rust与鸿蒙的整合会更加顺畅，为开发者提供更多可能性。
Rust 跨平台-Android 和鸿蒙 OS
三翼鸟数字化平台的技术实践分享
06-27 2195
​使用Rust 实现跨平台开发
怎样基于ohos-rs使用Rust开发鸿蒙Native模块
duoduola888的博客
05-19 1351
在鸿蒙原生应用开发中，我们通常会使用 ArkTS 作为开发语言，其提供了包括UI以及各种内置工具库的强大能力，不过在某些场景下，我们依旧需要考虑使用更加底层的语言来提供更加强大的能力。出于其设计的一致性，作者将 napi-rs 进行了迁移适配从而是的我们能够在鸿蒙中使用到完整的 napi-rs 的能力。在 Rust 的社区中，有相当多的 crc32 包实现，现在我们可以像开发 Rust 项目一样在我们的工程中引入对应的依赖了。当出现如下的效果的时候，就意味着我们的初始化工作已经完成了。
Rust 程序适配 OpenHarmony 实践：以 sd 工具为例
最新发布
穆雄雄的博客
11-15 5313
sdsearch &displace) 是一个用 Rust 编写的直观查找与替换命令行工具。项目名称：sd版本：1.0.1源码仓库适配版本通过sdRust 语言编写的程序完全可以编译运行在 HarmonyOS 上，为鸿蒙生态的发展提供了新的可能性。通过sd工具的适配实践，我们不仅成功地将一个优秀的 Rust 工具带到了 HarmonyOS 平台，更重要的是证明了Rust 语言完全可以适配 HarmonyOS。
用Rust开发鸿蒙应用（ArkTS NAPI）
zrufo747的博客
08-15 5066
为ArkUI添加Rust支持
HarmonyOS RUST 应用开发指导
BelanLu的博客
03-29 4367
开发者在进行鸿蒙应用开发时，希望用 Rust 构建部分应用模块以获得应用在运行性能、安全等方面的提升，或者开发者希望将三方 Rust 模块进行鸿蒙化。虽然Rust主线版本已经支持 OpenHarmony，但当前Rust对于 OpenHarmony 为 tier3 支持，无法使用 rustup 下载到 OpenHarmony 对应的 std 标准库。所以推荐使用 rust nightly 版本实时构建std标准库，此方式会默认将 OpenHarmony 的 std 和 Rust 模块静态链接。
【社区投稿】Rust登陆华为鸿蒙操作系统之Native模块开发
Rust语言学习交流
02-17 3467
Rust登陆【华为鸿蒙】操作系统之Native模块开发名词解释【鸿蒙操作系统】的英文全名是Open Harmony Operation System。正文将以其首字母缩写词ohos引用该词条。【鸿蒙软件开发工具包】的英文全名是Open Harmony Software Development Kit。正文也将以它的首字母缩写词ohsdk引用该词条。DevEco Studio IDE是【华为】为鸿蒙...
基于libui的Rust跨平台GUI开发库
libui-rs 是一个为 Rust 编程语言提供 libui 图形用户界面（GUI）库绑定的项目，旨在让 Rust 开发者能够以“Rusty”的方式构建跨平台桌面应用程序。该项目基于原始的 libui 库——一个用 C 语言编写的轻量级、原生...
Flutter与Rust库集成：跨平台编译与无中介通信
这种技术实践的核心在于能够对所有可用的iOS和Android架构进行交叉编译本机Rust代码，并且能够从普通的Dart代码中调用Rust函数。这一点展示了Flutter与Rust结合后的强大功能，开发者可以仅用Dart语言编写应用程序，...
Rust跨平台示例：iOS与Android库构建指南
从给定的文件信息中，我们可以看出，该内容主要介绍了在Rust语言中如何创建一个跨平台的库，这个库将用于iOS和Android这两个移动操作系统。以下将详细介绍涉及的知识点。 ### Rust编程语言基础 Rust是一种系统编程...
Rust编译BoringSSL支持多平台静态库
接下来是跨平台编译（Cross-compilation）的技术挑战。Rust 本身具备强大的跨平台支持能力，通过 `cargo` 构建系统配合不同的 target triple（目标三元组），可以为 iOS (`aarch64-apple-ios`)、Android (`aarch64-...
ohos-rs-Rust资源
06-22
A framework for building compiled OpenHarmony SDK in Rust via Node-API(Forked from napi-rs)
【Rust日报】2022-09-14 使用 Rust 构建简单博客 && 华为实习生招募
Rust语言学习交流
09-14 1677
使用 Rust 构建简单博客作者以写 Go 为主，他认为学习任何语言都可以从一个 web 程序入手，那么事情就会变得明朗，本文展示的是作者在学习了一段时间 Rust 后开始搭建简单博客系统的过程，很有意思。https://mortenvistisen.com/posts/how-to-build-a-simple-blog-using-rust【回看】Rust 教育研讨会 2022https://...
Rust跨平台-Android和鸿蒙OS
嘴巴吃糖了
03-20 3178
通常情况下安装 rustup 的时候，标准库就已经安装到本地；但是 rust 有几种发布渠道，用于提供不同稳定程度的 Rust 版本，Rust 的三个主要发布渠道是：
linux下编译鸿蒙版curl、openssl
jwybobo2007的博客
10-12 1959
是一个用相对路径表示的统一编译安装目录，openssl和curl都会引用以及安装到这个目录下，所以要保证两个开源库使用的编译脚本中的这个相对路径指向同一目录。如果有什么问题的话，也可以自己手动改成想要的路径，两个脚本一致就行。目前我编译的全部都是静态库，如果需要编译动态库的话，还需要调整下编译脚本中的参数。具体的参数可以查看openssl和curl的编译说明。curl使用的版本是 7.81。如果中间没有错误的话，在。下会生成以下文件和文件夹。
鸿蒙OpenHarmony【交互工具使用】子系统
zxc95279527q的博客
10-24 613
Bindgen和CXX工具的主要功能是实现Rust和C/C++之间的交互。其中，Bindgen通过将C接口转换为Rust接口来实现Rust对C的调用，CXX可以通过建立C接口和Rust接口的映射关系来实现C++和Rust的相互调用。
未来鸿蒙系统，会不会用 Rust 重写？
渔夫.AI
03-09 1520
是的，Rust 现在是 OpenHarmony 的官方 “系统开发语言”，操作系统中的很多模块都会选择使用 Rust 开发，从官方的行动来看，我觉得当然会使用 Rust 重写。今天分享主题，最近发现 OpenHarmony 出现大量的 Rust 代码，是不是以后 Rust 可能成为鸿蒙开发的主要语言，或未来的鸿蒙是否使用 Rust 重写等谈论。我是渔夫，现在在国内某某云程序员，业余独立开发者，探索副业，生活、技术、非科班转码经验等相关文章，欢迎关注，和渔夫一起成长。毫无疑问，必须重写，哈哈！
OpenHarmony开发-系统烧录，12道网络安全高级面试题
code8889的博客
04-18 1353
HDC (OpenHarmony Device Connector) 是为开发人员提供的用于设备连接调试的命令行工具，pc端开发机使用命令行工具hdc_std进行调试，该工具支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备(或模拟器)进行连接调试通信。如果操作正确，主板将进入USB烧录模式，同时，RK烧录工具识别到连接设备，显示 Found One LOADER Device，后面我们使用RK烧录工具进行系统烧录即可。在镜像下载完成后，我们需要导入镜像配置到烧录工具中。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值