README.md · 李江薇/arkcompiler_ets_frontend

# ts2abc <a name="EN-US_TOPIC_0000001137330686"></a>

- [ts2abc <a name="EN-US_TOPIC_0000001137330686"></a>](#ts2abc-)
 - [Introduction<a name="section11660541593"></a>](#introduction)
 - [Directory Structure<a name="section161941989596"></a>](#directory-structure)
 - [Build<a name="section0446154755015"></a>](#Build)
 - [Usage Guidelines<a name="section33105542504"></a>](#usage-guidelines)
 - [Repositories Involved<a name="section1371113476307"></a>](#repositories-involved)

## Introduction<a name="section11660541593"></a>

ts2abc is a front-end tool in the ARK Runtime Subsystem. It converts JavaScript(JS) files into ARK bytecode files.

For more infomation, see: [ARK Runtime Subsystem](https://gitee.com/openharmony/docs/blob/master/en/readme/ARK-Runtime-Subsystem.md).

## Directory Structure<a name="section161941989596"></a>

```
/ark/ts2abc/
├── test262            # scripts for configuration and running Test262
├── testTs             # system test cases
├── ts2panda
    ├── scripts        # dependency scripts
    ├── src            # source code directory
    ├── templates      # ruby templates
    ├── tests          # unit test cases
    ├── tools          # tools provided by ts2abc
    └── ts2abc         # ts2abc source code

```

## Build<a name="section0446154755015"></a>

ts2abc uses the command line interaction mode and converts JS code into ARK bytecode files that can be run on an ARK runtime system. ts2abc supports Windows, Linux, and macOS. Front-end tools, converting JS source code into ARK bytecode, can be built by specifing the `--build-target` with `ark_ts2abc` on Linux.

```
$ ./build.sh --product-name Hi3516DV300 --build-target ark_ts2abc_build
```

### Usage Guidelines<a name="section33105542504"></a>

Install `node` and `npm`

convert JS to ARK bytecode

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

If no parameter is specified for  **\[options\]**, an ARK binary file is generated by default.

<a name="table2035444615598"></a>
<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>Option
</th>
<th class="cellrowborder" valign="top" width="6.869313068693131%" id="mcps1.1.6.1.2"><a name="p1584312189018"></a><a name="p1584312189018"></a>Abbreviation
</th>
<th class="cellrowborder" valign="top" width="19.33806619338066%" id="mcps1.1.6.1.3"><a name="p157281281906"></a><a name="p157281281906"></a>Description
</th>
<th class="cellrowborder" valign="top" width="25.82741725827417%" id="mcps1.1.6.1.4"><a name="p103276335016"></a><a name="p103276335016"></a>Value Range
</th>
<th class="cellrowborder" valign="top" width="35.066493350664935%" id="mcps1.1.6.1.5"><a name="p1835494695915"></a><a name="p1835494695915"></a>Default Value
</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>--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>Compiles the code based on the module.
</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>Enables the log function.
</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>Outputs an assembly file.
</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>Provides debug information.
</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>Displays statistics about bytecodes.
</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>Specifies the path of the output file.
</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>Specifies the timeout threshold.
</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>Specifies the log level for compilation optimization.
</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>Specifies the level for compilation optimization.
</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>Displays help information.
</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>Outputs the current bytecode version.
</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>Outputs the lowest bytecode version supported.
</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>The list of dependent files
</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>Record type info
</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>Record type info for .d.ts files
</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>Print type-related log
</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>Set output type
</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>

For more infomation, please see: [ARK-Runtime-Usage-Guide](https://gitee.com/openharmony/ark_js_runtime/blob/master/docs/ARK-Runtime-Usage-Guide.md).

## Repositories Involved<a name="section1371113476307"></a>

[ark\_runtime\_core](https://gitee.com/openharmony/ark_runtime_core)

[ark\_js\_runtime](https://gitee.com/openharmony/ark_js_runtime)

**[ark\_ts2abc](https://gitee.com/openharmony/ark_ts2abc)**

李江薇/arkcompiler_ets_frontend

简介

发行版

贡献者

近期动态

李江薇/arkcompiler_ets_frontend .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

李江薇/arkcompiler_ets_frontend