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

openharmony napi调试笔记

news 来源：原创 2025/7/21 6:11:12

一、动态库的编译

第一种openharmony交叉编译链配置方法

使用的编译环境是ubuntu20.04

1、使用vscode配置openharmony sdk交叉编译环境

首先下载openharmony的sdk，如native-linux-x64-4.1.7.5-Release.zip

解压后native目录下就是交叉编译用的sdk

在要编译的源代码目录下新建.vscode目录，进入该目录新建settings.json文件文件内容如下，根据自己的sdk目录修改cmake的路径

{

"cmake.cmakePath":"/home/xxx/native/build-tools/cmake/bin/cmake"

}

2、在vscode中也需要安装cmake插件

3、在插件中配置交叉编译器

打开cmake-tools-kits.json文件：

vim .local/share/CMakeTools/cmake-tools-kits.json

这个文件的作用就是：告诉VSCode当前系统中都有哪些编译器可供使用，一般是CMakeTools插件自动获取到的，但是CMakeTools插件无法自动获取到我们的交叉编译器。

所以我们手动将交叉编译器添加到cmake-tools-kits.json文件中（必须添加到文件末尾），因为我们使用的是CMake，所以只需将toolchain.cmake文件的路径配置进去就可以了：

{

"name": "arm_corss_compiler",

"toolchainFile": "/home/fhc/myWorkspace/cmake_project/cmake_cross_complie_base/toolchain.cmake"

}

4、Ctrl+Shift+p打开VSCode的指令面板，然后输入cmake:q，VSCode会根据输入自动提示，然后选择

CMake: Quick Start

5、然后选择我们自己配置的交叉编译器

6、编写cmake文件

cmake_minimum_required(VERSION 3.5.0)
project(TESTLIB VERSION 0.1.0 LANGUAGES C CXX)

set(ROOTDIR ..) #设置变量
set(SRCDIR ${ROOTDIR}/src)
include_directories(${SRCDIR} ${SRCDIR}/..) #设置头文件搜索路径
aux_source_directory(${SRCDIR}/src CPP_SRC)
aux_source_directory(${SRCDIR}/others CPP_SRC) #将目录下的所有源文件包含变量CPP_SRC
add_library(TESTLIB SHARED ${CPP_SRC}) #设置库名称位TESTLIB 包含的源文件：CPP_SRC

set(LIBRARY_OUTPUT_PATH ${ROOTDIR}/../Lib/linuxLib) #设置库的导出目录

target_link_libraries(TESTLIB PUBLIC ${PROJECT_BINARY_DIR}/../../Lib/linuxLib/libusb_shared.z.so) #设置需要依赖的库

7、点击左下脚的build按钮

第二种、vscode安装及openharmony交叉编译链配置方法

sudo apt update
sudo snap install --classic code

安装cmake插件
安装cmake tools插件

mkdir .vscode
cd .vscode
vi setting.json
输入
{
"cmake.cmakePath":"/home/{你的用户名}/native/build-tools/cmake/bin/cmake"
"cmake.configureArgs": [
"-DOHOS_ARCH=armeabi-v7a",
"-DCMAKE_TOOLCHAIN_FILE=/home/{你的用户名}/native/build/cmake/ohos.toolchain.cmake",
]
}
其中的目录使用自己的工具链保存目录
进入工程所在目录
打开控制台
输入code . 打开vscode
在vscode中按下键盘的 ctrl+shift+p
在指令窗口输入cmake
选择quick statrt
根据提示输入工程名称和等设置
点击vscode界面左侧的extensions按钮，找到安装好的CMake Tools，点击右下角的齿轮设置按钮，在下拉菜单中选择settings在弹出的窗口中添加Additional compiler search dirs和Additional kits路径设置为鸿蒙sdk目录下的 native/llvm/bin 这样CMakeTools就可以搜索到sdk的交叉编译联工具了。

在vscode中按下键盘的 ctrl+shift+p 在命令窗口中输入cmake 选择select a kit
如果下面没有native下的交叉编译链就点击第一个多扫描几次。

刚才的CMake插件的quickstatrt已经创建好了cmake文件，在cmake文件中按需修改配置，点击左下角的build按钮即可完成编译

二、openharnony应用调用动态库

1、安装 deveco studio 4.1或5.0，5.0目前编译的时候不能只编译32位版本，不知道为什么，如果编译一个需要在cmake中做条件编译和依赖。比如：

if(OHOS_ARCH STREQUAL armeabi-v7a)

add_library(entry SHARED napi_init.cpp)

else()

add_library(entry SHARED napi_init_64.cpp)

endif()

2、修改 build-profile.json5 文件中的products目录，以下是5.0版本的

"products": [{"name": "default","signingConfig": "default","compileSdkVersion": 11,"compatibleSdkVersion": 11,"runtimeOS": "OpenHarmony","buildOption": {"externalNativeOptions": {"abiFilters": ["armeabi-v7a","arm64-v8a"]},"strictMode": {"caseSensitiveCheck": true,}}}
],

3、按官网的教程把so库和头文件放入相应的目录。

4、最后应用打开以后一调用napi可能会闪退，检查日志看是否有依赖的库没有放到目录中，可以使用needed by进行关键字筛选。

5、如果打开应用后界面显示不正常，只有应用图标，检查日志看是否有其他问题。可能需要修改动态库的源码，重新编译动态库。

6、如果涉及到一些硬件操作可能会打不开设备，需要修改设备的操作权限，比如usb设备可以使用下面的指令

chmod -R 777 /dev/bus/usb/

7、添加日志

在cmake文件中添加hilog的依赖库

target_link_libraries(entry PUBLIC libace_napi.z.so  libhilog_ndk.z.so)

在cpp文件中添加头文件

#include "hilog/log.h"

日志函数用法

OH_LOG_Print(LOG_APP,LOG_INFO, LOG_PRINT_DOMAIN,"Init","uvc open fail%{public}d",res);

8、智能指针

如果代码中用到智能指针编译可能有如下报错

ld.lld: error: undefined symbol: std::__n1::__shared_weak_count::__release_weak() >>> referenced by shared_ptr.h:216 (G:/RK3568/openharmony/SDK/11/native/llvm/bin/../include/libcxx-ohos/include/c++/v1/__memory/shared_ptr.h:216) >>> CMakeFiles/entry.dir/napi_init.cpp.o:(std::__n1::__shared_weak_count::__release_shared[abi:v15004]())

解决方法：在cmake中添加依赖库 libc++_shared.so

target_link_libraries(entry PUBLIC ${NATIVERENDER_ROOT_PATH}/../../../libs/${OHOS_ARCH}/libc++_shared.so)

9、添加编译参数

在项目的entry目录下的build-profile.json5中有相关的内容

"buildOption": {"externalNativeOptions": {"abiFilters": ["armeabi-v7a","arm64-v8a"],"path": "./src/main/cpp/CMakeLists.txt","arguments": "",            //cmake参数"cppFlags": "-std=c++11"    //编译器参数}
},

相关文章：