開源項目 OpenHarmony是每個人的 OpenHarmony

劉麗紅
OpenHarmony知識體系工作組
簡介
本篇主要介紹如何使用DevEco Studio for OpenAtom OpenHarmony (以下簡稱“OpenHarmony”)創建一個Native C++應用。應用采用“Native C++”模板,實現了通過Node-API調用C標準庫的功能。本示例通過調用C標準庫接口來演示調用過程,具體接口是C標準庫的計算兩個給定數和,并將結果返回到頁面展示。通過這個應用我們可以掌握OpenHarmony系統的arkTS/JS與C/C++混合開發。arkTS/JS與C/C++ 混合開發是OpenHarmony系統中的一套原生模塊擴展開發框架,它基于Node.js N-API規范開發,為開發者提供了arkTS/JS與C/C++模塊之間相互調用的交互能力。這套機制對于OpenHarmony系統開發的價值有兩方面: 1、OpenHarmony系統可以將框架層豐富的模塊功能通過js接口開放給上層應用使用。 2、應用開發者也可以選擇將一些對性能、底層系統調用有要求的核心功能用C/C++封裝實現,再通過js接口使用,提高應用本身的執行效率。效果圖
實現效果如下圖所示:
環境搭建
我們首先要完成應用開發環境的搭建,本示例運行RK3568開發板上。 1、搭建應用開發環境 1.1、開始前請參考應用開發快速上手鏈接,完成DevEco Studio的安裝和開發環境配置:參考鏈接 1.2、開發環境配置完成后,創建工程(模板選擇“Native C++”),選擇JS或者eTS語言開發。


源碼結構
代碼結構分析,整個工程的代碼結構如下:
├── cpp:// C++代碼區
│ ├── types:// 接口存放文件夾
│ │ └── libadd
│ │ ├── index.d.ts // 接口文件
│ │ └── package.json // 接口注冊配置文件
│ ├── CmakeList.text // Cmake打包配置文件
│ └── add.cpp // C++源代碼
└── ets // ets代碼區
└── Application
│ └── AbilityStage.ts // Hap包運行時類
├── MainAbility
│ └── MainAbility.ts //對Ability生命周期管理
└── pages
└──index.ets//主頁面
C++端方法實現
C++端方法源碼是工程的entry/src/main/cpp/add.cpp文件。 1、注冊模塊 先定義一個模塊,對應結構體為napi_module,模塊定義好后,調用NAPI提供的模塊注冊函數napi_module_register(napi_module* mod)注冊到系統中;參考如下示例,nm_modname可以根據實際情況修改。
static napi_module demoModule = {
.nm_version =1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = Init,
.nm_modname = "libadd",
.nm_priv = ((void*)0),
.reserved = { 0 },
};
extern "C" __attribute__((constructor)) void RegisterHelloModule(void)
{
napi_module_register(&demoModule);
}
2、接口定義
接口定義是固定寫法,在napi_property_descriptor desc[]中,我們需要將編寫的“hyPotC”方法(從左至右第三個參數)與對應暴露的接口“hyPot”接口(從左至右第一個參數)進行關聯,其他參考示例默認填寫即可。如下所示,其中Add對應的是Native C++的接口,其應用端的接口對應為add,NAPI通過napi_define_properties接口將napi_property_descriptor結構體中的2個接口綁定在一起,并通過exports變量對外導出,使應用層可以調用add方法。
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
napi_property_descriptor desc[] = {
{ "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr }
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END
3、接口實現
static napi_value Add(napi_env env, napi_callback_info info)
{
size_t requireArgc = 2;
size_t argc = 2;
napi_value args[2] = {nullptr};
napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
napi_valuetype valuetype0;
napi_typeof(env, args[0], &valuetype0);
napi_valuetype valuetype1;
napi_typeof(env, args[1], &valuetype1);
double value0;
napi_get_value_double(env, args[0], &value0);
double value1;
napi_get_value_double(env, args[1], &value1);
napi_value sum;
napi_create_double(env, value0 + value1, &sum);
return sum;
}
4、接口對外配置
4.1、修改index.d.ts用于對外提供方法、說明(名字可以更改,點擊方法可以直接鏈接到index.d.ts)。
export const add: (a: number, b: number) => number;
4.2、在package.json文件中將index.d.ts與cpp文件關聯起來。
{
"name": "libadd.so",
"types": "./index.d.ts"
}
4.3、CMakeLists.txt配置CMake打包參數,CMakeLists.txt是CMake打包的配置文件,里面的大部分內容無需修改,project、add_library方法中的內容可以根據實際情況修改。
# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(MyApplication)
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})
include_directories(${NATIVERENDER_ROOT_PATH}
${NATIVERENDER_ROOT_PATH}/include)
add_library(add SHARED add.cpp)
target_link_libraries(addPUBLIClibace_napi.z.so)
arkTs端實現
界面整體規劃效果如下圖所示:
struct Index {
...
build() {
Row() {
Column() {
}
.width('100%')
}
.height('100%')
}
}
arkTs調用C++方法流程
在arkTs調用C++流程的過程中,需要使用到Node_API、Cmake等工具來做中間轉換,整個流程如下:
import libAdd from 'libadd.so'
2、添加點擊事件
Button組件添加點擊事件,調用libadd.so中的方法。
Button(this.buttonSubmit)
.fontSize(40)
.fontWeight(FontWeight.Bold)
.margin({top:5})
.height(100)
.width(200)
.onClick(() => {
this.result = libAdd.add(this.num1,this.num2)
})
3、hivgor打包
hivgor打包將SO文件與eTS代碼一起打包成hap包。
4、安裝hap包
點擊"
總結
通過本篇介紹,我們了解了C++代碼如何與arkTs實現關聯,arkTs如何調用SO包中的接口等,同時也掌握了C++代碼的具體編寫與打包流程。參考鏈接
DevEco Studio安裝和開發環境配置https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87
源碼路徑https://gitee.com/openharmony-sig/knowledge/tree/knowledge/typical_demo/NativeApp
NAPI課程學習路徑https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/napi%E7%B3%BB%E5%88%97%E5%AD%A6%E4%B9%A0
原文標題:如何使用DevEco Studio創建Native C++應用
文章出處:【微信公眾號:OpenAtom OpenHarmony】歡迎添加關注!文章轉載請注明出處。
-
鴻蒙
+關注
關注
59文章
2491瀏覽量
43716 -
OpenHarmony
+關注
關注
26文章
3812瀏覽量
18046
原文標題:如何使用DevEco Studio創建Native C++應用
文章出處:【微信號:gh_e4f28cfa3159,微信公眾號:OpenAtom OpenHarmony】歡迎添加關注!文章轉載請注明出處。
發布評論請先 登錄
最新 HUAWEI DevEco Studio 使用技巧

DevEco Studio 工具如何安裝
最新 HUAWEI DevEco Studio 調試技巧
鴻蒙北向開發OpenHarmony5.0 DevEco Studio開發工具安裝與配置

【貝啟科技BQ3568HM開源鴻蒙開發板深度試用報告】使用Deveco Studio進行開發
DevEco Studio 聯合小藝接入 DeepSeek,步驟更簡單開發鴻蒙更專業
HarmonyOS NEXT開發實戰:DevEco Studio中DeepSeek的使用
如何在DevEco Studio中利用CodeGPT接入DeepSeek

Spire.XLS for C++組件說明

戈帥的《HarmonyOS從入門到精通40例》DevEco Studio升級說明
DevEco Studio應用與服務體檢工具介紹

評論