napi_generator/README.md
xuxiaoyuan94 3d93f4ec38 fix codecheck
Signed-off-by: xuxiaoyuan94 <xuxiaoyuan072@chinasoftinc.com>
2024-07-23 15:06:54 +08:00

4.4 KiB
Raw Blame History

简介

napi-generator初始目标为提供基于OpenHarmony标准系统,推出一些提升开发效率的NAPI框架代码生成工具。工作范围

  1. 针对开发人员、主流操作系统的IDE平台提供NAPI框架代码生成工具
  2. 提供使用范例
  3. 提供持续的改进优化

工作目标

工作目标 完成情况 备注
NAPI生成工具 V1.4.1版 可进行小规模的自动生成基本功能集可通过简单dts或h文件生成对应代码
TS生成工具h2dts V1.0.0版 提供命令行和VSCode及Ideal插件基本功能集可将简单的h文件转换为dts文件
Gn生成工具cmake2gn V1.0.0版 基本功能集在具备cmake编译的环境下能实现gn文件的自动生成但是有多工程引用及其他辅助情况可能存在问题
Service生成工具h2sa V1.0.0版 基本功能集通过h文件生成sa服务框架代码包括Ability注册、proxy/stub类实现、MessageParcel数据包构造、Service子系统编译及服务配置文件
API平台依赖分析扫描工具 V1.0.0版 扫描三方库中包含OpenHarmony源码不包含的接口并输出result.xlsx文档
HCS可视化工具 V1.0.0版 详情参看drivers_hdf_core/framework/tools/hcs-view
IDL生成工具 V1.0.0版 详情参看drivers_hdf_core/framework/tools/idl-gen
提供使用范例 详情参看本仓example下的内容

技术地图

架构图

具体模块说明

  • dts2cpp工具可以根据用户指定路径下的ts(typescript)接口文件一键生成NAPI框架代码、业务代码框架、GN文件等。

    readme

    版本说明

  • h2dts工具可以根据定义在c++头文件中的接口生成type-script语言的ts接口文件。

    readme

    版本说明

  • cmake2gn工具可以根据三方库的CMakeLists.txt文件编译转换生成BUILD.gn脚本文件。

    readme

    版本说明

  • h2sa工具可以根据一个定义远程方法的.h头文件生成整个Service框架的代码包含Ability注册、proxy/stub类实现、MessageParcel数据包构造、Service子系统编译及开机自启动相关配置文件。

    readme

    版本说明

  • h2dtscpp工具可以根据定义在c++头文件中的接口生成type-script语言的ts接口文件、NAPI框架代码、和自动化测试用例代码。

    readme

  • scan工具它可以扫描三方库中包含OpenHarmony源码不包含的接口并输出result.xlsx文档。

    readme

相关仓

napi safwk samgr hdf hidumper hilog hisysevent