napi_value napiResult;
// 给napi_ value 类型参数赋值，这个赋了一个double类型数值2.0
napi_create_double（env,2.0， &napiResult）；

// hello.cpp
// 首先看一下参数，env表示Node-API执行时的上下文，info里面存储了ArkTS侧传递过来的参数信息。
static napi_value MyHypot(napi_env env, napi_callback_info info)
{
    if ((nullptr == env) || (nullptr == info)) {
        OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "MyHypot", "env or exports is null");
        return nullptr;
    }

    // Number of parameters.
    // 案例是计算两个数的平方和的平方根，ArkTS侧需要传递两个参数到Native侧，所以这里需要接收两个参数，argc代表参数个数。
    size_t argc = PARAMETER_COUNT;

    // Declare parameter array.
    // args[]数组是用于存储ArkTS参数的参数数组，
    napi_value args[PARAMETER_COUNT] = { nullptr };

    // Gets the arguments passed in and puts them in the argument array.
    // 1、首先通过napi_get_cb_info函数，将info里面的参数信息获取到args[]数组中，
    if (napi_ok != napi_get_cb_info(env, info, &argc, args, nullptr, nullptr)) {
        OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "MyHypot", "api_get_cb_info failed");
        return nullptr;
    }

    // Converts arguments passed in to type double.
    // 2、然后定义两个double类型的参数valueX、valueY
    double valueX = 0.0;
    double valueY = 0.0;
    // 3、使用napi_get_value_double函数，将获取到args[]数组中的参数信息，转换成C++侧的double类型，并存储到valueX、valueY中。
    if (napi_ok != napi_get_value_double(env, args[0], &valueX) ||
        napi_ok != napi_get_value_double(env, args[1], &valueY)) {
        OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "MyHypot", "napi_get_value_double failed");
        return nullptr;
    }

    // The hypot method of the C standard library is called to perform the calculation.
    // 4、接着调用C标准库中的hypot()方法来执行计算。
    double result = hypot(valueX, valueY);

    napi_value napiResult;
    // 5、最终通过napi_create_double函数，将计算结果存储到napi_value类型的参数napiResult中，
    if (napi_ok != napi_create_double(env, result, &napiResult)) {
        OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "MyHypot", "napi_create_double failed");
        return nullptr;
    }
    // 6、最后通过return napiResult，将结果返回到ArkTS侧使用。
    return napiResult;
}

EXTERN_C_START
// 针对本案例就是Init方法
static napi_value Init(napi_env env, napi_value exports)
{
    if ((nullptr == env) || (nullptr == exports)) {
        OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "Init", "env or exports is null");
        return exports;
    }

    // 当前只定义了一个方法myHypot，这里其实是做了一个绑定，
    napi_property_descriptor desc[] = {
        // 第一个参数："myHypot"是在ArkTS侧暴露的接口名，是小写myHypot，基于命名规范命名。
        // 第三个参数是在C++侧对应的方法，是大写MyHypot，基于命名规范命名。
        //本案例中只定义了一个myHypot方法，实际开发时可以在这里定义更多的方法映射，以便在ArkTS侧可以调用更多的C++侧方法。
        { "myHypot", nullptr, MyHypot, nullptr, nullptr, nullptr, napi_default, nullptr }
    };
    if (napi_ok != napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc)) {
        OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "Init", "napi_define_properties failed");
        return nullptr;
    }
    return exports;
}
EXTERN_C_END

static napi_module demoModule = {
    .nm_version = 1, // 版本
    .nm_flags = 0,
    .nm_filename = nullptr,
    // 重要，里面定义了模块初始化函数，这里定义的初始化函数就是上方的Init函数，初始化时会进行接口映射。
    .nm_register_func = Init, 
    // 重要，里面定义模块的名称，也就是ArkTS侧引入的so库的名称。模块系统会根据此名称来区分不同的so.
    // 例如此处定义的模块名称为hello。
    // 相对应需要导入的so库名称将会是libhello.so
    .nm_modname = "hello", 
    .nm_priv = ((void *)0),
    .reserved = { 0 }
};

extern "C" __attribute__((constructor)) void RegisterModule(void)
{
    // 在调用napi_module_register方法时，会传入一个demoModule对象，就是上面定义的demoModule结构体
    napi_module_register(&demoModule);
}

# the minimum version of CMake.
# CMake最低版本
cmake_minimum_required(VERSION 3.4.1)
# project名称
project(NativeTemplateDemo)

# 就是把后面这个变量的值赋值给前面，就相当于起了个别名。
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})

# 需要放整个项目编译所用到的头文件目录。一般用默认配置即可。
# 会配置整个cpp目录和cpp下的include目录。
include_directories(
    ${NATIVERENDER_ROOT_PATH}
    ${NATIVERENDER_ROOT_PATH}/include
)

# find_library是查找hilog_ndk.z库的位置。会将其信息存储到变量hilog-lib中。以便后续添加依赖模块时使用。
# hilog-lib命令适用于开发者不清楚需要的依赖库的具体路径时
find_library(
    # Sets the name of the path variable.
    hilog-lib
    # Specifies the name of the NDK library that
    # you want CMake to locate.
    hilog_ndk.z
)

# add_library命令，构建编译产物。
# 第一个参数是编译的模块名称，这里写了hello,最后编译出来的就叫做libhello.so。
# 第二个参数SHARED表示是动态库。
# 第三个参数需要配置参与编译的所有cpp文件。
# 也支持编译静态库，如果把SHARED改成STSTIC, 编译出来的就是静态库文件。
add_library(hello SHARED hello.cpp)

# target_link_libraries定义开发者需要编译当前模块需要依赖哪些模块。
# 比如当前案例需要依赖NAPI的能力和一些底层C++能力。就需要制定NAPI的库和libc++的库。
target_link_libraries(hello PUBLIC ${hilog-lib} libace_napi.z.so libc++.a)

// index.d.ts
// 标准的TS接口定义文件，定义C/C++侧暴露给ArkTS侧的接口，并将其导出。
// 本案例定义了一个myHypot方法，即上文中映射到ArkTS侧的方法。
// 该方法需要传递两个number类型的参数，并且最终会返回一个number类型的数据。
export const myHypot: (a: number, b: number) => number;

import libHello from 'libhello.so';

// entry/src/main/ets/pages/Index.ets
// 通过import的方式，引入Native能力。
import nativeModule from 'libentry.so'

@Entry
@Component
struct Index {
  @State message: string = 'Test Node-API callNative result: ';
  @State message2: string = 'Test Node-API nativeCallArkTS result: ';
  build() {
    Row() {
      Column() {
        // 第一个按钮，调用add方法，对应到Native侧的CallNative方法，进行两数相加。
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.message += nativeModule.callNative(2, 3);
            })
        // 第二个按钮，调用nativeCallArkTS方法，对应到Native的NativeCallArkTS，在Native调用ArkTS function。
        Text(this.message2)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.message2 += nativeModule.nativeCallArkTS((a: number)=> {
                return a * 2;
            });
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}