開源項目 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接口使用，提高應用本身的執行效率。

效果圖

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

環境搭建

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

源碼結構

代碼結構分析，整個工程的代碼結構如下： ? 文件說明如下：

├── 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、接口實現

#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文件關聯起來。

{
  "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端實現

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

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

arkTs調用C++方法流程

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

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包 點擊""按鈕安裝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