awtk/tools/idl_gen

AWTK IDL 生成工具

在 AWTK 中，对外的 API 都按 规定格式 编写注释，通过 IDL gen 工具把这些注释提取成 JSON 文件，这个 JSON 文件可以用来生成文档、各种语言的绑定和 web 版本对外的 API。

一、准备工作

（如果已经安装请跳过）

• 安装 nodejs

二、生成 IDL 文件

• 1. 基本用法

node index.js  [outputIDL] [sourcesPath] [defDirList]

• outputIDL 输出的 IDL 文件名。

• sourcesPath 源代码的路径。

• defDirList 导出 IDL 的源码依赖路径，如果没有依赖可以缺省，如果多个依赖路径需要通过分号隔开，如 "../awtk;../awtk-mvvm;"。

• 2. 生成 AWTK 的 IDL 文件。

node index.js

• 3. 生成外部项目的 IDL 文件。

生成外部项目的 IDL 文件时，需要指定输出的 IDL 文件名和源代码的路径以及缺省设置导出 IDL 的源码依赖路径。如：

node index.js  slider_circle.idl ../../../awtk_slider_circle/src "../../awtk;"

三、合并多个 IDL 文件

生成各种语言绑定时，需要把 AWTK 本身的 IDL、自定义控件的 IDL、和其它类的 IDL 合并到一个 IDL 文件中，这时可以使用 merge.js 工具。

基本用法：

node merge.js [多个 IDL 文件（被依赖的放在前面）]

如：

node merge.js idl.json test.json