emscripten/emsdk

Emscripten Docker镜像

此Dockerfile构建了一个独立版本的emsdk，使emscripten无需在主机系统上进行其他安装即可使用。该镜像发布于https://hub.docker.com/u/emscripten/emsdk。

使用方法

简单使用示例

以下是使用该容器编译"hello-world"程序的示例：

bash
# 创建helloworld.cpp
cat << EOF > helloworld.cpp
#include <iostream>
int main() {
  std::cout << "Hello World!" << std::endl;
  return 0;
}
EOF

bash
# 使用docker镜像编译
docker run \
  --rm \
  -v $(pwd):/src \
  -u $(id -u):$(id -g) \
  docker.xuanyuan.run/emscripten/emsdk \
  emcc helloworld.cpp -o helloworld.js

# 在主机上执行
node helloworld.js

编译命令解析

构建Dockerfile

构建参数

构建此镜像需要指定以下构建参数：

构建步骤

此步骤将在本地机器上按给定标签构建Dockerfile：

bash
# 使用docker
docker build \
    --network host \
    --build-arg=EMSCRIPTEN_VERSION=1.38.43-upstream \
    --tag emscripten/emsdk:1.38.43-upstream \
    .

bash
# 使用预定义的make目标
make version=1.38.43-upstream build

标记

如果直接使用docker build命令，指定的--tag应与Emscripten的发布版本匹配（可通过执行emsdk list查看非 legacy 版本列表）。

推送

此步骤将本地镜像推送到默认Docker仓库。需要确保已通过docker cli登录（docker login）并有权限推送到该仓库。

bash
# 使用docker
docker push emscripten/emsdk:1.38.43-upstream

bash
# 使用预定义的make目标
make version=1.38.43-upstream push

如果推送最新版本，还应将该版本标记为latest或latest-upstream并推送：

bash
# 使用docker cli

# 对于fastcomp变体（默认后端）
docker tag emscripten/emsdk:1.38.43 emscripten/emsdk:latest
docker push emscripten/emsdk:latest

# 对于upstream变体
docker tag emscripten/emsdk:1.38.43-upstream emscripten/emsdk:latest-upstream
docker push emscripten/emsdk:latest-upstream

bash
# 使用预定义的make目标
make version=1.38.43-upstream alias=latest-upstream push

扩展镜像

如果您的项目使用此镜像未提供的包，您可能需要：

• 为此仓库贡献代码：您的依赖项可能是非侵入性的或对其他人有用
• 创建基于此镜像的自定义镜像

创建自定义镜像步骤

1. 创建自己的Dockerfile：

   dockerfile
   # 指向任何您认为适合扩展的基础镜像
   FROM docker.xuanyuan.run/emscripten/emsdk:1.38.25
   
   # 安装项目所需的工具，例如ninja-build
   RUN apt update && apt install -y ninja-build
   

2. 构建它：

   shell
   docker build -t extended_emscripten .
   

3. 测试：

   shell
   docker run --rm docker.xuanyuan.run/extended_emscripten ninja --version
   # Python 2.7.16