mirror of
https://gitee.com/Vancouver2017/luban-lite-t3e-pro.git
synced 2025-12-16 19:38:56 +00:00
52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
|
# AWTK IDL 生成工具
|
||
|
|
|
||
|
|
在 AWTK 中，对外的 API 都按 [规定格式](https://github.com/zlgopen/awtk/blob/master/docs/api_doc.md) 编写注释，通过 IDL gen 工具把这些注释提取成 JSON 文件，这个 JSON 文件可以用来生成文档、各种语言的绑定和 web 版本对外的 API。
|
||
|
|
|
||
|
|
## 一、准备工作
|
||
|
|
|
||
|
|
（如果已经安装请跳过）
|
||
|
|
|
||
|
|
* 安装 [nodejs](https://nodejs.org/zh-cn/)
|
||
|
|
|
||
|
|
## 二、生成 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
|
||
|
|
```
|