ark_ts2abc/README.md

ts2abc

• Introduction

• Directory Structure

• Note

  • Usage Guidelines

• Repositories Involved

Introduction

As a module of the ARK platform, ts2abc is a front-end tool for JavaScript (JS) in the ARK compiler. It converts JS files into ARK bytecode files.

Directory Structure

/ark/ts2abc/
├── ts2panda
    ├── doc            # Documents
    ├── scripts        # Dependency scripts
    ├── src            # Source code directory
    ├── templates      # Ruby templates
    ├── tests          # Unit test cases
    ├── tools          # Tools provided by ts2abc
    └── ts2abc         # ts2abc source code

Note

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.

Usage Guidelines

You can run node --expose-gc your_path_to/index.js [options] your_file.js to convert a JS file into an ARK bytecode file using ts2abc. If no parameter is specified for [options], an ARK binary file is generated by default. The index.js file is the executable file generated after ts2abc compilation.

Option	Abbreviation	Description	Value Range	Default Value
--modules	-m	Compiles the code based on the module.	-	-
--debug-log	-l	Enables the log function.	-	-
--dump-assembly	-a	Outputs an assembly 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.	-	-
--opt-log-level	-	Specifies the log level for compilation optimization.	['debug', 'info', 'error', 'fatal']	error
--opt-level	-	Specifies the level for compilation optimization.	-	1
--help	-h	Displays help information.	-	-
--bc-version	-v	Outputs the current bytecode version.	-	-
--bc-min-version	-	Outputs the lowest bytecode version supported.	-	-

Repositories Involved

ARK Runtime Subsystem

ark/runtime_core

ark/js_runtime

ark/ts2abc