場(chǎng)景介紹
OpenHarmony Node-API是基于Node.js 8.x LTS的 Node-API 規(guī)范擴(kuò)展開(kāi)發(fā)的機(jī)制，為開(kāi)發(fā)者提供了ArkTS/JS與C/C++模塊之間的交互能力盟迟。它提供了一組穩(wěn)定的裆装、跨平臺(tái)的API踱承，可以在不同的操作系統(tǒng)上使用。
本文中如無(wú)特別說(shuō)明哨免，后續(xù)均使用Node-API指代OpenHarmony Node-API能力茎活。
說(shuō)明： OpenHarmony Node-API與Node.js 8.x LTS的Node-API規(guī)范的接口異同點(diǎn)，詳見(jiàn)Node-API參考
一般情況下OpenHarmony應(yīng)用開(kāi)發(fā)使用ArkTS/JS語(yǔ)言琢唾，但部分場(chǎng)景由于性能载荔、效率等要求，比如游戲采桃、物理模擬等身辨，需要依賴使用現(xiàn)有的C/C++庫(kù)丐谋。Node-API規(guī)范封裝了I/O、CPU密集型煌珊、OS底層等能力并對(duì)外暴露ArkTS/JS接口号俐，從而實(shí)現(xiàn)ArkTS/JS和C/C++的交互。主要場(chǎng)景如下：
系統(tǒng)可以將框架層豐富的模塊功能通過(guò)ArkTS/JS接口開(kāi)放給上層應(yīng)用定庵。
應(yīng)用開(kāi)發(fā)者也可以選擇將一些對(duì)性能吏饿、底層系統(tǒng)調(diào)用有要求的核心功能用C/C++封裝實(shí)現(xiàn)，再通過(guò)ArkTS/JS接口使用蔬浙，提高應(yīng)用本身的執(zhí)行效率猪落。
Node-API的組成架構(gòu)
圖1 Node-API的組成架構(gòu)
- Native Module：開(kāi)發(fā)者使用Node-API開(kāi)發(fā)的模塊，用于在ArkTS側(cè)導(dǎo)入使用畴博。
- Node-API：實(shí)現(xiàn)ArkTS與C/C++交互的邏輯笨忌。
- ModuleManager：Native模塊管理，包括加載俱病、查找等官疲。
- ScopeManager：管理napi_value的生命周期。
- ReferenceManager：管理napi_ref的生命周期亮隙。
- NativeEngine：ArkTS引擎抽象層途凫，統(tǒng)一ArkTS引擎在Node-API層的接口行為。
- ArkComiler ArkTS Runtime：ArkTS運(yùn)行時(shí)溢吻。
Node-API的關(guān)鍵交互流程
圖2 Node-API的關(guān)鍵交互流程
ArkTS和C++之間的交互流程维费，主要分為以下兩步：
初始化階段：當(dāng)ArkTS側(cè)在import一個(gè)Native模塊時(shí)，ArkTS引擎會(huì)調(diào)用ModuleManager加載模塊對(duì)應(yīng)的so及其依賴促王。首次加載時(shí)會(huì)觸發(fā)模塊的注冊(cè)犀盟，將模塊定義的方法屬性掛載到exports對(duì)象上并返回該對(duì)象。
調(diào)用階段：當(dāng)ArkTS側(cè)通過(guò)上述import返回的對(duì)象調(diào)用方法時(shí)蝇狼，ArkTS引擎會(huì)找到并調(diào)用對(duì)應(yīng)的C/C++方法且蓬。
寫(xiě)在最后
- 如果你覺(jué)得這篇內(nèi)容對(duì)你還蠻有幫助，我想邀請(qǐng)你幫我三個(gè)小忙：
- 點(diǎn)贊题翰，轉(zhuǎn)發(fā)恶阴，有你們的 『點(diǎn)贊和評(píng)論』，才是我創(chuàng)造的動(dòng)力豹障。
- 關(guān)注小編冯事，同時(shí)可以期待后續(xù)文章ing??，不定期分享原創(chuàng)知識(shí)血公。
- 想要獲取更多完整鴻蒙最新學(xué)習(xí)知識(shí)點(diǎn)昵仅，請(qǐng)移步前往小編：
https://gitee.com/MNxiaona/733GH/blob/master/jianshu
