# 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 克隆代码）

## 快速构建

### 构建所有配置
```bash
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
```bash
build_x86.bat
```

### 单独构建 x64
```bash
build_x64.bat
```

## Visual Studio 开发

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

```bash
configure_vs.bat
```

这将生成 CMake 解决方案文件，然后可以打开：
- `build_x86\EzUI.sln` (x86 项目)
- `build_x64\EzUI.sln` (x64 项目)

## 清理构建输出

```bash
clean.bat
```

这将删除以下目录：
- `build_x86/` - x86 构建目录
- `build_x64/` - x64 构建目录
- `lib/` - 静态库输出目录

## 手动 CMake 命令

如果你想使用 CMake 命令行：

```bash
# 配置 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`