鸿蒙5.0开发常见问题【如何通过AKI三方库实现ArkTS与C/C++之间的跨语言调用？】

移动开发技术栈

于 2025-05-19 17:33:22 发布

阅读量338

点赞数 8

分类专栏：鸿蒙开发文章标签： harmonyos c语言 c++ 华为鸿蒙鸿蒙系统运维

本文链接：https://blog.csdn.net/m0_70748845/article/details/148066376

版权

鸿蒙开发专栏收录该内容

1838 篇文章

订阅专栏

ArkTS与C/C++之间交互，涉及到跨语言调用中数据转换，以及跨线程交互等内容。

当前可以通过[AKI]三方库实现跨语言调用。AKI针对OpenHarmony上提供ArkTS与C/C++跨语言互调的场景提供解决方案，提供了极简语法糖使用方式，一行代码完成ArkTS与C/C++的无障碍跨语言互调，所见即所得。同时开发者无需关心Node-API的线程安全问题、Native对象GC问题，为开发者屏蔽Node-API内部复杂逻辑。

ohpm HAR包依赖：

指定路径下（如：项目根路径/entry），输入如下命令安装ohpm har包依赖。

cd entry 
ohpm install @ohos/aki

CMakeLists.txt添加依赖（假定编译动态库名为：libhello.so）：

# ... 
 
# 1. 设置AKI根路径 
set(AKI_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules/@ohos/aki) 
set(CMAKE_MODULE_PATH ${AKI_ROOT_PATH}) 
find_package(Aki REQUIRED) 
 
# ... 
 
add_library(entry SHARED napi_init.cpp) 
# 2. 链接二进制依赖 & 头文件，需要确保target（例如为entry）与add_library()方法中的target保持一致 
target_link_libraries(entry PUBLIC Aki::libjsbind)

在右上角同步工程：

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在napi_init.cpp文件中用户自定义业务，并将业务的接口导出给ArkTS。

#include <aki/jsbind.h> 
#include <string> 
// 1、用户自定义业务 
std::string SayHello(std::string msg){  return msg + " too.";}  
 
// 2、导出业务接口 
// Step 1 注册 AKI 插件 
JSBIND_ADDON(entry) // 注册 AKI 插件名: 即为编译*.so名称，规则与Node-API一致 
 
// Step 2 注册 FFI 特性 
JSBIND_GLOBAL() 
{ 
  JSBIND_FUNCTION(SayHello); 
}

注册的AKI插件名需要与模块级的oh-package.json5文件dependencies标签的“lib<AKI插件名>”（例如libentry.so）字段名称保持一致。

在“src/main/cpp/types/libentry/index.d.ts”中导出.so文件的接口声明。

export const SayHello: (msg: string) => string;
在ArkTS文件中调用.so文件中的代码接口。

import aki from 'libentry.so' // 工程编译出来的*.so 
 
@Entry 
@Component 
struct Index { 
  @State message: string = 'Hello World'; 
 
  build() { 
    Row() { 
      Column() { 
        Text(this.message) 
          .fontSize(50) 
          .fontWeight(FontWeight.Bold) 
          .onClick(() => { 
            console.info(aki.SayHello("hello world")); // 调用.so文件中的代码接口 
          }) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述