kitware/vtk-wasm-sdk

VTK WebAssembly SDK Docker镜像

概述

该Dockerfile构建了一个自包含的VTK C++版本，使得链接VTK的CMake项目无需从源码编译VTK，即可开发面向WebAssembly的应用（支持浏览器内外环境）。

核心功能和特性

• 提供自包含的VTK C++运行环境，免除手动从源码编译VTK的繁琐步骤
• 支持CMake项目直接链接VTK并靶向WebAssembly平台
• 兼容浏览器内外的WebAssembly应用开发场景
• 集成emcmake、cmake等构建工具，简化项目配置与构建流程

使用场景和适用范围

适用于需要基于VTK库开发WebAssembly应用的C++项目，尤其适合希望避免手动编译VTK源码的开发者，可快速搭建VTK WebAssembly开发环境。

使用方法

步骤1：下载示例源码

以下载VTK仓库中的C++示例为例：

shell
$ curl -L --output Cone.zip "https://gitlab.kitware.com/vtk/vtk/-/archive/master/vtk-master.zip?path=Examples/Emscripten/Cxx/Cone"
$ unzip -j Cone.zip -d Cone
## 此时Cone目录下应包含以下文件
$ ls Cone
  CMakeLists.txt  Cone.cxx  index.html  README.md

步骤2：配置CMake项目

shell
$ docker run \
  --rm \
  -u $(id -u):$(id -g) \
  -v $(pwd)/Cone:/Cone \
  kitware/vtk-wasm-sdk \
  emcmake cmake -S /Cone -B /Cone/build -DCMAKE_BUILD_TYPE=Release -DVTK_DIR=/VTK-install/Release/wasm32/lib/cmake/vtk

步骤3：构建项目

shell
$ docker run \
  --rm \
  -u $(id -u):$(id -g) \
  -v $(pwd)/Cone:/Cone \
  kitware/vtk-wasm-sdk \
  cmake --build /Cone/build

步骤4：运行应用

shell
$ python3 -m http.server -d ./Cone/build 8080

在浏览器中访问 http://localhost:8080 即可查看应用。

配置命令参数说明

构建Docker镜像

构建参数

该镜像支持以下可选构建参数：

构建步骤

以下命令将在本地机器上按指定标签构建镜像：

shell
# 使用docker构建
$ docker build \
  --network host \
  --build-arg=BUILD_DATE=$(date) \
  --build-arg=VERSION=9.3.0 \
  --tag kitware/vtk-wasm-sdk:v9.3.0 \
  .

标记镜像

直接使用docker build命令时，--tag参数应与VTK的发布版本匹配。

推送镜像

如需将本地镜像推送到默认Docker仓库，需先通过docker login登录，确保具有推送权限：

shell
# 使用docker推送
$ docker push kitware/vtk-wasm-sdk:v9.3.0

若推送最新版本，还需将其标记为latest并推送：

shell
# 使用docker cli
docker tag kitware/vtk-wasm-sdk:v9.3.0 kitware/vtk-wasm-sdk:latest
docker push kitware/vtk-wasm-sdk:latest