Skip to content

Latest commit

 

History

History
131 lines (100 loc) · 3.29 KB

Development.md

File metadata and controls

131 lines (100 loc) · 3.29 KB

Wasm3 development notes

This project uses CMake. General build steps look like:

mkdir -p build
cd build
cmake ..
make -j8

Wasm3 is continuously tested with Clang, GCC, MSVC compilers, and on multiple platforms. It can be easily integarted into any build system, as shown in platforms.

Build on Linux, OS X

Clang

mkdir build
cd build
cmake -GNinja -DCLANG_SUFFIX="-9" ..
ninja

GCC

mkdir build
cd build
cmake -GNinja ..
ninja

Build on Windows

Prerequisites:

Recommended tools:

# Prepare environment (if needed):
"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
set PATH=C:\Program Files\CMake\bin;%PATH%
set PATH=C:\Program Files\LLVM\bin;%PATH%
set PATH=C:\Python36-32\;C:\Python36-32\Scripts\;%PATH%

Build with MSBuild

# Create a build directory as usual, then build a specific configuration
mkdir build
cd build

# Clang, x64
cmake -G"Visual Studio 16 2019" -A x64 -T ClangCL ..
cmake --build . --config Release

# Clang, x86
cmake -G"Visual Studio 16 2019" -A Win32 -T ClangCL ..
cmake --build . --config Release

# MSVC, x64
cmake -G"Visual Studio 16 2019" -A x64 ..
cmake --build . --config Release

# MSVC, x86
cmake -G"Visual Studio 16 2019" -A Win32 ..
cmake --build . --config Release

Build with Ninja

# Clang
cmake -GNinja -DCLANG_CL=1 ..
ninja

# MSVC
cmake -GNinja ..
ninja

Build for microcontrollers

In ./platforms/ folder you can find projects for different targets. Some of them are using Platformio, so you can follow the regular pio build process. Others have custom instructions in respective README.md files.

Build with WasiEnv

wasimake cmake -GNinja ..
ninja

If you want to enable experimental WASM features during the build:

export CFLAGS="-Xclang -target-feature -Xclang +tail-call"
wasimake cmake -GNinja ..
ninja

Here's how some options can be used with different tools:

Clang target-feature option          WABT option                        Chromium --js-flags option
----------------------------------------------------------------------------------------------------------------
+multivalue                          --enable-multi-value               --experimental-wasm-mv
+tail-call                           --enable-tail-call                 --experimental-wasm-return-call
+bulk-memory                         --enable-bulk-memory               --experimental-wasm-bulk-memory
+nontrapping-fptoint                 --enable-saturating-float-to-int   --experimental-wasm-sat-f2i-conversions
+sign-ext                            --enable-sign-extension            --experimental-wasm-se
+simd128, +unimplemented-simd128     --enable-simd                      --experimental-wasm-simd

# List clang options:
llc -march=wasm32 -mattr=help

# List Chromium options:
chromium-browser --single-process --js-flags="--help" 2>&1 | grep wasm