企业官网建设流程全解析

• 语言运行时
• 嵌入式
• 物联网

导读

本文以 WAMR（WebAssembly Micro Runtime）仓库中的product-mini目录为骨架，系统讲解 iwasm 可执行程序的构建方法与运行模式。iwasm 是基于 WAMR vmcore 构建的官方命令行运行时，支持 WASI 与命令行接口，覆盖 Linux、macOS、Windows、Android、Zephyr、RT-Thread、ESP-IDF、VxWorks 等十余个平台。读完本文，你将掌握 iwasm 的依赖安装、CMake 特性开关、六种运行模式的切换（fast/classic interpreter、AOT、LLVM JIT、Fast JIT、Multi-tier JIT）、wamrc AOT 编译器的构建，以及交叉编译与嵌入式平台集成方法。

一、iwasm 是什么：product-mini 在 WAMR 中的角色

product-mini是 WAMR 仓库中的一个轻量级"产品化"构建入口，其核心产物是iwasm——一个可直接运行的命令行可执行程序。与将 vmcore 作为库嵌入宿主程序（Embedding）的方式不同，iwasm 自带一个最小的宿主外壳（main()入口），负责解析命令行参数、加载 wasm/AOT 文件、实例化模块并调用导出函数。

从源码结构看，各 POSIX 系平台（Linux、FreeBSD、Darwin 等）的main.c都直接包含 product-mini/platforms/posix/main.c，该文件是 iwasm 宿主逻辑的核心实现：

• 参数解析与帮助输出：print_help()函数完整列出了 iwasm 的运行时选项（见第三节 CLI 参数表），这些选项大多受编译期特性宏（WASM_ENABLE_*）控制，未开启的特性不会出现在帮助中；
• 运行模式选择：通过--interp、--fast-jit、--llvm-jit、--multi-tier-jit设置RunningMode，最终传给wasm_runtime_full_init()完成运行时初始化；
• 模块加载与实例化：调用wasm_runtime_load()加载 wasm/AOT 文件，再通过wasm_runtime_instantiate_ex2()实例化，支持自定义栈大小（--stack-size）与宿主管理堆大小（--heap-size）；
• 入口执行：默认执行main导出函数，可用-f指定其他导出函数，还支持--repl交互模式与 WASI 退出码透传。

以 product-mini/platforms/linux/main.c 为例，整个文件只有一行核心内容：#include "../posix/main.c"，即 Linux 平台直接复用 POSIX 宿主实现。

二、构建前置知识：vmcore 的 CMake 配置体系

iwasm 的功能开关全部通过 CMake 变量传递给 vmcore。构建前建议先通读 doc/build_wamr.md，该文档列出了全部WAMR_*编译配置项及其默认值。与 iwasm 构建最相关的几个核心变量：

以 product-mini/platforms/linux/CMakeLists.txt 为证，Linux 平台默认开启WAMR_BUILD_INTERP、WAMR_BUILD_AOT、WAMR_BUILD_LIBC_BUILTIN、WAMR_BUILD_LIBC_WASI、WAMR_BUILD_FAST_INTERP、WAMR_BUILD_SIMD、WAMR_BUILD_REF_TYPES，默认关闭WAMR_BUILD_JIT、WAMR_BUILD_FAST_JIT、WAMR_BUILD_MULTI_MODULE等，这与 product-mini/README.md 中"Linux 默认启用 fast interpreter、AOT 与 Libc WASI，禁用 JIT"的描述一致。构建目标则依据CMAKE_SYSTEM_PROCESSOR与指针位宽自动判定为 X86_64 或 X86_32。

交叉编译：CMAKE_TOOLCHAIN_FILE

如果你在 X86 开发机上为 ARM 架构交叉编译，通过CMAKE_TOOLCHAIN_FILE指定工具链文件即可：

cmake .. -DCMAKE_TOOLCHAIN_FILE=$TOOL_CHAIN_FILE \ -DWAMR_BUILD_PLATFORM=linux \ -DWAMR_BUILD_TARGET=ARM

原仓库文档给出了 wamr-app-framework 的 arm-interp 工具链示例（WAMR_BUILD_TARGET=ARM的典型写法可参考doc/build_wamr.md中的ARMV7、ARMV7_VFP、THUMBV7等子架构组合）。对于 ESP-IDF 平台，需为具体芯片设置正确的工具链文件，例如$IDF_PATH/tools/cmake/toolchain-esp32c3.cmake，所有 ESP-IDF 工具链文件均位于$IDF_PATH/tools/cmake/下。

