该技能用于在 React Native ExecuTorch 中添加自定义的 C++ 原生扩展,并通过 React Native JSI 将原生函数暴露给 TypeScript 调用。
用途:为性能关键的原生操作编写 C++ 实现,注册到 JSI 模块中,并在 TypeScript 层提供封装。
主要能力:
- 架构准则:先按 Amdahl 定律评估该步骤是否值得用 C++,若占总推理时间不足 5% 建议用纯 TypeScript。
- 内存管理约定:允许在 C++ 中分配临时本地内存;稠密输出必须由调用方在 TypeScript 中预分配目标张量并作为参数传入;变长非稠密输出(如 NMS 的索引)返回基本类型组成的 jsi::Array。
- 反模式约束:不得从 C++ 返回隐式分配的 JSI Tensor;不得在 C++ 定义默认参数;不得允许输入输出共享同一实例;不得抛出裸的 jsi::JSError、std::runtime_error 或 std::invalid_argument,应使用 error::X(message) 并通过 error::guarded(...) 注册。
- 实现步骤:在 cpp/extensions/<domain>/ 下创建头文件与源文件;使用 tensor::fromJs 校验并提取张量、conversions::asType<T> 转换基本参数、tensor::checkNotSameTensor 防止别名、tensor::tryLockShared/tryLockUnique 加锁;在扩展 install 函数和 cpp/RnExecutorch.cpp 中注册;编写 TypeScript 封装,使用 src/native/bridge.ts 导出的 rnexecutorchJsi 符号,默认值在 TS 层定义,并标记 "worklet";。
- 代码位置约定:领域通用操作放在 src/extensions/<domain>/ops.ts;模型/任务特定操作放在 src/extensions/<domain>/utils/<name>.ts。
- 验证清单:检查是否仅在必要处用 C++、是否避免隐式分配 JSI Tensor、是否完成类型/形状校验、是否防止原地修改、是否加锁、是否无 C++ 默认参数、是否统一错误工厂与 guarded 注册、是否正确注册两处、TypeScript 封装位置与 worklet 标记是否正确。
适用场景:需要为 React Native ExecuTorch 增加高性能原生算子、编写 JSI 宿主函数、在 C++ 安装映射中注册函数或编译原生代码时。
限制:资料未提供具体收费、平台支持范围、编译命令或依赖安装步骤,这些信息暂未提供。使用前应确认项目结构与命名空间符合文档约定。