NAPI篇【2】——OpenHarmony含NAPI工程cpp详解

        NAPI篇【1】中，讲解如何创建一个支持NAPI的OpenHarmony工程，其中有一个步骤是在OpenHarmony工程添加Harmony的NAPI工程中的cpp文件夹。cpp文件夹包含支持NAPI所需要的c/c++源码、接口导出文件以及编译文件等。本文将进行详解其中各文件的作用，帮助熟悉NAPI的开发。

        本文基于笔者的开发经验和网上参考资料汇集而成，笔者也处于学习阶段，如有错误，欢迎指正。

一、cpp文件夹——基础文件

        1、cpp文件夹基本内容

        通过NAPI模板新建工程，cpp文件夹内容全展开，如下图所示。

        2、cpp的一级目录文件

         如下图所示，cpp的一级目录下有hello.cpp、CMakeLists.txt 和一个二级目录types。

        （1）CMakeLists.txt 文件

        CMakeLists.txt是cmake用来生成Makefile文件的一个描述编译链接的脚本文件。该文件的基本内容行注释如下所示：

#CMake的最低版本要求
#默认即可
cmake_minimum_required(VERSION 3.4.1)    
 
# 用函数project(demo)指定的项目名称，可自行设置，这里变量的值为“napi”
project(napi)           

#设置环境变量，设置库文件的输出地址。
#CMAKE_CURRENT_SOURCE_DIR：当前处理的CMakeLists.txt文件所在目录
#默认即可
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})


#给工程添加头文件，会为当前CMakeLists.txt的所有目标，
#以及之后添加的所有子目录的目标添加指定头文件搜索路径。
#默认即可
include_directories(${NATIVERENDER_ROOT_PATH}
                    ${NATIVERENDER_ROOT_PATH}/include)

add_library(entry SHARED hello.cpp)   
#将源文件hello.cpp生成动态库文件,若有多个cpp文件，需要在此添加，以便生成动态库文件
# 生成目标库文件libentry.so，entry表示最终的库名称，SHARED表示生成的是动态链接库，
#
#add_library(生成的库名称 STATIC/SHARED 源文件1.cpp 源文件2.cpp)
#将源文件生成 静态/动态 库文件 
#STSTIC 表示静态库最终会编入到可执行文件中
#SHARED(常见参数)表示动态库（又称共享库）方式
#

target_link_libraries(entry PUBLIC libace_napi.z.so)
# 把libentry.so链接到libace_napi.z.so上
#/
#target_link_libraries (库/可执行文件 library1 library2 ...)
#将目标文件（为库或者可执行文件）与库文件进行链接
#libace_napi.z.so库，默认即可
#/

        CMakeLists.txt 文件需要在 build-profile.json5 文件里做配置声明，代码如下所示，对应 NAPI篇【1】中的   二、2、（3）步。

{
  "apiType": 'stageMod