開源項目 OpenHarmony是每個人的 OpenHarmony

劉麗紅

OpenHarmony知識體系工作組

簡介

本篇主要介紹如何使用DevEco Studio for OpenAtom OpenHarmony （以下簡稱“OpenHarmony”）創(chuàng)建一個Native C++應(yīng)用。應(yīng)用采用“Native C++”模板，實現(xiàn)了通過Node-API調(diào)用C標準庫的功能。本示例通過調(diào)用C標準庫接口來演示調(diào)用過程，具體接口是C標準庫的計算兩個給定數(shù)和，并將結(jié)果返回到頁面展示。通過這個應(yīng)用我們可以掌握OpenHarmony系統(tǒng)的arkTS/JS與C/C++混合開發(fā)。arkTS/JS與C/C++ 混合開發(fā)是OpenHarmony系統(tǒng)中的一套原生模塊擴展開發(fā)框架，它基于Node.js N-API規(guī)范開發(fā)，為開發(fā)者提供了arkTS/JS與C/C++模塊之間相互調(diào)用的交互能力。這套機制對于OpenHarmony系統(tǒng)開發(fā)的價值有兩方面： 1、OpenHarmony系統(tǒng)可以將框架層豐富的模塊功能通過js接口開放給上層應(yīng)用使用。 2、應(yīng)用開發(fā)者也可以選擇將一些對性能、底層系統(tǒng)調(diào)用有要求的核心功能用C/C++封裝實現(xiàn)，再通過js接口使用，提高應(yīng)用本身的執(zhí)行效率。

效果圖

實現(xiàn)效果如下圖所示： ? 通過arkTs編寫界面，根據(jù)界面展示點擊輸入框輸入兩個數(shù)，再點擊計算按鈕調(diào)用接口，將數(shù)據(jù)傳入到C++端，C++端計算后再作為返回值到arkTs端。 ?

環(huán)境搭建

我們首先要完成應(yīng)用開發(fā)環(huán)境的搭建，本示例運行RK3568開發(fā)板上。 1、搭建應(yīng)用開發(fā)環(huán)境 1.1、開始前請參考應(yīng)用開發(fā)快速上手鏈接，完成DevEco Studio的安裝和開發(fā)環(huán)境配置：參考鏈接 1.2、開發(fā)環(huán)境配置完成后，創(chuàng)建工程（模板選擇“Native C++”），選擇JS或者eTS語言開發(fā)。 ? 2、應(yīng)用調(diào)測 工程創(chuàng)建完成后，選擇使用真機進行調(diào)測。 2.1、將搭載OpenHarmony標準系統(tǒng)的開發(fā)板與電腦連接。 2.2、點擊File> Project Structure... > Project>SigningConfigs界面勾選“Automatically generate signature”，等待自動簽名完成即可，最后點擊“OK”。如下圖所示： ? 在編輯窗口右上角的工具欄，點擊""按鈕運行。

源碼結(jié)構(gòu)

代碼結(jié)構(gòu)分析，整個工程的代碼結(jié)構(gòu)如下： ? 文件說明如下：

├── cpp：// C++代碼區(qū)
│   ├── types：// 接口存放文件夾
│   │   └── libadd              
│   │       ├── index.d.ts       // 接口文件
│   │       └── package.json // 接口注冊配置文件
│   ├── CmakeList.text     // Cmake打包配置文件
│   └── add.cpp                // C++源代碼
└── ets                               // ets代碼區(qū)
    └── Application
    │   └── AbilityStage.ts  // Hap包運行時類
    ├── MainAbility
    │   └── MainAbility.ts   //對Ability生命周期管理
    └── pages
└──index.ets//主頁面

C++端方法實現(xiàn)

C++端方法源碼是工程的entry/src/main/cpp/add.cpp文件。 1、注冊模塊 先定義一個模塊，對應(yīng)結(jié)構(gòu)體為napi_module，模塊定義好后，調(diào)用NAPI提供的模塊注冊函數(shù)napi_module_register(napi_module* mod)注冊到系統(tǒng)中；參考如下示例，nm_modname可以根據(jù)實際情況修改。

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”方法（從左至右第三個參數(shù)）與對應(yīng)暴露的接口“hyPot”接口（從左至右第一個參數(shù)）進行關(guān)聯(lián)，其他參考示例默認填寫即可。如下所示，其中Add對應(yīng)的是Native C++的接口，其應(yīng)用端的接口對應(yīng)為add，NAPI通過napi_define_properties接口將napi_property_descriptor結(jié)構(gòu)體中的2個接口綁定在一起，并通過exports變量對外導出，使應(yīng)用層可以調(diào)用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、接口實現(xiàn)

#include "napi/native_api.h"
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文件關(guān)聯(lián)起來。

{
  "name": "libadd.so",
  "types": "./index.d.ts"
}

4.3、CMakeLists.txt配置CMake打包參數(shù)，CMakeLists.txt是CMake打包的配置文件，里面的大部分內(nèi)容無需修改，project、add_library方法中的內(nèi)容可以根據(jù)實際情況修改。

# 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端實現(xiàn)

界面整體規(guī)劃效果如下圖所示： ? 界面實現(xiàn)部分代碼，具體請查看源碼（見參考鏈接源碼路徑）。

@Entry
@Component
struct Index {
  ...
  build() {
    Row() {
      Column() {
      }
      .width('100%')
    }
    .height('100%')
  }
}

arkTs調(diào)用C++方法流程

在arkTs調(diào)用C++流程的過程中，需要使用到Node_API、Cmake等工具來做中間轉(zhuǎn)換，整個流程如下： ? (1)add.cpp源碼用來編寫C++代碼，并通過index.d.ts文件對外提供接口。 (2)C++代碼通過Cmake打包工具打包成動態(tài)鏈接庫SO文件。 (3)arkTs端index.ets源碼通過引入SO包的方式去調(diào)用SO文件中的接口，最終通過hivgor一起打包成可執(zhí)行的xxx.hap包。 1、導入SO包 在index.ets文件中引入編譯好的SO包。

import libAdd from 'libadd.so'

2、添加點擊事件 Button組件添加點擊事件，調(diào)用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包 點擊""按鈕安裝hap包運行。

總結(jié)

通過本篇介紹，我們了解了C++代碼如何與arkTs實現(xiàn)關(guān)聯(lián)，arkTs如何調(diào)用SO包中的接口等，同時也掌握了C++代碼的具體編寫與打包流程。

參考鏈接

DevEco Studio安裝和開發(fā)環(huán)境配置

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