arkcompiler_ets_frontend/README.md

ets_frontend

• ets_frontend
  • Introduction
  • Directory Structure
  • Build
    • Usage Guidelines
  • Repositories Involved

Introduction

ets_frontend is a front-end tool in the ARK Runtime Subsystem. Combined with the ace-ets2bundle component, it supports converting ETS files into ARK bytecode files.

For more information, see: ARK Runtime Subsystem.

ets_frontend architecture

Directory Structure

/arkcompiler/ets_frontend/
├── test262            # scripts for configuration and running Test262
├── testTs             # system test cases
├── test_ecma_bcopt    # bytecode_optimize test cases
├── test               # sdk，xts test cases
├── es2panda
    ├── aot            # logical entry
    ├── binder         # info binding
    ├── compiler       # compiling logic
    ├── ir             # Bytecode generation
    ├── lexer          # lexical analysis
    ├── parser         # syntax parsing, AST generation
    ├── scripts        # script directory
    ├── test           # test directory
    ├── typescript     # typescript support
    └── util           # tool directory
├── legacy_bin         # API8 Compiler directory
├── merge_abc
    ├── protos         # proto template directory
    ├── scripts        # script directory
    ├── src            # proto Serialization and deserialization directory

Build

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

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

Usage Guidelines

Usage For Es2panda

Use the es2abc executable under the ets_frontend component to convert JavaScript files into Ark bytecode files

$ cd out/rk3568/clang_x64/arkcompiler/ets_frontend/
$ ./es2abc [options] file.js

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

Option	Description	Value Range	Default Value
--debug-info	Provides debug information.	-	-
--debugger-evaluate-expression	Evaluates base64 style expression in debugger	-	-
--dump-assembly	Outputs an assembly file.	-	-
--dump-ast	Prints the parsed AST(Abstract Syntax Tree)	-	-
--dump-debug-info	Prints debug Info	-	-
--dump-literal-buffer	Prints the content of literal buffer	-	-
--dump-size-stat	Displays statistics about bytecodes.	-	-
--extension	Specifies input file type	['js', 'ts', 'as']	-
--help	Displays help information.	-	-
--module	Compiles the code based on the ecmascript standard module.	-	-
--opt-level	Specifies the level for compilation optimization.	['0', '1', '2']	0
--output	Specifies the path of the output file.	-	-
--parse-only	Parse the input file only	-	-
--thread	Specifies the number of threads used to generate bytecode	0-Number of threads supported by your machine	0

For more information, please see: ARK-Runtime-Usage-Guide.

Repositories Involved

arkcompiler_runtime_core

arkcompiler_ets_runtime

arkcompiler_ets_frontend