native_interface.h

概述

提供NativeModule接口的统一入口函数，用于初始化C-API环境、获取指定类型的Native模块接口集合，以及获取最新一次的报错信息。

引用文件： <arkui/native_interface.h>

库： libace_ndk.z.so

系统能力： SystemCapability.ArkUI.ArkUI.Full

起始版本： 12

相关模块： ArkUI_NativeModule

相关示例： NativeNodeInterfaceSample

汇总

枚举

函数

宏定义

枚举类型说明

ArkUI_NativeAPIVariantKind

enum ArkUI_NativeAPIVariantKind

描述：

定义Native接口集合类型。

起始版本： 12

函数说明

OH_ArkUI_QueryModuleInterfaceByName()

void* OH_ArkUI_QueryModuleInterfaceByName(ArkUI_NativeAPIVariantKind type, const char* structName)

描述：

需调用该函数初始化C-API环境，并获取指定类型的Native模块接口集合。

起始版本： 12

参数：

返回：

OH_ArkUI_GetModuleInterface()

#define OH_ArkUI_GetModuleInterface(nativeAPIVariantKind, structType, structPtr)                     \
do {                                                                                                 \
        void* anyNativeAPI = OH_ArkUI_QueryModuleInterfaceByName(nativeAPIVariantKind, #structType); \
        if (anyNativeAPI) {                                                                          \
            structPtr = (structType*)(anyNativeAPI);                                                 \
        }                                                                                            \
    } while (0)

描述：

初始化C-API环境，并基于结构体类型获取对应结构体指针。

适用于已确定Native接口集合类型和接口结构体类型，需要获取具体Native接口结构体指针以调用ArkUI Native C API的场景。此宏函数接收ArkUI_NativeAPIVariantKind类型枚举参数nativeAPIVariantKind、结构体类型参数structType、结构体指针变量structPtr；structPtr需与structType类型匹配。该宏调用OH_ArkUI_QueryModuleInterfaceByName初始化C-API环境并获取Native接口抽象指针，转换为structType*类型后赋值给structPtr。

起始版本： 12

OH_ArkUI_NativeModule_GetErrorMessage()

const char* OH_ArkUI_NativeModule_GetErrorMessage()

描述：

获取最新一次的报错信息，包括错误码、方法名称和错误原因。错误码相关信息请参考ArkUI_ErrorCode。当其他接口返回错误码时，会保存对应的报错信息，通过此接口可获取当前存储的报错信息。返回的字符串是由系统创建的线程局部全局字符串，不得修改其内容。如需任何编辑，请自行创建字符串内容的副本。该接口返回的信息可能随版本演进而变化，仅用于输出以辅助分析与故障排查，不应作为逻辑判断依据。返回的报错信息无需手动释放。

起始版本： 26.0.0

返回：