三、Linux 平台构建与六种运行模式

3.1 安装依赖

Linux 是 iwasm 最常用的开发平台，不同发行版/版本所需依赖不同：

Ubuntu-22.04：

sudo apt install build-essential cmake g++-multilib libgcc-11-dev lib32gcc-11-dev ccache

Ubuntu-20.04：

sudo apt install build-essential cmake g++-multilib libgcc-9-dev lib32gcc-9-dev ccache

Ubuntu-18.04：

sudo apt install build-essential cmake g++-multilib libgcc-8-dev lib32gcc-8-dev ccache

Fedora：

sudo dnf install glibc-devel.i686

其中g++-multilib与libgcc-*-dev/lib32gcc-*-dev用于支持 32 位目标（X86_32）的编译，ccache可加速重复构建。

3.2 默认构建

cd product-mini/platforms/linux/ mkdir build && cd build cmake .. make # iwasm 生成于当前目录下

默认配置下，Linux 平台启用fast interpreter、AOT与Libc WASI，禁用 JIT；构建目标依据平台位宽自动设置为 X86_64 或 X86_32。

3.3 六种运行模式

iwasm 共支持 6 种运行模式，构建期通过不同的 CMake 组合选定，运行期可通过 CLI 参数指定：

（1）Fast interpreter（快速解释器，默认）

iwasm <wasm file>

也可显式构建并运行：

mkdir build && cd build cmake .. -DWAMR_BUILD_INTERP=1 make

（2）Classic interpreter（经典解释器）

mkdir build && cd build cmake .. -DWAMR_BUILD_FAST_INTERP=0 make

两者对比（依据 doc/build_wamr.md）：fast interpreter 比 classic interpreter 快约 2 倍，但需消耗约 2 倍内存存放预编译代码；启用 LLVM JIT、Fast JIT 或解释器调试器（WAMR_BUILD_DEBUG_INTERP）时会强制切回 classic 解释器（WAMR_BUILD_FAST_INTERP自动置 0）。

（3）AOT 模式

AOT 需要先用 wamrc 编译器把 wasm 文件编译为 AOT 文件（wamrc 的构建见第四节），然后运行：

wamrc -o <AOT file> <WASM file> iwasm <AOT file>

（4）LLVM JIT 模式

先构建 LLVM 库（LLVM 源码会被克隆到<wamr_root_dir>/core/deps/llvm并自动构建）：

cd product-mini/platforms/linux/ ./build_llvm.sh

说明：build_llvm.sh内部实际调用 build-scripts/build_llvm.py（通过 product-mini/platforms/linux/build_llvm.sh 转发）。默认禁用 ccache 以减少 CI 存储消耗；本地开发频繁重建 LLVM 时可加--use-ccache加速增量构建：

cd <wamr_root_dir>/build-scripts python3 build_llvm.py --arch X86 --use-ccache

然后启用 LLVM JIT：

mkdir build && cd build cmake .. -DWAMR_BUILD_JIT=1 make

关于 Lazy JIT（懒编译）：默认启用 LLVM Orc JIT 的懒编译，以加快启动并降低 JIT 编译耗时——后台线程并行编译 WASM 函数，主线程中模块函数直到首次被调用且尚未被编译线程编译时才触发编译。若要禁用懒编译（所有 WASM 函数在主线程开始运行前一次性编译完毕）：

mkdir build && cd build cmake .. -DWAMR_BUILD_JIT=1 -DWAMR_BUILD_LAZY_JIT=0 make

（5）Fast JIT 模式

mkdir build && cd build cmake .. -DWAMR_BUILD_FAST_JIT=1 make

Fast JIT 是轻量级 JIT 引擎，启动快、占用小、可移植性好，性能约为 AOT 的 50%。注意 doc/build_wamr.md 提醒：Fast JIT 目前仅覆盖少数架构（如 x86_64）。

（6）Multi-tier JIT 模式

mkdir build && cd build cmake .. -DWAMR_BUILD_FAST_JIT=1 -DWAMR_BUILD_JIT=1 make

Multi-tier JIT 是两级分层 JIT 引擎：先以 Fast JIT 尽快启动运行 wasm 模块，同时创建后台线程编译 LLVM JIT 函数；LLVM JIT 函数编译完成后，运行时逐步将执行从 Fast JIT 代码切换到 LLVM JIT 代码，从而获得最佳性能。

