SOUI5 开发环境搭建¶

本文将指导您如何搭建 SOUI5 的开发环境。

环境要求¶

软件要求¶

必需软件¶

• Windows XP及以上
• Visual Studio（支持 2008 及以上版本）
• Git 版本控制工具

推荐软件¶

• Visual Studio 2019 或 2022
• CMake 3.16 或更高版本

环境搭建步骤¶

1. 安装开发工具¶

安装 Visual Studio¶

1. 下载 Visual Studio
2. 访问 Visual Studio 下载页面

3. 选择合适的版本（推荐 Community 版本）

4. 安装必要组件

5. C++ 桌面开发
6. Windows SDK
7. MFC 库
8. ATL 库

安装 Git¶

1. 下载 Git for Windows
2. 按默认选项安装即可

2. 获取 SOUI5 源码¶

# 克隆主仓库
git clone https://github.com/soui4/soui.git

# 切换到 master 分支
cd soui
git checkout master

3. 编译 SOUI5¶

使用 VS 直接编译¶

# 创建构建目录
mkdir build
cd build
cmake -G "Visual Studio 16 2019" -A x64 ..

使用命令行编译¶

# 创建构建目录
mkdir build
cd build

# 配置 CMake
cmake ..

# 编译
cmake --build . --config Release

配置开发环境¶

1. 安装VS向导¶

运行wizard/wizard.setup.exe, 在界面中选择自己的目标VS版本。

2. 验证安装¶

打开VS，创建新项目，选择soui5，创建成功后，运行项目。

常见问题¶

1. 编译错误¶

问题：找不到头文件¶

• 检查包含目录设置
• 确认 SOUI4PATH 环境变量正确设置, 如果刚安装向导，可以考虑关闭所有打开的VS进程再重新打开，确保环境变量在VS进程内生效

2. 运行错误¶

问题：DLL 加载失败¶

• 确认 Path 环境变量包含 SOUI 运行库路径
• 检查程序与 DLL 的位数是否匹配

开发工具推荐¶

辅助工具¶

• SoUIEditor：SOUI 界面编辑器
• ResBuilder：资源打包工具
• CodeFormat：代码格式化工具

调试工具¶

• Debug View：输出调试信息
• souispy++：窗口层次分析

下一步¶

完成环境搭建后，建议：

1. 运行示例程序熟悉基本功能
2. 学习 基础概念
3. 跟随 项目实战 创建第一个应用

参考资源¶

• SOUI4 GitHub
• Visual Studio 下载
• CMake 官网