NAPI 实现 ArkTS 与 C++ 间的复杂对象传递

在鸿蒙 6.0（API 21）开发中，通过 NAPI 实现 ArkTS 与 C++ 间的复杂对象传递，包括结构体和回调函数的跨语言交互。以下是完整实现方案，附详细代码和原理分析。

一、技术架构与核心挑战

技术栈： ArkTS 业务层 → NAPI 桥接层 → C++ 原生逻辑

核心挑战：

1. 结构体传递：ArkTS 对象 ↔ C++ 结构体双向转换
2. 回调函数：C++ 异步操作完成后触发 ArkTS 函数
3. 线程安全：确保跨线程调用不破坏 JS 运行时环境

二、案例实现：结构体与回调函数传递

场景描述

ArkTS 向 C++ 传递包含坐标信息的结构体 Point，C++ 计算两点距离后通过回调函数返回结果。

步骤 1：ArkTS 侧定义接口（index.d.ts）

// 定义结构体
export interface Point {
    x: number;
    y: number;
}

// 声明 NAPI 函数
export const calculateDistance: (
    p1: Point,
    p2: Point,
    callback: (result: number) => void
) => void;

步骤 2：C++ 侧实现结构体解析（distance.cpp）

#include <cmath>
#include <napi/native_api.h>

// 定义 C++ 结构体
struct NativePoint {
    double x;
    double y;
};

// 解析 ArkTS 对象为 C++ 结构体
NativePoint ParsePoint {
    NativePoint point;
    napi_value x_value, y_value;
    
    (env, obj, , &x_value);
    (env, obj, , &y_value);
    
    (env, x_value, &point.x);
    (env, y_value, &point.y);
     point;
}


{
     argc = ;
    napi_value args;
    (env, info, &argc, args, , );

    
    NativePoint p1 = (env, args[]);
    NativePoint p2 = (env, args[]);

    
     dx = px - px;
     dy = py - py;
     distance = (dx * dx + dy * dy);

    
    napi_value callback = args[];

    
    napi_value result;
    (env, distance, &result);

    
    napi_value global;
    (env, &global);
    (env, global, callback, , &result, );
     ;
}