dactiv/wix

Docker Wix镜像说明

镜像概述

本镜像包含WiX Toolset工具集，可让支持Docker的任意系统（如macOS、Linux）构建Windows MSI安装包，无需在本地安装Windows环境或WiX依赖。预编译镜像可从Docker Hub获取。

核心功能

1. 内置WiX Toolset全套可执行文件（如candle.exe、light.exe），并添加到环境变量PATH中
2. 支持挂载本地目录到容器工作目录/wix，直接处理本地WiX配置文件
3. 跨平台兼容，解决非Windows系统无法构建MSI包的问题

使用场景

• 非Windows系统（macOS/Linux）开发者需要构建Windows安装包
• 希望统一构建环境，避免本地安装WiX Toolset带来的依赖冲突
• 自动化CI/CD流程中集成MSI包构建步骤

配置说明

前提条件

需安装Docker Desktop（官网下载）

基本使用

1. 拉取镜像：

sh
docker pull dactiv/wix

2. 运行WiX命令（如candle.exe）：

sh
docker run --rm dactiv/wix candle

3. 挂载本地目录处理文件（将当前目录挂载到容器/wix）：

sh
docker run --rm -v $(pwd):/wix dactiv/wix candle sample.wxs

示例：构建MSI包

1. 进入示例目录：

sh
cd sample

2. 编译WiX源文件：

sh
docker run --rm -v $(pwd):/wix dactiv/wix candle sample.wxs

3. 链接生成MSI包（禁用验证避免Win32异常）：

sh
docker run --rm -v $(pwd):/wix dactiv/wix light sample.wixobj -sval

生成的sample.msi将保存在当前目录。

已知问题

light命令验证失败

执行light时可能出现Win32异常错误，解决方案是添加-sval参数禁用验证：

sh
docker run --rm -v $(pwd):/wix dactiv/wix light sample.wixobj -sval