当前位置：首页 > news >正文

鸿蒙的NDK开发初级入门篇

news 2025/7/13 8:14:57

初级必备的知识： NDK开发在什么时候用？

答：：NDK 开发在帮助应用提升性能的情况下使用，比如游戏开发，和硬件交互的场景中。
还有一个公司已经有标准的C或C++库，不想在开发ArkTS的代码前提下。

开发NDK必须要了解的基础知识从低到高一步一步了解

第一：NDK 开发的基础调用流程。
NDK 开发是基于C/c++ 的开发工程，因此项目中会存在c++/c代码，因此项目存在entry工程中的ArkTS调用C/c++ 代码的情况。也有c/c++ 调用ArkTS的情况（进阶版本 hap 包里面的C调用hsp/har包中的c/ArkTS）
第二：实现以上的内容需要用到什么技术？
答：要想实现以上的技术需要使用到Node-API

曾用名NAPI，是HarmonyOS中提供ArkTS/JS与C/C++跨语言调用的接口，是NDK接口中的一部分。该接口是在Node.js提供的Node-API基础上扩展而来，但与Node.js中的Node-API不完全兼容。
第三：在鸿蒙中如何实现NDK 的开发
hap的创建流程：
如果当前未打开任何工程，可以在DevEco Studio的欢迎页，选择Create Project开始创建一个新NDK工程。
如果已经打开了工程，可以在菜单栏选择File > New > Create Project来创建一个新NDK工程。
根据工程创建向导，选择Native C++工程模板，然后单击Next。
在这里插入图片描述 hsp/har包的创建需要在创建包含c代码（NDK开发）的时候，需要在创建页面，将这个勾选

在这里插入图片描述
创建成功以后工程目录下的nain 下面包含一个cpp目录，就是用来开发NDK代码的

第三：如何构建NDK 工程：
答；使用CMake命令的方式（我不会）
可以使用项目中的CMake配置脚本，在上面的图片中cpp目录下有一个CMakeLists.txt 这个文件就是配置脚本文件。在NDK 项目创建的时候会有默认的脚本，具体含义如下：
# the minimum version of CMake.
cmake_minimum_required(VERSION 3.5.0)#这个CMake的版本号。2025年7月12默认是3.50
project(MyApplication) #工程的名字，不是库的名字哦

定义一个变量，并赋值为当前模块cpp目录

set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})#如果你需要引入其他的so包，以当前的这个目录为准，向上找比如：
set(TSE_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR}…/…/…/oh_modules/libtest/abc)

添加头文件.h目录，包括cpp，cpp/include，告诉cmake去这里找到代码引入的头文件

include_directories(${NATIVERENDER_ROOT_PATH}
${NATIVERENDER_ROOT_PATH}/include
${TSE_ROOT_PATH}/include)# 这个是基于刚才加的abc那个目录下有一个头文件，所以添加这个变量

声明一个产物libentry.so，SHARED表示产物为动态库，hello.cpp为产物的源代码

add_library(entry SHARED hello.cpp)# 这个地方可以将你要写的源代码编译到对应的库里面，有多个文件的时候可以这样添加
add_library(entry SHARED hello.cpp hello1.cpp hello2.cpp)

声明产物entry链接时需要的三方库libace_napi.z.so

这里直接写三方库的名称是因为它是在ndk中，已在链接寻址路径中，无需额外声明

target_link_libraries(entry PUBLIC libace_napi.z.so) #这个是链接三方库，如果有多个的情况可以这样添加，这个了还有几种情况 1 如果是一个项目中，其他模块的so库 2 entry模块下entry/libs/arm64-v8a/目录下有so库
第一个实现方案是：
target_link_libraries(entry PUBLIC libace_napi.z.so 模块名字:: 编译的库名字)
如：target_link_libraries(entry PUBLIC libace_napi.z.so libhsp::libhsp)
第二个实现方案是
target_link_libraries(entry PUBLIC libace_napi.z.so 模块名字:: 编译的库名字)
在这里插入图片描述

在这里插入图片描述

第四：构建NDK 工程需要在build-profile.json5 中配置什么
externalNativeOptions
模块级build-profile.json5中externalNativeOptions参数是NDK工程C/C++文件编译配置的入口，可以通过path指定CMake脚本路径、arguments配置CMake参数、cppFlags配置C++编译器参数、abiFilters配置编译架构等。
“apiType”: “stageMode”,
“buildOption”: {
“arkOptions”: {
},
“externalNativeOptions”: {
“path”: “./src/main/cpp/CMakeLists.txt”,
“arguments”: “”,
“cppFlags”: “”,
“abiFilters”: [
“arm64-v8a”,
“x86_64”
],
}
}