openharmony/arkcompiler_ets_runtime
1
0
Fork 0
mirror of https://gitee.com/openharmony/arkcompiler_ets_runtime synced 2024-10-07 16:13:49 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
8fded9db6c
arkcompiler_ets_runtime/docs/using-the-toolchain.md
changjiaxing f7c701cb40 modify docs 
Merge several articles on development examples, environment installation and compilation, and tool use, update compilation commands, and add aot-related tool introduction

issue:https://gitee.com/openharmony/arkcompiler_ets_runtime/issues/I6JK9W

Signed-off-by: changjiaxing <changjiaxing2@huawei.com>
Change-Id: I7aca4d148effa8a72fa61197b670f24d7cd9078e
2023-03-09 10:51:47 +08:00

17 KiB
Raw Blame History

Using the Toolchain

The ARK front-end tools use the command line interaction mode and convert JS code into ARK bytecodes that can run on ARK runtime. The toolchain supports Windows, Linux, and macOS.

JS Bytecode Compiler

Front-end tools, converting JS source code into ARK bytecode, can be built by specifying the --build-target with ark_ts2abc.

Build tools:

$ $ ./build.sh --product-name rk3568 --build-target ark_ts2abc_build

Install node and npm, then use tools:

$ cd out/rk3568/clang_x64/arkcompiler/ets_frontend/build
$ npm install
$ node --expose-gc src/index.js [option] file.js

Option

Abbreviation

Description

Value Range

Default Value

--modules

-m

Compiles JS files based on the module.

-

-

--debug-log

-l

Enables the log function.

-

-

--dump-assembly

-a

Outputs a text ARK bytecode file.

-

-

--debug

-d

Provides debug information.

-

-

--show-statistics

-s

Displays statistics about bytecodes.

-

-

--output

-o

Specifies the path of the output file.

-

-

--timeout

-t

Specifies the timeout threshold.

-

-

--help

-h

Displays help information.

-

-

--bc-version

-v

Outputs the current bytecode version.

-

-

--bc-min-version

   

Outputs the lowest bytecode version supported.

-

-

Assembler ark_asm

The ark_asm assembler converts the text ARK bytecode file into a bytecode file in binary format.

Command:

ark_asm [Option] Input file Output file

Option

Description

--dump-scopes

Saves the result to a JSON file to support the debug mode in Visual Studio Code.

--help

Displays help information.

--log-file

Specifies the log file output path after log printing is enabled.

--optimize

Enables compilation optimization.

--size-stat

Collects statistics on and prints ARK bytecode information after conversion.

--verbose

Enables log printing.

Input file: ARK bytecodes in text format

Output file: ARK bytecodes in binary format

Disassembler ark_disasm

The ark_disasm disassembler converts binary ARK bytecodes into readable text ARK bytecodes.

Command:

ark_disasm [Option] Input file Output file

Option

Description

--debug

Enables the function for printing debug information.

--debug-file

Specifies the path of the debug information output file. The default value is std::cout.

--help

Displays help information.

--verbose

Outputs the comments of the output file.

Input file: ARK bytecodes in binary format

Output file: ARK bytecodes in text format