Building GraalWasm

Prerequisites

Required dependencies

• Python 3 (required by mx)
• git (to download, update, and locate repositories)
• JDK 21+

Optional dependencies

• WABT (WebAssembly Binary Toolkit) for translating .wat files
• Emscripten or WASI SDK for translating C files

Building

To build GraalWasm, you need to follow the standard workflow for Graal projects. We summarize the basic steps below:

1. Create a new folder where your repositories mx and graal should be located:

   bashCopy

   $ mkdir graalvm
   $ cd graalvm
   

2. Clone mx and add it to the PATH:

   bashCopy

   $ git clone https://github.com/graalvm/mx.git
   $ export PATH=$PWD/mx:$PATH
   

3. Clone the graal repository and enter the wasm directory:

   bashCopy

   $ git clone https://github.com/oracle/graal.git
   $ cd graal/wasm
   

4. Set JAVA_HOME:

   bashCopy

   $ export JAVA_HOME=[path to JDK]
   

5. Build the project:

   bashCopy

   $ mx --dynamicimports /compiler build
   

These steps will build the wasm.jar file in the mxbuild/dists/jdk<version> directory, which contains GraalWasm.

Testing

To run a .wasm file, you can use the following command: bash $ mx --dynamicimports /compiler wasm somefile.wasm

For instructions how to run the tests, see Tests and Benchmarks.