README_zh.md · chenyude/arkcompiler_ets_frontend

# ets_frontend组件<a name="ZH-CN_TOPIC_0000001137330686"></a>

- [ets_frontend组件<a name="ZH-CN_TOPIC_0000001137330686"></a>](#ets_frontend组件)
 - [简介<a name="section11660541593"></a>](#简介)
 - [目录<a name="section161941989596"></a>](#目录)
 - [编译构建<a name="section0446154755015"></a>](#编译构建)
 - [使用说明<a name="section33105542504"></a>](#使用说明)
 - [相关仓<a name="section1371113476307"></a>](#相关仓)

## 简介<a name="section11660541593"></a>

ets_frontend组件是方舟运行时子系统的前端工具，结合ace-ets2bundle组件，支持将ets文件转换为方舟字节码文件。

更多信息请参考：[方舟运行时子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/ARK-Runtime-Subsystem-zh.md)

## 目录<a name="section161941989596"></a>

```
/arkcompiler/ets_frontend/
├── test262            # test262测试配置和运行脚本
├── testTs             # 系统测试目录
├── es2panda
    ├── aot            # 逻辑入口
    ├── binder         # 信息绑定
    ├── compiler       # 编译逻辑
    ├── ir             # 字节码生成
    ├── lexer          # 词法分析
    ├── parser         # 语法解析，ast生成
    ├── scripts        # 脚本目录
    ├── test           # 测试目录
    ├── typescript     # typescript支持
    └── util           # 工具目录
├── ts2panda
    ├── doc            # 文档
    ├── scripts        # 依赖的脚本
    ├── src            # 源码存放目录
    ├── templates      # ruby模板文件
    ├── tests          # UT单元测试目录
    ├── tools          # ts2abc提供的工具
    └── ts2abc         # abc文件生成相关
```

## 编译构建<a name="section0446154755015"></a>

ets_frontend组件采用命令行交互方式，支持将JavaScript代码转换为方舟字节码文件，使其能够在方舟运行时上运行。支持Windows/Linux/MacOS平台。方舟前端工具在linux平台上可通过全量编译或指定编译前端工具链获取。

```
$ ./build.sh --product-name hispark_taurus_standard --build-target ets_frontend_build
```

### 使用说明<a name="section33105542504"></a>

#### es2panda使用方式 ####

使用ets_frontend组件下的es2abc可执行文件将JavaScript文件转换为方舟字节码文件

```
$ cd out/hispark_taurus/clang_x64/ark/ark/
$ ./es2abc [options] file.js
```

当不输入任何option参数时，默认生成方舟二进制文件。

#### ts2panda使用方式 ####

安装`node`和`npm`

使用ets_frontend组件将JavaScript文件转换为方舟字节码文件

```
$ cd out/hispark_taurus/clang_x64/ark/ark/build
$ npm install
$ node --expose-gc src/index.js [options] file.js
```

当不输入任何option参数时，默认生成方舟二进制文件。

<table><thead align="left"><tr id="row535415467591"><th class="cellrowborder" valign="top" width="12.898710128987101%" id="mcps1.1.6.1.1"><a name="p13354134619595"></a><a name="p13354134619595"></a>选项
</th>
<th class="cellrowborder" valign="top" width="6.869313068693131%" id="mcps1.1.6.1.2"><a name="p1584312189018"></a><a name="p1584312189018"></a>缩写
</th>
<th class="cellrowborder" valign="top" width="19.33806619338066%" id="mcps1.1.6.1.3"><a name="p157281281906"></a><a name="p157281281906"></a>描述
</th>
<th class="cellrowborder" valign="top" width="25.82741725827417%" id="mcps1.1.6.1.4"><a name="p103276335016"></a><a name="p103276335016"></a>取值范围
</th>
<th class="cellrowborder" valign="top" width="35.066493350664935%" id="mcps1.1.6.1.5"><a name="p1835494695915"></a><a name="p1835494695915"></a>默认值
</th>
</tr>
</thead>
<tbody><tr id="row1435412465598"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p881325510017"></a><a name="p881325510017"></a>--commonjs
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p148431189013"></a><a name="p148431189013"></a>-c
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p072882813015"></a><a name="p072882813015"></a>按照commonjs模式编译
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p10327833305"></a><a name="p10327833305"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p076075115014"></a><a name="p076075115014"></a>-
</td>
</tr>
<tr id="row1435412465598"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p881325510017"></a><a name="p881325510017"></a>--modules
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p148431189013"></a><a name="p148431189013"></a>-m
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p072882813015"></a><a name="p072882813015"></a>按照ESM模式编译
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p10327833305"></a><a name="p10327833305"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p076075115014"></a><a name="p076075115014"></a>-
</td>
</tr>
<tr id="row3355346105920"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p163552462595"></a><a name="p163552462595"></a>--debug-log
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p48431918607"></a><a name="p48431918607"></a>-l
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p127284281905"></a><a name="p127284281905"></a>使能log信息
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p93278335012"></a><a name="p93278335012"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p1976019511306"></a><a name="p1976019511306"></a>-
</td>
</tr>
<tr id="row9355174675912"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p6355104616592"></a><a name="p6355104616592"></a>--dump-assembly
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p20843161819020"></a><a name="p20843161819020"></a>-a
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p187287280015"></a><a name="p187287280015"></a>输出为汇编文件
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p932819331104"></a><a name="p932819331104"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p1475975114013"></a><a name="p1475975114013"></a>-
</td>
</tr>
<tr id="row53551046175917"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p13575501218"></a><a name="p13575501218"></a>--debug
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p48431818104"></a><a name="p48431818104"></a>-d
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p1372811281608"></a><a name="p1372811281608"></a>携带debug信息
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p133287335020"></a><a name="p133287335020"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p37585513019"></a><a name="p37585513019"></a>-
</td>
</tr>
<tr id="row8355204635911"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p657125010117"></a><a name="p657125010117"></a>--show-statistics
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p98433181905"></a><a name="p98433181905"></a>-s
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p77281528704"></a><a name="p77281528704"></a>显示字节码相关的统计信息
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p83281633208"></a><a name="p83281633208"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p17580511404"></a><a name="p17580511404"></a>-
</td>
</tr>
<tr id="row6355124665910"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p105611505114"></a><a name="p105611505114"></a>--output
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p1884310183014"></a><a name="p1884310183014"></a>-o
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20728192819015"></a><a name="p20728192819015"></a>输出文件路径
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p1332810331508"></a><a name="p1332810331508"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p157577519014"></a><a name="p157577519014"></a>-
</td>
</tr>
<tr id="row235584610599"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p95515501012"></a><a name="p95515501012"></a>--timeout
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p1684312184012"></a><a name="p1684312184012"></a>-t
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p37282028600"></a><a name="p37282028600"></a>超时门限
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p133281033804"></a><a name="p133281033804"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p675665112019"></a><a name="p675665112019"></a>-
</td>
</tr>
<tr id="row135584635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p4551501217"></a><a name="p4551501217"></a>--opt-log-level
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p1843181819011"></a><a name="p1843181819011"></a>-
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p157285282020"></a><a name="p157285282020"></a>指定编译优化log等级
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p1532819334016"></a><a name="p1532819334016"></a>['debug', 'info', 'error', 'fatal']
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p475510516018"></a><a name="p475510516018"></a>error
</td>
</tr>
<tr id="row133555461596"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p3541550416"></a><a name="p3541550416"></a>--opt-level
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p148441518404"></a><a name="p148441518404"></a>-
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p27281728502"></a><a name="p27281728502"></a>指定编译优化等级
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p832833312018"></a><a name="p832833312018"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p1975514517020"></a><a name="p1975514517020"></a>1
</td>
</tr>
<tr id="row23556463595"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p135313506120"></a><a name="p135313506120"></a>--help
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p168448187012"></a><a name="p168448187012"></a>-h
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p97284281607"></a><a name="p97284281607"></a>帮助提示
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p43281335010"></a><a name="p43281335010"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p57545511102"></a><a name="p57545511102"></a>-
</td>
</tr>
<tr id="row5356124655916"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p185311501910"></a><a name="p185311501910"></a>--bc-version
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p6844141810019"></a><a name="p6844141810019"></a>-v
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p1872818281006"></a><a name="p1872818281006"></a>输出当前字节码版本
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p73281733408"></a><a name="p73281733408"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p77537511606"></a><a name="p77537511606"></a>-
</td>
</tr>
<tr id="row1335654635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p175213504115"></a><a name="p175213504115"></a>--bc-min-version
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p384481811016"></a><a name="p384481811016"></a>-
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20729728003"></a><a name="p20729728003"></a>输出当前支持的最低字节码版本
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p4328533205"></a><a name="p4328533205"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014"></a>-
</td>
</tr>
<tr id="row1335654635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p175213504115"></a><a name="p175213504115"></a>--included-files
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p384481811016"></a><a name="p384481811016"></a>-i
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20729728003"></a><a name="p20729728003"></a>编译依赖的文件列表
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p4328533205"></a><a name="p4328533205"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014"></a>-
</td>
</tr>
<tr id="row1335654635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p175213504115"></a><a name="p175213504115"></a>--record-type
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p384481811016"></a><a name="p384481811016"></a>-p
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20729728003"></a><a name="p20729728003"></a>是否记录类型信息
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p4328533205"></a><a name="p4328533205"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014">true</a>
</td>
</tr>
<tr id="row1335654635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p175213504115"></a><a name="p175213504115"></a>--dts-type-record
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p384481811016"></a><a name="p384481811016"></a>-q
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20729728003"></a><a name="p20729728003"></a>记录.d.ts文件的类型信息
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p4328533205"></a><a name="p4328533205"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014">false</a>
</td>
</tr>
<tr id="row1335654635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p175213504115"></a><a name="p175213504115"></a>--debug-type
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p384481811016"></a><a name="p384481811016"></a>-g
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20729728003"></a><a name="p20729728003"></a>打印记录的类型信息
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p4328533205"></a><a name="p4328533205"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014">false</a>
</td>
</tr>
<tr id="row1335654635915"><td class="cellrowborder" valign="top" width="12.898710128987101%" headers="mcps1.1.6.1.1 "><a name="p175213504115"></a><a name="p175213504115"></a>--output-type
</td>
<td class="cellrowborder" valign="top" width="6.869313068693131%" headers="mcps1.1.6.1.2 "><a name="p384481811016"></a><a name="p384481811016"></a>-
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p20729728003"></a><a name="p20729728003"></a>设置输出类型
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p4328533205"></a><a name="p4328533205"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014">false</a>
</td>
</tr>
</tbody>
</table>

更多使用说明请参考：[方舟运行时使用指南](https://gitee.com/openharmony/ark_js_runtime/blob/master/docs/ARK-Runtime-Usage-Guide-zh.md)

## 相关仓<a name="section1371113476307"></a>

[arkcompiler\_runtime\_core](https://gitee.com/openharmony/arkcompiler_runtime_core)

[arkcompiler\_ets\_runtime](https://gitee.com/openharmony/arkcompiler_ets_runtime)

**[arkcompiler\_ets\_frontend](https://gitee.com/openharmony/arkcompiler_ets_frontend)**

chenyude/arkcompiler_ets_frontend

About

Releases

Contributors

Activities