Building from Source
Building Wasmer from source requires Rust.
The easiest way to install Rust on your system is via Rustup. To get Rustup on Linux and macOS, you can run the following:
curl https://sh.rustup.rs -sSf | sh
To install Rust on Windows, download and run rustup-init.exe, then follow the onscreen instructions.
If you have Homebrew installed:
brew install cmake
Or, if you have MacPorts:
sudo port install cmake
sudo apt install cmake pkg-config libssl-dev
pkg install cmake
Windows support is experimental. WASI is fully supported, but Emscripten support is in the works.
Install Visual Studio
Install Rust for Windows
Install Git for Windows. Allow it to add
git.exeto your PATH (default settings for the installer are fine).Install CMake. Ensure CMake is in your PATH.
(optional) Install LLVM 8.0
Wasmer is built with Cargo, the Rust package manager.
First, let's clone Wasmer:
git clone https://github.com/wasmerio/wasmer.gitcd wasmer
Wasmer has three different backends at the moment:
The Singlepass backend requires nightly, so if you want to use it, set Rust Nightly:
rustup default nightly
And then, build Wasmer:
make release
Note: you should see this as the first line in the console:
Available backends: singlepass
The singlepass backend requires Rust nightly, as it's using the Dynasm crate which depends on Rust features only available in Rust nightly
The Cranelift backend will work with both nightly and stable versions of Rust if you are in a X86 machine, so you don't need to do anything in your system to enable it. In ARM systems is disabled by default (as is not yet available there)
make release
Note: should see this as the first line in the console:
Available backends: cranelift
If you want support for the Wasmer LLVM backend, then you will also need to ensure:
Ensure that LLVM 8.0.x > is installed on your system
You can also download and use a prebuilt LLVM binary
In case
llvm-configis not accessible, set the correct environment variable for LLVM to access: For example, the environment variable for LLVM 8.0.x would be:LLVM_SYS_80_PREFIX=/path/to/unpacked/llvm-8.0
And create a Wasmer release
make release
Note: you should see this as the first line in the console:
Available backends: llvm
Once you have LLVM and Rust nightly installed, you can just run:
make release
Note: you should see this as the first line in the console:
Available backends: singlepass cranelift llvm
For compiling with all backends, you will need to set the nightly toolchain as the default for Rust (for Singlepass) and you will also need LLVM installed in your system (LLVM)
Once you run the make release command, you will have a new binary ready to be used!
./target/release/wasmer quickjs.wasm
Wasmer provides a pre-compiled version for the C-API on its release page.
However, you can also compile the shared library from source:
make capi
This will generate the shared library (depending on your system):
Windows:
target/release/wasmer_runtime_c_api.dllmacOS:
target/release/libwasmer_runtime_c_api.dylibLinux:
target/release/libwasmer_runtime_c_api.so
By default, the Wasmer C API shared library is built with Cranelift as the default backend. You can generate the C-API for a specific backend with:
Singlepass:
make capi-singlepassCranelift:
make capi-craneliftLLVM:
make capi-llvm
If you want to generate the library and headers for using them easily, you can execute:
make build-capi
This command will generate a capi directory, that you can then use easily in the Wasmer C API examples.
