Erlang/OTP Windows平台编译指南：从源码构建到安装部署

Erlang/OTP Windows平台编译指南：从源码构建到安装部署

otp Erlang/OTP 项目地址: https://gitcode.com/gh_mirrors/ot/otp

前言

本文详细介绍如何在Windows平台上从源码构建Erlang/OTP运行时环境及标准库。对于大多数用户而言，直接使用官方提供的二进制发行版是最简便的选择。但如果您需要自定义构建、参与开发或进行深度调试，从源码构建是必经之路。

环境准备

基础工具链

1. WSL环境：需要Windows 10 1809及以上版本支持WSL 1，推荐使用Ubuntu 18.04发行版
2. Visual Studio 2019：安装时需包含C++开发工具和Windows SDK组件
3. Java开发套件（可选）：JDK 8或更高版本，用于构建jinterface模块
4. NSIS安装系统（可选）：3.05或更高版本，用于生成安装包

可选依赖项

1. OpenSSL：推荐1.1.1d或更高版本，预编译二进制包可直接使用
2. wxWidgets：推荐3.2.2.1或更高版本，需自行编译静态库版本

详细构建步骤

1. 源码获取与准备

将Erlang/OTP源码解压到Windows磁盘分区（如/mnt/c/src/），并设置环境变量：

ERL_TOP=/mnt/c/src/otp_src_%OTP-REL%
export ERL_TOP

2. 构建环境配置

安装必要的编译工具：

sudo apt update && sudo apt install g++-mingw-w64 gcc-mingw-w64 make

初始化构建环境（以64位为例）：

cd $ERL_TOP
eval `./otp_build env_win32 x64`

3. 完整构建流程

执行以下命令序列完成构建：

./otp_build configure
./otp_build boot -a
./otp_build release -a
./otp_build installer_win32

生成的安装包位于release/win32/目录下，可使用静默安装参数：

release/win32/otp_win64_%OTP-REL% /S

开发与调试

增量构建技巧

1. 仅构建模拟器：

   cd $ERL_TOP/erts/emulator
   make opt
   

2. 调试版本构建：

   cd $ERL_TOP/erts/emulator
   make debug
   

3. 单个模块构建：

   cd $ERL_TOP/lib/stdlib
   make opt
   

环境变量管理

开发时需特别注意PATH设置：

export PATH=$ERL_TOP/erts/etc/win32/wsl_tools/vc:$ERL_TOP/erts/etc/win32/wsl_tools:$ERL_TOP/bootstrap/bin:$PATH

技术实现细节

Windows特有实现

所有Windows平台相关代码都集中在特定目录：

• C代码：$ERL_TOP/erts/emulator/sys/win32
• 驱动程序：$ERL_TOP/erts/emulator/drivers/win32
• 工具脚本：$ERL_TOP/erts/etc/win32

跨平台代码规范

Erlang代码应通过运行时检测实现平台适配：

case os:type() of
    {win32,_} -> do_windows_specific();
    _ -> do_universal_or_exit()
end

常见问题解答

Q：为什么必须使用VC++而非GCC？

A：虽然部分文件使用GCC编译（如利用labels-as-values特性优化性能的beam_emu.c），但整体上VC++生成的代码性能更优，特别是SMP版本的性能差异显著。

Q：能否使用Visual Studio IDE进行开发？

A：不建议。OTP的构建过程涉及大量自动化步骤，使用Makefile体系是更可靠的选择。维护VS项目文件的成本过高且不切实际。

Q：32位和64位构建有何区别？

A：主要区别在于构建参数和目标目录命名。64位构建中会出现win64标识，但大多数路径仍保留win32名称以保持兼容性。

结语

通过WSL环境在Windows上构建Erlang/OTP虽然步骤较多，但掌握了这套方法后，您将能够：

1. 灵活定制Erlang运行时环境
2. 参与Erlang/OTP的核心开发
3. 构建特定优化的发行版本

建议首次构建时严格遵循完整步骤，熟悉后再尝试定制化方案。对于Windows平台特有的开发需求，请确保将代码放在正确的平台特定目录中。

otp Erlang/OTP 项目地址: https://gitcode.com/gh_mirrors/ot/otp