felfert/wix

docker-wix

Docker化的WiX工具集，专注于简化设置和使用流程。无需修改Dockerfile或使用特殊语法（如“wine candle.exe ...”），通过内置生成器在主机创建包装脚本，实现无缝透明的用户体验，可直接调用WiX工具（如candle、light）如同原生应用，并能处理参数中的相对和绝对路径。https://github.com/felfert/docker-wix

核心功能与特性

• 简化使用流程：无需修改Dockerfile或使用复杂的Wine命令语法
• 自动生成包装脚本：内置生成器可在主机创建包装脚本及符号链接
• 透明用户体验：直接调用WiX工具（如candle、light）如同使用原生Linux应用
• 路径处理能力：智能处理参数中的相对路径和绝对路径
• 安全的环境变量管理：仅将以WIX_ 开头的环境变量传播至容器

使用场景与适用范围

适用于需要在Linux系统上使用WiX工具集（如编译Windows安装程序）的开发者，尤其适合希望避免复杂配置、快速实现WiX工具调用的场景。

使用方法

首次使用

在开始常规使用前，需在主机系统为WiX工具创建包装脚本。使用特殊命令mkhostwrappers完成，步骤如下：

1. 进入PATH环境变量中的合适目录（确保有写入权限）
2. 运行以下命令生成并执行包装脚本：

bash
docker run --rm felfert/wix mkhostwrappers | sh

注意：无需添加通常的-it参数。

若需在/usr/local/bin等需管理员权限的目录创建，使用：

bash
docker run --rm felfert/wix mkhostwrappers | sudo sh

也可创建新目录并后续调整PATH变量指向该目录。

上述命令会创建主包装脚本（如candle）及多个符号链接。此后即可像使用原生Linux应用一样调用WiX工具。

日常使用示例

生成包装脚本后，可直接执行WiX命令，例如：

bash
candle MyProduct.wxs  # 编译.wxs文件为.wixobj
light -sval MyProduct.wixobj  # 链接.wixobj生成安装程序（需禁用msi验证）

已知限制

• 环境变量限制：出于安全考虑，仅以WIX_ 开头的环境变量会被传播至容器。若需在WiX中使用${env.VARNAME}特性，变量名必须以此前缀开头。
• 镜像体积：标准镜像体积约1GB。提供实验性slim版本（标签felfert/wix:latest-slim），体积缩减至856MB，但因Alpine的wine包无法安装WiX必需的dotnet40组件，标准版本仍使用较大基础镜像。

已知问题

• light工具必需参数：使用light工具时必须添加-sval选项禁用msi验证，否则在wine环境下会执行失败。
• 环境变量路径处理：当WIX_开头的环境变量值包含绝对路径时，不会自动调整路径格式，需手动在路径前添加/work前缀。