鸿蒙开发接口公共事件与通知：【FFI能力】 N-API在Android、iOS平台应用的使用指导

N-API在Android平台应用的使用指导

N-API接口可以实现ArkTS/TS/JS与C/C++(Native)之间的交互，ArkUI-X中支持的N-API接口情况和使用场景请见[FFI能力(N-API)]。本文档以[ArkUI-X/Samples]中的Native样例工程为例，介绍如何在Android平台上使用N-API能力完成跨语言调用。

开发流程

使用N-API完成跨语言调用的整体开发流程分为以下五步，即

1. 环境准备：获取Native工程。
2. 提供Native能力：使用N-API接口提供Native能力，同时，Native接口中还可调用ArkTS/TS/JS传入的方法。
3. 定义接口声明：添加Native侧暴露给ArkTS侧接口的声明。
4. 调用Native能力：ArkTS/TS/JS侧使用Native能力。
5. 编译与运行应用：编出应用，并在android平台上运行，观察效果。
6. 开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

这里通过修改样例工程，提供两个例子来介绍N-API的典型使用场景：

1. 提供一个名为Add的Native方法，ArkTS侧调用该方法并传入两个number，Native方法将这两个number相加并返回到ArkTS侧。以此介绍：ArkTS侧如何调用到Native侧方法。
2. 提供一个名为NativeCallArkTS的Native方法，ArkTS侧调用该方法并传入一个ArkTS function，Native方法中调用这个ArkTS function，并将其结果返回ArkTS侧。以此介绍：Native侧如何调用到ArkTS侧方法。

1. 环境准备

从[ArkUI-X/Samples]中获取Native样例工程，并使用DevEco Studio(V4.0 Beta2及以上版本)打开该工程，打开后将自动进行工程初始化。

2. 提供Native能力

利用N-API接口，进行Native能力开发。同时，本样例中的NativeCallArkTS也完成了Native侧调ArkTS侧的演示。

// entry\src\main\cpp\hello.cpp，包含Native侧逻辑。
// 引入N-API相关头文件。
#include "napi/native_api.h"

// 开发者提供的Native方法，入参有且仅有如下两个，开发者不需进行变更。
// napi_env 为当前运行的上下文。
// napi_callback_info 记录了一些信息，包括从ArkTS侧传递过来参数等。
static napi_value Add(napi_env env, napi_callback_info info)
{
    // 期望从ArkTS侧获取的参数的数量，napi_value可理解为ArkTS value在Native方法中的表现形式。
    size_t argc = 2;
    napi_value args[2] = {nullptr};
    
    // 从info中，拿到从ArkTS侧传递过来的参数，此处获取了两个ArkTS参数，即arg[0]和arg[1]。
    napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);