随着 OpenHarmony 生态的快速发展，越来越多的开发者需要在 ArkTS 应用中调用 C/C++ 代码来实现高性能或访问系统底层功能。本文将通过一个完整的 LED 控制实例，深入讲解如何在 DevEco Studio 中进行 NAPI（Native API）开发，从项目架构设计到代码实现，从编译构建到调试优化，一应俱全。
🎯 引言：为什么选择 NAPI 架构
在 OpenHarmony 应用开发中，当遇到以下场景时，NAPI 是不可避免的选择：
- 性能优化：需要高频计算或大量数据处理
- 硬件访问：操作 GPIO、串口等硬件设备
- 系统 API：调用 Linux 底层 API 或第三方 C/C++ 库
- 代码复用：移植现有的 C/C++ 代码库
NAPI（Native API） 是 OpenHarmony 提供的用于在 ArkTS 和 Native 代码之间建立桥梁的接口规范，它允许：
- ✅ 从 ArkTS 调用 C/C++ 函数
- ✅ 在 C/C++ 中访问 ArkTS 对象
- ✅ 实现异步操作和回调
- ✅ 高效的数据类型转换
🚀 HAP 调用框架层的方式总览
在 OpenHarmony 中，HAP 应用有多种方式可以调用到框架层，每种方式都有其特定的使用场景和优势。
调用方式架构图
┌─────────────────────────────────────────────────────────┐
│ HAP 应用层 │
│ (ArkTS/ETS 代码) │
└──────┬──────────┬──────────┬──────────┬──────────┬──────┘
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│@kit │ │@ohos │ │NAPI │ │Ability│ │IPC │
│API │ │模块 │ │Native│ │机制 │ │服务 │
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘
│ │ │ │
└──────────┴──────────┴──────────┴──────────┘
▼
┌──────────────────────┐
│ OpenHarmony 框架层 │
│ (系统服务、能力框架) │
└──────────────────────┘
方式一：@kit API Kit（最常用）
说明： OpenHarmony 提供的标准化 API Kit，是应用开发的主要方式。
特点：
- ✅ 类型安全，完整的 TypeScript 类型定义
- ✅ 官方维护，稳定可靠
- ✅ 功能丰富，覆盖大部分应用场景
- ✅ 文档完善，易于使用
常用 Kit 列表：
| Kit 名称 | 导入路径 | 主要功能 |
|---|---|---|
| AbilityKit | @kit.AbilityKit | 应用生命周期、上下文管理 |
| ArkUI |
