thewtex/cross-compiler-windows-x64

thewtex/cross-compiler-windows-x64镜像说明

镜像概述

本镜像基于MXE/MinGW-w64提供64位Windows交叉编译环境，旨在帮助开发者在Docker容器中高效完成跨平台编译任务，避免本地环境配置的复杂性。

核心功能

• 提供多种交叉编译工具链，满足不同场景需求；
• 以调用用户身份执行容器内命令，确保生成文件的所有权正确（非root）；
• 自动设置Make变量（如CC、LD）指向容器内合适工具；
• 预编译最新版本的cmake和ninja，提供cmake工具链文件；
• 将当前目录挂载为容器工作目录/build，方便文件交互；
• 兼容OSX的boot2docker和Docker for Mac beta（1.11.1-beta12）。

使用场景

• 跨平台开发：在非Windows系统上编译Windows应用程序；
• 项目构建：快速构建依赖MinGW-w64的Windows项目；
• 持续集成：集成到CI/CD流程中，实现自动化跨平台编译。

配置说明

环境变量与命令行选项

以下选项中，命令行选项优先级高于环境变量：

• DOCKCROSS_CONFIG / --config|-c <路径>：脚本执行前会 sourcing 该配置文件，默认路径为~/.dockcross；
• DOCKCROSS_IMAGE / --image|-i <镜像名>：指定要运行的交叉编译镜像，默认是生成脚本时使用的镜像；
• DOCKCROSS_ARGS / --args|-a <参数>：传递给docker run的额外参数。

内置更新命令

• dockcross [--] command [args...]：强制在容器内运行命令（避免与内置命令冲突时使用--）；
• dockcross update-image：拉取最新版本的镜像；
• dockcross update-script：更新本地dockcross脚本；
• dockcross update：同时更新镜像和脚本。

部署示例

安装helper脚本

bash
docker run --rm thewtex/cross-compiler-windows-x64 > ./dockcross-windows-x64
chmod +x ./dockcross-windows-x64
mv ./dockcross-windows-x64 ~/bin/

编译Hello World示例

bash
# 使用脚本编译hello.c为Windows 64位可执行文件
./dockcross-windows-x64 bash -c '$CC test/C/hello.c -o hello_windows_x64.exe'

常用命令示例

1. 构建Makefile项目：dockcross-windows-x64 make；
2. 用cmake生成Ninja构建文件：dockcross-windows-x64 cmake -Bbuild -H. -GNinja；
3. 运行Ninja构建：dockcross-windows-x64 ninja -Cbuild；
4. 执行shell命令：dockcross-windows-x64 bash -c 'find . -name *.o | sort > objects.txt'。

注意：若需shell处理（如环境变量展开、重定向），请使用bash -c 'command args...'形式执行命令。