README_zh.md · 杨希宸/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)

**ets_frontend组件架构图**

![](/figures/zh-cn_image_ets_frontend_arch.png)

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

```
/arkcompiler/ets_frontend/
├── test262            # test262测试配置和运行脚本
├── testTs             # 系统测试目录
├── test_ecma_bcopt    # 字节码优化测试目录
├── test               # sdk，xts测试目录
├── es2panda
    ├── aot            # 逻辑入口
    ├── binder         # 信息绑定
    ├── compiler       # 编译逻辑
    ├── ir             # 字节码生成
    ├── lexer          # 词法分析
    ├── parser         # 语法解析，ast生成
    ├── scripts        # 脚本目录
    ├── test           # 测试目录
    ├── typescript     # typescript支持
    └── util           # 工具目录
├── legacy_bin         # API8编译器目录
├── merge_abc
    ├── protos         # proto模板目录
    ├── scripts        # 脚本目录
    ├── src            # proto文件序列化和反序列化目录

```

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

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

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

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

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

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

```
$ cd out/rk3568/clang_x64/arkcompiler/ets_frontend/
$ ./es2abc [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="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>--debug-info
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p072882813015"></a><a name="p072882813015"></a>携带debug信息
</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>--debugger-evaluate-expression
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p072882813015"></a><a name="p072882813015"></a>debugger下对输入的base64形式的表达式求值
</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>--dump-assembly
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p127284281905"></a><a name="p127284281905"></a>输出为汇编文件
</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-ast
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p187287280015"></a><a name="p187287280015"></a>打印解析得到的ast(抽象语法树)
</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>--dump-debug-info
</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>--dump-literal-buffer
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p77281528704"></a><a name="p77281528704"></a>打印literal buffer内容
</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>--dump-size-stat
</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>--extension
</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>['js', 'ts', 'as']
</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>--help
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p157285282020"></a><a name="p157285282020"></a>帮助提示
</td>
<td class="cellrowborder" valign="top" width="25.82741725827417%" headers="mcps1.1.6.1.4 "><a name="p1532819334016"></a><a name="p1532819334016"></a>-
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p475510516018"></a><a name="p475510516018"></a>-
</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>--module
</td>
<td class="cellrowborder" valign="top" width="19.33806619338066%" headers="mcps1.1.6.1.3 "><a name="p27281728502"></a><a name="p27281728502"></a>按照ESM模式编译
</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>-
</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>--opt-level
</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>['0', '1', '2']
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p57545511102"></a><a name="p57545511102"></a>0
</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>--output
</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>--parse-only
</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>--thread
</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>0-机器支持的线程数目
</td>
<td class="cellrowborder" valign="top" width="35.066493350664935%" headers="mcps1.1.6.1.5 "><a name="p175385118014"></a><a name="p175385118014"></a>0
</td>
</tr>
</tbody>
</table>

更多使用说明请参考：[方舟运行时使用指南](https://gitee.com/openharmony/arkcompiler_ets_runtime/blob/master/docs/README_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)**

杨希宸/arkcompiler_ets_frontend

简介

发行版

贡献者

近期动态

杨希宸/arkcompiler_ets_frontend .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

杨希宸/arkcompiler_ets_frontend