• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# scan工具
2
3## 简介
4
5scan工具可以扫描三方库中包含OpenHarmony源码不包含的接口,并输出result.xlsx文档。开发者移植三方库到OpenHarmony源码中,若三方库中包含一些OpenHarmony中不存在的接口,便会增加移植难度。此时可使用API扫描工具,提前预知风险接口,降低移植难度,提高开发效率。
6
7## 约束
8系统:建议Ubuntu 20.04或者Windows 10
9
10依赖版本:VS Code 1.62.0
11
12## 使用方法
13
141.下载Andr_N_Games_api.xlsx文件,下载链接如下:
15
16https://gitee.com/openharmony/napi_generator/releases/download/napigen_resource/napi_resouce.zip
17
18下载之后解压,进入scan/depend目录下获取Andr_N_Games_api.xlsx文件,并放置在napi_generator/src/tool/api/src文件夹下。
19
202.安装typescript:在napi_generator/src/tool/api/src目录下执行命令:
21
22	npm i typescript
23
243.安装stdio:在napi_generator/src/tool/api/src目录下执行命令:
25
26	npm i stdio
27
284.根据使用者指定三方库项目源码,工具会输出风险接口。为了方便使用者快速上手工具,此处使用opencv项目为例,项目目录如下:
29
30![](./figures/opencv.png)
31
325.在napi_generator/src/tool/api/src下执行以下命令:
33
34```
35node scan.js -d E:\aboutTest\opencv-4.x\opencv-4.x -o E:\aboutTest\opencv-4.x\opencv-4.x
36```
37
38其中,参数详情如下:
39	-d, 被扫描项目的路径
40	-o, 可选参数,默认为当前路径下,输出结果存放路径。
41
426.在window环境下的,根据输入三方库项目,生成的输出文件result.xlsx,如下所示:
43
44![](./figures/opencv_result.png)
45
46其中生成的result.xlsx文件,风险接口如下所示:
47
48![](./figures/opencv_include.png)
49
50![](./figures/opencv_h.png)
51