3.4 iwasm 命令行参数速查

依据 product-mini/platforms/posix/main.c 中的print_help()，iwasm 的完整运行选项如下（部分选项仅在对应特性编译开启时可用）：

四、AOT 编译器 wamrc 的构建

iwasm 同时支持 wasm 二进制文件与 AOT 文件。wamrc 是 WAMR 的 AOT 编译器，负责把 wasm 二进制编译为可由 iwasm 直接运行的 AOT 文件。完整说明见 wamr-compiler/README.md。

Linux（以 Ubuntu 20.04 为例）：

sudo apt-get install git build-essential cmake g++-multilib libgcc-9-dev lib32gcc-9-dev ccache

cd wamr-compiler ./build_llvm.sh # 或 ./build_llvm_xtensa.sh 以支持 xtensa 目标 mkdir build && cd build cmake .. # MacOS 下使用 cmake .. -DWAMR_BUILD_PLATFORM=darwin make # wamrc 生成于当前目录下

Windows：

cd wamr-compiler python build_llvm.py mkdir build && cd build cmake .. cmake --build . --config Release # wamrc.exe 生成于 .\Release 目录下

构建完成后即可用wamrc -o <AOT file> <WASM file>生成 AOT 文件，再用iwasm <AOT file>运行（AOT 模式对启动延迟敏感或内存受限的部署场景尤其适用）。

五、桌面与服务器平台构建

5.1 MacOS

先从 App Store 安装 Xcode，再安装 cmake。若使用 Homebrew：

brew install cmake

然后构建：

cd product-mini/platforms/darwin/ mkdir build cd build cmake .. make # iwasm 生成于当前目录下

默认配置与 Linux 相同：启用 fast interpreter、AOT 与 Libc WASI，禁用 JIT；构建目标依位宽为 X86_64 或 X86_32。运行 wasm：

iwasm <wasm file>

运行 AOT 文件：

wamrc -o <AOT file> <WASM file> iwasm <AOT file>

JIT 模式与 classic interpreter 模式的构建方式与 Linux 完全一致（见 doc/build_wamr.md 的 Linux 小节）。目前 MacOS 默认启用 interpreter、AOT 与 builtin libc。

5.2 Windows

确保MSVC与cmake已安装并在命令行环境中可用：

cd product-mini/platforms/windows/ mkdir build cd build cmake .. cmake --build . --config Release # ./Release/iwasm.exe 生成

默认启用 fast interpreter、AOT 与 Libc WASI，禁用 JIT。运行 wasm：

iwasm.exe <wasm file>

运行 AOT 文件：

wamrc.exe -o <AOT file> <WASM file> iwasm.exe <AOT file>

目前 Windows 默认启用 interpreter、AOT 与 builtin libc。所有平台共有的特性开关细节均可参考 doc/build_wamr.md 的 "WAMR vmcore cmake building configurations" 章节。

5.3 MinGW

MinGW 场景下建议使用 MSYS2 环境，先安装正确的 CMake 包：

pacman -R cmake pacman -S mingw-w64-x86_64-cmake pacman -S mingw-w64-x86_64-gcc pacman -S make git

然后按 Windows 的构建步骤执行，并附加如下 cmake 参数：

cmake .. -G"Unix Makefiles" \ -DWAMR_DISABLE_HW_BOUND_CHECK=1

注意两点限制：

• WASI 在 MinGW 完全支持之前默认被禁用；
• 由于禁用了基于硬件陷阱的内存访问边界检查，用wamrc生成 AOT 文件时必须加--bounds-checks=1以生成内存访问边界检查指令，确保沙箱安全：

  wamrc --bounds-checks=1 -o <aot_file> <wasm_file>

• 若编译器报RUNTIME_FUNCTION结构缺少UnwindInfoAddress字段（winnt.h），属 MinGW 头文件差异，按仓库提示处理即可。

5.4 FreeBSD

sudo pkg install gcc cmake wget

cd product-mini/platforms/freebsd mkdir build && cd build cmake .. make

六、嵌入式与物联网平台构建

6.1 Linux SGX（Intel Software Guard Extension）

WAMR 支持在 Intel SGX 安全环境中运行，详细步骤见 doc/linux_sgx.md，涉及 enclave 构建、EDL 文件与 attestation 配置，本文不再展开。

6.2 Zephyr

