小工具知识网

当前位置: 首页 > 行业知识 > 用Rust开发鸿蒙应用(ArkTS NAPI)

行业知识

用Rust开发鸿蒙应用(ArkTS NAPI)

2026-11-17 14:53:57 来源:互联网转载

开发流程

在DevEco Studio的模板工程中包含使用Native API的默认工程,使用File->New->Create Project创建Native C++模板工程。

()

在此基础上进行修改

删除

()

entry/src/main/cpp

打开

entry/build-profile.json5

删除c++ build 配置

{  "apiType": "stageMode",  "buildOption": {    // "externalNativeOptions": {    //  "path": "./src/main/rust/CMakeLists.txt",    //  "arguments": "",    //  "cppFlags": "",    //  }  },  "targets": [    {      "name": "default",      "runtimeOS": "HarmonyOS"    },    {      "name": "ohosTest",    }  ]}

创建rust项目

cargo new hello

修改 Cargo.toml

[package]name = "hello"version = "0.1.0"edition = "2021"[lib]name = "hello"crate-type = ["dylib"][dependencies]oh-napi-sys = "0.1" ctor = "0.1"

lib.rs 添加测试代码

use std::ffi::{CString};use std::ptr::{null_mut};use oh_napi_sys::*;use ctor::ctor;extern "C" fn add(env: napi_env, info: napi_callback_info) ->napi_value{    // 期望从ArkTS侧获取的参数的数量,napi_value可理解为ArkTS value在Native方法中的表现形式。    let mut args:[napi_value; 2] = [null_mut();2];    let mut argc = args.len();    unsafe {        napi_get_cb_info(env, info, &mut argc, args.as_mut_ptr(), null_mut(), null_mut());        let mut valuetype0  = napi_valuetype_napi_undefined;        napi_typeof(env, args[0], &mut valuetype0);        let mut valuetype1  = napi_valuetype_napi_undefined;        napi_typeof(env, args[1], &mut valuetype1);        if (valuetype0 != napi_valuetype_napi_number) || (valuetype1 != napi_valuetype_napi_number) {            let mut undefined: napi_value= null_mut();            napi_get_undefined(env, &mut undefined);            return undefined;        }        // 将获取的ArkTS参数转换为Native信息,此处ArkTS侧传入了两个number,这里将其转换为Native侧可以操作的double类型。        let mut value0 = 0f64;        napi_get_value_double(env, args[0], &mut value0);        let mut value1 = 0f64;        napi_get_value_double(env, args[1], &mut value1);        // Native侧的业务逻辑,这里简单以两数相加为例。        let native_sum = value0 + value1;        // 此处将Native侧业务逻辑处理结果转换为ArkTS值,并返回给ArkTS。        let mut sum = null_mut();        napi_create_double(env, native_sum, &mut sum);        return sum;    }}type Callback = extern "C" fn(env: napi_env, info: napi_callback_info) -> napi_value;unsafe fn new_func_descriptor(name: &'static str, f: Callback) ->napi_property_descriptor{    let name= CString::new(name).unwrap();    napi_property_descriptor{        utf8name: CString::into_raw(name),        name: null_mut(),        method: Some(f),        getter: None,        setter: None,        value: null_mut(),        attributes: napi_property_attributes_napi_default,        data: null_mut(),    }}// 注册 module#[ctor]fn register_hello_module(){    let name= CString::new( "hello").unwrap();    let mut hello_module = napi_module{        nm_version: 1,        nm_flags: 0,        nm_filename: null_mut(),        nm_register_func: Some(init),        nm_modname: name.as_ptr() as _,        nm_priv: 0 as * mut _,        reserved: [0 as * mut _;4],    };    unsafe {        napi_module_register(&mut hello_module);    }    // Init将在exports上挂上Add/NativeCallArkTS这些Native方法,此处的exports就是开发者import之后获取到的ArkTS对象。    unsafe extern "C" fn init(env: napi_env , exports: napi_value )-> napi_value {        let desc =[            new_func_descriptor("add", add),        ];        let count = desc.len();        napi_define_properties(env, exports, count, desc.as_ptr());        return exports;    }}

添加对应ts代码

// entry/src/main/rust/types/libhello/index.d.tsexport const add: (a: number, b: number) => number;
// entry/src/main/rust/types/libhello/oh-package.json5{  "name": "libhello.so",  "types": "./index.d.ts",  "version": "",  "description": "Please describe the basic information."}

配置依赖

// entry/oh-package.json5{  "name": "entry",  "version": "1.0.0",  "description": "Please describe the basic information.",  "main": "",  "author": "",  "license": "",  "dependencies": {    "libhello.so": "file:./src/main/rust/types/libhello"  }}

在 rust 根目录下编译,添加ohos目标的教程可以参考 Rust交叉编译OpenHarmony应用动态库

cargo build -Zbuild-std  --release  --target aarch64-unknown-linux-ohos

将编译好的 libhello.so 拷贝至

entry/libs/arm64-v8a

修改页面 Index.ets

import testNapi from 'libhello.so'// onClick 里添加hilog.info(0x0000, 'testTag', 'Test NAPI 2 + 3 = %{public}d', testNapi.add(2, 3));

编译app点击hello world,日志中看到 Test NAPI 2 + 3 = 5

上一篇:网吧服务器怎么开启vt?

下一篇:服务器迁移方案怎么写好?