EzUI/BUILD.md

EzUI 构建说明

前置要求

必需工具

1. CMake (版本 3.0 或更高)

   • 下载地址：https://cmake.org/download/
   • 安装后建议将 CMake 添加到系统 PATH 环境变量
   • 脚本会自动在以下位置查找 CMake：
     • 系统 PATH 中的 cmake
     • C:\Program Files\CMake\bin\cmake.exe

2. Visual Studio 2022 (包含 C++ 构建工具)

   • 社区版即可免费使用
   • 下载地址：https://visualstudio.microsoft.com/downloads/
   • 安装时需要选择"使用 C++ 的桌面开发"工作负载

可选工具

• Git - 用于版本控制（如需从 GitHub 克隆代码）

快速构建

构建所有配置

build_all.bat

这将自动构建以下所有配置：

• x86 Debug → lib\EzUI_Debug_Win32.lib
• x86 Release → lib\EzUI_Release_Win32.lib
• x64 Debug → lib\EzUI_Debug_x64.lib
• x64 Release → lib\EzUI_Release_x64.lib

单独构建 x86

build_x86.bat

单独构建 x64

build_x64.bat

Visual Studio 开发

如果需要在 Visual Studio 中开发和调试：

configure_vs.bat

这将生成 CMake 解决方案文件，然后可以打开：

• build_x86\EzUI.sln (x86 项目)
• build_x64\EzUI.sln (x64 项目)

清理构建输出

clean.bat

这将删除以下目录：

• build_x86/ - x86 构建目录
• build_x64/ - x64 构建目录
• lib/ - 静态库输出目录

手动 CMake 命令

如果你想使用 CMake 命令行：

# 配置 x86
cmake -S . -B build_x86 -A Win32

# 配置 x64
cmake -S . -B build_x64 -A x64

# 编译 x86 Debug
cmake --build build_x86 --config Debug --target EzUI

# 编译 x86 Release
cmake --build build_x86 --config Release --target EzUI

# 编译 x64 Debug
cmake --build build_x64 --config Debug --target EzUI

# 编译 x64 Release
cmake --build build_x64 --config Release --target EzUI

输出文件

所有静态库文件将输出到 lib/ 目录，命名规则为：

配置	平台	输出文件
Debug	x86	lib\EzUI_Debug_Win32.lib
Release	x86	lib\EzUI_Release_Win32.lib
Debug	x64	lib\EzUI_Debug_x64.lib
Release	x64	lib\EzUI_Release_x64.lib

构建配置说明

• 始终编译为静态库：不再支持动态库选项
• 输出目录：所有库文件统一输出到 lib/ 目录
• 命名规则：EzUI_$(Configuration)_$(Platform).lib
• 字符编码：使用 UTF-8 编译 (/utf-8)
• Unicode：启用 Unicode 支持
• 预处理器定义：静态库会自动定义 EZUI_STATIC