在本篇文章中,筆者使用三方庫移植之NAPI開發(fā)[1]—Hello OpenHarmony NAPI中一樣的hellonapi.cpp和index.ets源碼.

??想了解更多關(guān)于開源的內(nèi)容,請訪問:??
??51CTO 開源基礎(chǔ)軟件社區(qū)??
??https://ost.51cto.com??
- 在三方庫移植之NAPI開發(fā)[1]—Hello OpenHarmony NAPI一文中,筆者開發(fā)的是一個rom包的napi工程。該工程需要編譯燒錄固件,C ++的動態(tài)庫會集成到開發(fā)板的ROM中。
- 在本篇文章中,筆者使用三方庫移植之NAPI開發(fā)[1]—Hello OpenHarmony NAPI中一樣的hellonapi.cpp和index.ets源碼,通過IDE開發(fā)一個RAM包的NAPI工程(集成C ++的動態(tài)庫到開發(fā)板的RAM中),直接編譯安裝hap包到開發(fā)板即可。兩個開發(fā)方式的hap包運行效果一致。
開發(fā)環(huán)境:
創(chuàng)建工程
打開IDE,創(chuàng)建一個Native C++工程。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/d5eb6e666c0b2f1f8a4026d155089f127bf54f.png?x-oss-process=image/resize,w_820,h_1115)
SDK選擇API9,model選擇Stage。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/879e6d019ee3d36a14b755b6e0f578a8b88267.png?x-oss-process=image/resize,w_820,h_1017)
源碼實現(xiàn)
- 新建的Native C++工程有一個默認的hello world教程,接下來需要編輯的文件如下:
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/183bcb85178778e07ee337513c881be49bf584.png?x-oss-process=image/resize,w_792,h_1321)
C++方法實現(xiàn)
將默認的hello.cpp文件重命名為hellonapi.cpp,選中右鍵選中重構(gòu)重命名。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/977d40c142786aecf5c10277a66e5606246d71.png?x-oss-process=image/resize,w_759,h_461)
hellonapi.cpp內(nèi)容如下:
#include "napi/native_api.h"
#include <string>
//接口業(yè)務(wù)實現(xiàn)C/C++代碼
//std::string 需要引入string頭文件,#include <string>
static napi_value getHelloString(napi_env env, napi_callback_info info) {
napi_value result;
std::string words = "Hello OpenHarmony NAPI";
//NAPI_CALL(env, napi_create_string_utf8(env, words.c_str(), words.length(), &result));
napi_create_string_utf8(env, words.c_str(), words.length(), &result);
return result;
}
// napi_addon_register_func
//2.指定模塊注冊對外接口的處理函數(shù),具體擴展的接口在該函數(shù)中聲明
static napi_value registerFunc(napi_env env, napi_value exports)
{
static napi_property_descriptor desc[] = {
// 聲明該napi_module對外具體的提供的API
{ "getHelloString", nullptr, getHelloString, nullptr, nullptr, nullptr, napi_default, nullptr }
};
//NAPI_CALL(env, napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc));
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
// 1.先定義napi_module,指定當前NAPI模塊對應(yīng)的模塊名
//以及模塊注冊對外接口的處理函數(shù),具體擴展的接口在該函數(shù)中聲明
// nm_modname: 模塊名稱,對應(yīng)eTS代碼為import nm_modname from '@ohos.ohos_shared_library_name'
//示例對應(yīng)eTS代碼為:import hellonapi from '@ohos.hellonapi'
static napi_module hellonapiModule = {
.nm_version = 1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = registerFunc, // 模塊對外接口注冊函數(shù)
.nm_modname = "hellonapi", // 自定義模塊名
.nm_priv = ((void*)0),
.reserved = { 0 },
};
//3.模塊定義好后,調(diào)用NAPI提供的模塊注冊函數(shù)napi_module_register(napi_module* mod)函數(shù)注冊到系統(tǒng)中。
// register module,設(shè)備啟動時自動調(diào)用此constructor函數(shù),把模塊定義的模塊注冊到系統(tǒng)中
extern "C" __attribute__((constructor)) void hellonapiModuleRegister()
{
napi_module_register(&hellonapiModule);
}
此時的native_api.h文件是在sdk\native\3.2.7.5\sysroot\usr\include\napi目錄下。
CMakeLists.txt編譯配置文件編寫
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/c6a482d221d76b4dd32128551fabed275fc90f.png?x-oss-process=image/resize,w_820,h_471)
- 和開發(fā)rom包的NAPI工程需要在BUILD.gn文件中指定編譯so庫需要的頭文件和源文件、動態(tài)庫名稱、依賴的庫一樣,通過IDE開發(fā)ROM包時也需要在CMakeLists.txt中指定編譯so庫需要的頭文件和源文件、動態(tài)庫名稱、依賴的庫,內(nèi)容如下:
cmake_minimum_required(VERSION 3.4.1)
project(MyApplication3)
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
include_directories(${NATIVERENDER_ROOT_PATH}
${NATIVERENDER_ROOT_PATH}/include)
add_library(hellonapi SHARED hellonapi.cpp)
target_link_libraries(hellonapi PUBLIC libace_napi.z.so)
- NATIVERENDER_ROOT_PATH路徑指的是sdk\native\3.2.7.5\sysroot\usr
- add_library(hellonapi SHARED
hellonapi.cpp)表示編譯libhellonapi.so需要的是hellonapi.cpp
- target_link_libraries(hellonapi PUBLIC
libace_napi.z.so)表示編譯編譯libhellonapi.so依賴libace_napi.z.so
- 開發(fā)ROM包的NAPI工程時,libhellonapi.z.so也依賴libace_napi.z.so,以下為開發(fā)ROM包的NAPI工程時BUILD.gn文件
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/473d08d03b0b56774b4016619f2b718956bf1b.png?x-oss-process=image/resize,w_678,h_137)
libhellonapi.so依賴的libace_napi.z.so在sdk\native\3.2.7.5\sysroot\usr\lib\aarch64-linux-ohos目錄下。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/c2a7256472b8f5826046202e4182631dc82114.png?x-oss-process=image/resize,w_820,h_170)
sdk\native\3.2.7.5\sysroot\usr\lib\arm-linux-ohos目錄下也有開發(fā)ROM包的NAPI時候可能依賴的動態(tài)庫。
index.d.ts聲明文件編寫
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/7994076958acfc8bcd713597fd3eb6a959974f.png?x-oss-process=image/resize,w_820,h_158)
index.d.ts內(nèi)容如下:
export const getHelloString: () => string;
界面設(shè)計
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/064caeb6591ddd96a481750f8f069a2e1862c3.png?x-oss-process=image/resize,w_820,h_754)
index.ets和??三方庫移植之NAPI開發(fā)[1]—Hello OpenHarmony NAPI??一文中一致。
import prompt from '@system.prompt'
import hellonapi from 'libhellonapi.so'
@Entry
@Component
export struct HelloNAPI {
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Button("NAPI: hellonapi.getHelloString()").margin(10).fontSize(24).onClick(() => {
// 調(diào)用getHelloString接口
let strFromNAPI = hellonapi.getHelloString()
prompt.showToast({ message: strFromNAPI })
})
}
.width('100%')
.height('100%')
}
}
json配置文件編寫

