1# NAPI框架生成工具IntelliJ插件使用说明 2 3## 简介 4 5IntelliJ插件下载路径如下,选择napi_generator_outputs.zip中generator.jar下载。 6 7[下载链接](http://ftp.kaihongdigi.com:5000/fsdownload/mKjfCmPjk/generator_outputs_NAPI_0930) 8 9## IntelliJ插件使用方法 10 11### 依赖 12 13系统:不限 14 15开发工具:DevEco stdio 16 17### 使用指导 18 191.新建或打开项目工程,以下以新建项目工程为例。 20 21File->New->Create Project。 22 23 24 25Ability Template选择Empty Ability,单击Next。 26 27 28 29填写Project name、Save location,其他选项可不修改,单击Finish,新的工程就创建好了。 30 31 32 332.把需要转换的.d.ts文件放在DevEco stdio新建项目的src目录下,并且检查需要转换的d.ts文件中是否声明了import的d.ts文件,如果存在需要将import的d.ts文件也放入到待转换的d.ts文件相同的目录下。 34 35 36 373.安装插件,File->Settings->Plugins->Installed->Install Plugin from Disk...,选择下载的generator.jar,安装成功之后重启IDE。 38 39 40 41 42 434.选择.d.ts文件,右键选择 Generate Napi Frame选项,工具弹出Generate Napi Frame弹窗。接口文件文本框填写.d.ts文件路径;生成框架路径文本框填写转换后生成文件存放文件夹路径,此处为src下新增out文件夹,生成文件存放在out中;编译脚本路径默认填写不修改,点击ok。 44 45 46 47 48 495.执行结束后会在目录下生成对应的文件。 50 51 52 536.此外工具还支持指定路径下d.ts文件转换、同一目录下多个d.ts文件同时转换、多级模块d.ts文件转换、d.ts接口import多个文件等场景。 54 551)指定路径下.d.ts文件转换(可转换路径下所有.d.ts文件)。Generate Napi Frame窗口填写与生成文件如下图所示: 56 57 58 59 60 612)同一目录下多个.d.ts文件同时转换。项目中存在@ohos.napitest.d.ts和@ohos.power.d.ts两个文件,且声明了import的d.ts文件。Generate Napi Frame窗口填写与生成文件如下图所示: 62 63 64 65 66 673)将待转换的d.ts文件与被引用的d.ts文件放在同一目录下,basic.d.ts文件放在待转换的d.ts文件上一级目录下。Generate Napi Frame窗口中选中启用import功能,其他选项填写参考以上步骤,点击ok。Generate Napi Frame窗口填写与生成文件如下图所示: 68 69 70 71 72 73## 注意 74 75对于ts文件中的number类型,默认转为C++ uint32_t类型,修改框架生成目录中的napitest.h类型赋值,可实现number类型到C++指定数据类型的转换。 76 77 78 79## 集成测试 80NAPI框架代码生成后,系统框架开发者进行二次开发后,即可集成到OpenHarmony编译系统,生成对应的库文件,供应用开发者调用接口。工具集成测试的具体操作步骤可以左键单击以下链接了解: 81 82[工具集成测试](https://gitee.com/openharmony/napi_generator/blob/master/docs/INTEGRATION_TESTING_ZH.md) 83 84