Zephyr 平台的构建方法在 product-mini/platforms/zephyr/README.md 中有完整说明，Zephyr 目录下还提供 simple、simple-file、simple-http、user-mode 等多个示例工程及build_and_run.py脚本。目前 Zephyr 默认启用 interpreter、AOT 与 builtin libc。

6.3 RT-Thread

1. 获取 RT-Thread 系统源码（仓库文档给出的 RT-Thread 官方仓库地址可自行搜索获取）；

2. 使用 RT-Thread 提供的 menuconfig 工具启用 WAMR 软件包：

   • Linux 环境：scons --menuconfig
   • Windows ConEmu 环境：menuconfig

   在以下路径选中并启用WAMR：

   • RT-Thread online packages → tools packages → WebAssembly Micro Runtime (WAMR)

3. 继续用 menuconfig 配置 iwasm 功能选项，可勾选：

   • 启用 iwasm 的测试参数
   • 启用解释器模式 / Fast 解释器模式
   • 使用 built-libc
   • 启用 AOT

4. 退出并保存配置，更新并下载软件包：

   pkgs --update

5. 构建工程并烧录到开发板：

   scons

   或用 8 线程加速构建：

   scons -j8

   构建完成后得到rtthread.bin，将其下载到 MCU 板即可。目前 RT-Thread 默认启用 interpreter、AOT 与 builtin libc。

6.4 NuttX

WAMR 已集成进 NuttX，只需在 Kconfig 选项（Application Configuration / Interpreters）中启用 WAMR 即可。

6.5 ESP-IDF

WAMR 同时集成支持 XTENSA 与 RISC-V 芯片（分别对应 esp32x 与 esp32c3）。使用前提是 ESP-IDF 版本不低于 4.3.1（ESP-IDF 会一并安装编译 WAMR 所需的工具链）。演示工程位于 product-mini/platforms/esp-idf，它会为 ESP-IDF 构建 WAMR 并运行一个小型 wasm 程序。针对具体芯片运行前，需要：

• 编辑 product-mini/platforms/esp-idf/build_and_run.sh，填入正确的工具链文件（见"交叉编译"小节）与IDF_TARGET；
• 编译前先执行 ESP-IDF 的export.sh脚本，将编译期所需的环境信息引入当前 shell。

6.6 AliOS-Things

1. 准备一块 developerkit 开发板用于测试；
2. 下载 AliOS-Things 源码；
3. 将<wamr_root_dir>/product-mini/platforms/alios-things目录复制到 AliOS-Things 的 middleware 目录并重命名为 iwasm：

   cp -a <wamr_root_dir>/product-mini/platforms/alios-things middleware/iwasm

4. 在middleware/iwasm/下创建指向<wamr_root_dir>的软链接并命名为 wamr：

   ln -s <wamr_root_dir> middleware/iwasm/wamr

5. 修改app/example/helloworld/helloworld.c，加入初始化调用：

   #include <stdbool.h> #include <aos/kernel.h> extern bool iwasm_init(); int application_start(int argc, char *argv[]) { int count = 0; iwasm_init(); ... }

6. 修改app/example/helloworld/aos.mk加入组件依赖：

   $(NAME)_COMPONENTS := osal_aos iwasm

7. 构建并运行：
   • Linux 宿主：

     aos make helloworld@linuxhost -c config aos make ./out/helloworld@linuxhost/binary/helloworld@linuxhost.elf

   • developerkit 开发板：修改middleware/iwasm/aos.mk设置目标架构：

     WAMR_BUILD_TARGET := THUMBV7M

     aos make helloworld@developerkit -c config aos make

     将生成的二进制下载到开发板，从串口查看输出。

6.7 VxWorks

VxWorks 7 SR0620 版本已验证通过。首先构建 VSB，确保 VSB 中加入了UTILS_UNIX层；VSB 构建完成后导出 VxWorks 工具链路径：

export <vsb_dir_path>/host/vx-compiler/bin:$PATH

进入 iwasm 源码树构建：

cd product-mini/platforms/vxworks/ mkdir build cd build cmake .. make

基于该 VSB 创建 VIP，须加入以下组件：

• INCLUDE_POSIX_PTHREADS
• INCLUDE_POSIX_PTHREAD_SCHEDULER
• INCLUDE_SHARED_DATA
• INCLUDE_SHL

将生成的 iwasm 可执行文件、测试用 WASM 二进制及所需共享库（libc.so.1、libllvm.so.1或libgnu.so.1——视 VSB 而定，以及libunix.so.1）拷贝到受支持的文件系统（如 romfs）。目前 VxWorks 默认启用 interpreter 与 builtin libc。