{
"name": "libhellonapi.so",
"types": "./index.d.ts"
}
- entry/package-lock.json內(nèi)容如下:

"@types/libhellonapi.so":"file:./src/main/cpp/types/libhellonapi"
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/f89e2e9551f529ada453983a9d52db0a055066.png?x-oss-process=image/resize,w_767,h_143)
- 有報錯就刪除原有的libentry.so符號鏈接。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/925bf7a191c75c951f2058c94bde4ce4e62dbf.png?x-oss-process=image/resize,w_553,h_598)
- entry/package.json內(nèi)容如下:

"@types/libhellonapi.so": {
"version": "file:src/main/cpp/types/libhellonapi",
- 修改原有的libentry為libhellonapi


hap包運行效果
和三方庫移植之NAPI開發(fā)[1]—Hello OpenHarmony NAPI一文效果一致。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/f6f38d995853948f7111660ac8259c31ca3867.gif)
總結(jié):RAM包的NAPI工程和ROM包的NAPI工程的異同
以下為個人總結(jié),希望各位老師和同學批評指正
- 動態(tài)庫的命名方式的不同,RAM包的NAPI工程(通過IDE開發(fā)NAPI工程)使用的動態(tài)庫libhellonapi.so,而ROM包的NAPI工程編譯出來使用的動態(tài)庫是libhellonapi.z.so。
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/61bc93f7826bdb5eefd2732b1fdd5fc878f144.png?x-oss-process=image/resize,w_820,h_410)
- libhellonapi.so位于hap包源碼路徑如下:
entry\build\default\intermediates\libs\default\arm64-v8a
entry\build\default\intermediates\cmake\default\obj\arm64-v8a
entry\build\default\intermediates\libs\default\armeabi-v7a
entry\build\default\intermediates\cmake\default\obj\armeabi-v7a

- 開發(fā)ROM包的NAPI工程需要加入OHOS編譯體系,編寫B(tài)ULID.gn、ohos.build等,開發(fā)過程較為繁瑣。而RAM包的NAPI工程不需要加入OHOS編譯體系,編寫CMakeLists.txt配置編譯需要的源文件、頭文件、依賴的庫等。因此開發(fā)RAM包的NAPI工程相對簡潔。
- .d.ts聲明文件的編寫不同
- 開發(fā)ROM包的NAPI工程時,筆者編寫的@ohos.hellonapi.d.ts內(nèi)容為

- 開發(fā)RAM包的NAPI工程時,筆者編寫的@ohos.hellonapi.d.ts內(nèi)容為:
![#打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū) #打卡不停更#三方庫移植之NAPI開發(fā)[3]通過IDE開發(fā)NAPI工程-開源基礎(chǔ)軟件社區(qū)](https://dl-harmonyos.51cto.com/images/202210/27dd9a9067945789511933fe2b85a6f8cea087.png?x-oss-process=image/resize,w_754,h_99)
編寫.d.ts聲明文件時,RAM包開發(fā)的NAPI工程定義功能方法getHelloString: () => string比ROM包多了=>符號。知識點附送
- 以下為開發(fā)ROM包的NAPI工程時,需要添加進入sdk的聲明文件模板。
@ohos.模塊名.d.ts文件:
/**
* 模塊描述
* @since API版本號,IT Release3 對應(yīng) 4,以此類推
* @sysCap 系統(tǒng)能力
* @devices 支持設(shè)備
* @import 導入模塊
* @permission 權(quán)限列表
*/
declare namespace 模塊名 {
// 在此處定義功能方法
}
export default 模塊名;
文章相關(guān)附件可以點擊下面的原文鏈接前往下載:
??https://ost.51cto.com/resource/2351。??
??想了解更多關(guān)于開源的內(nèi)容,請訪問:??
??51CTO 開源基礎(chǔ)軟件社區(qū)??
??https://ost.51cto.com??。