46b93b9d22
* Implement memory profiler, optimize memory usage, modify code indent * Implement memory.grow and limit heap space base offset to 1G; modify iwasm build type to Release and 64 bit by default * Add a new extension library: connection * Fix bug of reading magic number and version in big endian platform * Re-org platform APIs: move most platform APIs from iwasm to shared-lib * Enhance wasm loader to fix some security issues * Fix issue about illegal load of EXC_RETURN into PC on stm32 board * Updates that let a restricted version of the interpreter run in SGX * Enable native/app address validation and conversion for wasm app * Remove wasm_application_exectue_* APIs from wasm_export.h which makes confused * Refine binary size and fix several minor issues Optimize interpreter LOAD/STORE opcodes to decrease the binary size Fix issues when using iwasm library: _bh_log undefined, bh_memory.h not found Remove unused _stdin/_stdout/_stderr global variables resolve in libc wrapper Add macros of global heap size, stack size, heap size for Zephyr main.c Clear compile warning of wasm_application.c * Add more strict security checks for libc wrapper API's * Use one libc wrapper copy for sgx and other platforms; remove bh_printf macro for other platform header files * Enhance security of libc strcpy/sprintf wrapper function * Fix issue of call native for x86_64/arm/mips, add module inst parameter for native wrapper functions * Remove get_module_inst() and fix issue of call native * Refine wgl lib: remove module_inst parameter from widget functions; move function index check to runtime instantiate * Refine interpreter call native process, refine memory boudary check * Fix issues of invokeNative function of arm/mips/general version * Add a switch to build simple sample without gui support * Add BUILD_TARGET setting in makefile to replace cpu compiler flags in source code * Re-org shared lib header files, remove unused info; fix compile issues of vxworks * Add build target general * Remove unused files * Update license header * test push * Restore file * Sync up with internal/feature * Sync up with internal/feature * Rename build_wamr_app to build_wasm_app * Fix small issues of README * Enhance malformed wasm file checking Fix issue of print hex int and implement utf8 string check Fix wasi file read/write right issue Fix minor issue of build wasm app doc * Sync up with internal/feature * Sync up with internal/feature: fix interpreter arm issue, fix read leb issue * Sync up with internal/feature * Fix bug of config.h and rename wasi config.h to ssp_config.h * Sync up with internal/feature * Import wamr aot * update document * update document * Update document, disable WASI in 32bit * update document * remove files * update document * Update document * update document * update document * update samples * Sync up with internal repo
116 lines
3.7 KiB
Markdown
116 lines
3.7 KiB
Markdown
|
|
|
|
## Use clang compiler
|
|
|
|
The recommended method to build a WASM binary is to use clang compiler ```clang-8```. You can refer to [apt.llvm.org](https://apt.llvm.org) for the detailed instructions. Here are referenced steps to install clang-8 in Ubuntu 16.04 and Ubuntu 18.04.
|
|
|
|
(1) Add source to your system source list from llvm website
|
|
|
|
For Ubuntu 16.04, add the following lines to /etc/apt/sources.list:
|
|
|
|
``` Bash
|
|
deb http://apt.llvm.org/xenial/ llvm-toolchain-xenial main
|
|
deb-src http://apt.llvm.org/xenial/ llvm-toolchain-xenial main
|
|
# 8
|
|
deb http://apt.llvm.org/xenial/ llvm-toolchain-xenial-8 main
|
|
deb-src http://apt.llvm.org/xenial/ llvm-toolchain-xenial-8 main
|
|
# 9
|
|
deb http://apt.llvm.org/xenial/ llvm-toolchain-xenial-9 main
|
|
deb-src http://apt.llvm.org/xenial/ llvm-toolchain-xenial-9 main
|
|
```
|
|
|
|
For Ubuntu 18.04, add the following lines to /etc/apt/sources.list:
|
|
|
|
``` Bash
|
|
# i386 not available
|
|
deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic main
|
|
deb-src http://apt.llvm.org/bionic/ llvm-toolchain-bionic main
|
|
# 8
|
|
deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-8 main
|
|
deb-src http://apt.llvm.org/bionic/ llvm-toolchain-bionic-8 main
|
|
# 9
|
|
deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-9 main
|
|
deb-src http://apt.llvm.org/bionic/ llvm-toolchain-bionic-9 main
|
|
```
|
|
|
|
(2) Download and install clang-8 tool-chain using following commands:
|
|
|
|
``` Bash
|
|
sudo wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key|sudo apt-key add -
|
|
# Fingerprint: 6084 F3CF 814B 57C1 CF12 EFD5 15CF 4D18 AF4F 7421
|
|
sudo apt-get update
|
|
sudo apt-get install llvm-8 lld-8 clang-8
|
|
```
|
|
|
|
(3) Create a soft link under /usr/bin:
|
|
|
|
``` Bash
|
|
cd /usr/bin
|
|
sudo ln -s wasm-ld-8 wasm-ld
|
|
```
|
|
|
|
(4) Use the clang-8 command below to build the WASM C source code into the WASM binary.
|
|
|
|
``` Bash
|
|
clang-8 --target=wasm32 -O3 \
|
|
-z stack-size=4096 -Wl,--initial-memory=65536 \
|
|
-Wl,--allow-undefined,--export=main \
|
|
-Wl,--strip-all,--no-entry -nostdlib \
|
|
-o test.wasm test.c
|
|
```
|
|
|
|
You will get ```test.wasm``` which is the WASM app binary.
|
|
|
|
|
|
|
|
|
|
|
|
## Use Emscripten tool
|
|
|
|
The last method to build a WASM binary is to use Emscripten tool ```emcc```.
|
|
Assuming you are using Linux, you may install emcc from Emscripten EMSDK following the steps below:
|
|
|
|
```
|
|
git clone https://github.com/emscripten-core/emsdk.git
|
|
cd emsdk
|
|
./emsdk install latest-fastcomp
|
|
./emsdk activate latest-fastcomp
|
|
```
|
|
|
|
The Emscripten website provides other installation methods beyond Linux.
|
|
|
|
Use the emcc command below to build the WASM C source code into the WASM binary.
|
|
|
|
``` Bash
|
|
cd emsdk
|
|
source emsdk_env.sh (or add it to ~/.bashrc if you don't want to run it each time)
|
|
cd <dir of test.c>
|
|
EMCC_ONLY_FORCED_STDLIBS=1 emcc -g -O3 -s WASM=1 -s ERROR_ON_UNDEFINED_SYMBOLS=0 \
|
|
-s TOTAL_MEMORY=65536 -s TOTAL_STACK=4096 \
|
|
-s ASSERTIONS=1 -s STACK_OVERFLOW_CHECK=2 \
|
|
-s "EXPORTED_FUNCTIONS=['_main']" -o test.wasm test.c
|
|
```
|
|
|
|
You will get ```test.wasm``` which is the WASM app binary.
|
|
|
|
|
|
|
|
|
|
|
|
## Using Docker
|
|
|
|
Another method availble is using [Docker](https://www.docker.com/). We assume you've already configured Docker (see Platform section above) and have a running interactive shell. Currently the Dockerfile only supports compiling apps with clang, with Emscripten planned for the future.
|
|
|
|
Use the clang-8 command below to build the WASM C source code into the WASM binary.
|
|
|
|
``` Bash
|
|
clang-8 --target=wasm32 -O3 \
|
|
-z stack-size=4096 -Wl,--initial-memory=65536 \
|
|
-Wl,--allow-undefined,--export=main \
|
|
-Wl,--strip-all,--no-entry -nostdlib \
|
|
-o test.wasm test.c
|
|
```
|
|
|
|
You will get ```test.wasm``` which is the WASM app binary.
|
|
|