niteris/fastled-wasm Docker 镜像 - 轩辕镜像

FastLED WebAssembly编译器镜像

概述

该Docker镜像集成了适用于amd64和arm64两种架构的FastLED WebAssembly（WASM）编译器，主要功能是将FastLED代码编译为WebAssembly格式，以便在Web环境中运行FastLED相关应用。

核心功能与特性

• 跨架构支持：同时兼容amd64（x86_64）和arm64（AArch64）硬件架构，可在不同平台上无缝使用
• 专用编译工具链：内置针对FastLED优化的WebAssembly编译工具，确保编译过程高效且输出文件兼容Web环境
• 轻量化设计：专注于核心编译功能，镜像体积经过优化，减少资源占用

使用场景与适用范围

• Web环境下的LED效果模拟开发
• 构建浏览器端LED控制应用
• 开发基于Web的FastLED代码在线编译平台
• 需要在amd64和arm64设备间共享编译环境的开发团队

使用方法与配置说明

基本使用（Docker Run）

bash
# 编译本地FastLED代码文件（假设源代码位于./src/main.cpp，输出到./output）
docker run --rm \
  -v $(pwd)/src:/app/src \
  -v $(pwd)/output:/app/output \
  fastled-wasm-compiler \
  compile /app/src/main.cpp -o /app/output/fastled_wasm_module.wasm

Docker Compose配置示例

yaml
version: '3.8'
services:
  fastled-compiler:
    image: fastled-wasm-compiler
    volumes:
      - ./fastled_source:/app/source
      - ./wasm_output:/app/output
    command: compile /app/source/led_effect.cpp -o /app/output/effect_module.wasm

编译命令参数说明

基础语法：compile <input_file> [options]

主要参数：

• <input_file>: 必选，FastLED源代码文件的容器内路径
• -o <output_file>: 必选，指定输出的WebAssembly文件路径
• -O <level>: 可选，优化级别（0-3），默认2
• --debug: 可选，生成包含调试信息的WebAssembly文件

注意事项

• 确保宿主机与容器架构匹配（amd64或arm64）以避免兼容性问题
• 挂载的源代码目录需包含完整的FastLED依赖文件
• 输出目录需提前创建并设置适当权限（建议使用chmod 777 output临时测试，生产环境需设置最小权限）