6.8 Cosmopolitan Libc

当前仅支持 x86_64 架构的解释器模式。按 cosmocc 官方 Getting Started 说明配置好cosmocc，并确保其bin目录在PATH中，然后构建：

export CC=x86_64-unknown-cosmo-cc export CXX=x86_64-unknown-cosmo-c++ rm -rf build mkdir build cmake -DWAMR_BUILD_INTERP=1 -DWAMR_BUILD_FAST_INTERP=1 -B build cmake --build build -j

运行：

./build/iwasm.com <wasm file>

6.9 Android

Android 平台可生成共享库。准备工作：

• 安装 Android SDK（"Command line tools only" 即可）；
• 用sdkmanager下载以下组件（版本号可按需调整）：
  • "build-tools;29.0.3"
  • "cmake;3.10.2.4988404"
  • "ndk;latest"
  • "patcher;v4"
  • "platform-tools"
  • "platforms;android-29"
• 将下载的 cmake 的bin/加入$PATH；
• export ANDROID_HOME=/the/path/of/downloaded/sdk/
• export ANDROID_NDK_LATEST_HOME=/the/path/of/downloaded/sdk/ndk/2x.xxx/

使用默认配置编译：

cd product-mini/platforms/android/ mkdir build cd build cmake .. make # 输出检查 distribution/wasm # include/ 包含全部必需头文件 # lib 包含 libiwasm.so

通过WAMR_BUILD_TARGET与ANDROID_ABI指定目标架构与 ABI：

cmake .. -DWAMR_BUILD_TARGET=X86_32 -DANDROID_ABI=x86 # 32-bit Intel CPU cmake .. -DWAMR_BUILD_TARGET=X86_64 -DANDROID_ABI=x86_64 # 64-bit Intel CPU cmake .. -DWAMR_BUILD_TARGET=ARMV7A -DANDROID_ABI=armeabi-v7a # 32-bit ARM CPU cmake .. -DWAMR_BUILD_TARGET=AARCH64 -DANDROID_ABI=arm64-v8a # 64-bit ARM CPU

七、Docker 一键构建

Docker 方式会自动下载全部依赖并代为构建 WAMR Core。确保本机已安装 Docker（macOS、Windows 或 Linux 均可），然后：

cd ci ./build_wamr.sh ls ../build_out/

ci/build_wamr.sh 的流程是：构建 WAMR 开发镜像（wamr_dev_<发行版>:0.1），在容器内进入product-mini/platforms/linux执行cmake .. && make，最终将产物拷贝到build_out。该脚本会生成 Linux 兼容的动态库libiwasm.so与静态库libvmlib.a，以及可执行程序iwasm；所有原始构建产物仍保留在product-mini/platforms/linux/build下。

八、构建完成后的进一步探索

iwasm 构建完成后，你可以：

• 运行仓库 samples 下的各类示例（如 samples/basic 的宿主嵌入示例、samples/native-lib 的原生库注册示例），配合--native-lib体验 WAMR 的原生扩展机制；
• 依据 doc/build_wamr.md 的完整配置表按需裁剪功能，例如组合开关：cmake .. -DWAMR_BUILD_INTERP=0 -DWAMR_BUILD_AOT=1 -DWAMR_BUILD_LIBC_WASI=1 -DWAMR_BUILD_PLATFORM=linux（纯 AOT + WASI 形态），或-DWAMR_BUILD_INTERP=1 -DWAMR_BUILD_AOT=0 -DWAMR_BUILD_LIBC_WASI=0 -DWAMR_BUILD_TARGET=X86_32（纯解释器 + X86_32 形态）；
• 关注 doc/build_wamr.md 中标记为Privileged Features的选项（如WAMR_BUILD_MINI_LOADER、WAMR_CONFIGURABLE_BOUNDS_CHECKS），它们以降低隔离性换取性能或能力，务必在信任 wasm 来源的前提下使用。

通过本指南，你已经能够从零构建 iwasm，并在解释器、AOT 与多种 JIT 模式之间自由切换，同时将 WAMR 运行时落地到从桌面到嵌入式 RTOS 的各类平台。更多运行模式对比与性能调优细节，可继续阅读 doc/perf_tune.md 与 doc/memory_tune.md。

• 语言运行时
• 嵌入式
• 物联网