使用向导创建 SOUI 项目¶

SOUI 项目向导是为了简化项目创建和配置过程而设计的工具，能够帮助开发者快速搭建 SOUI 开发环境，避免重复的手动配置工作。

概述¶

向导的优势¶

快速创建：通过简单的选择即可自动配置完整项目
即时可用：创建后立即可编译并查看 UI 布局效果
版本适配：支持多个 Visual Studio 版本
免重启：安装后无需重启系统即可使用

适用场景¶

初学者快速入门 SOUI 开发
经验开发者避免重复配置
快速原型开发和测试
标准化项目结构创建

向导安装¶

安装准备¶

系统要求： - Windows 操作系统 - Visual Studio 2008/2010/2012/2013/2015/2017/2019/2022 任意版本 - 管理员权限（用于安装向导）

重要提示： - 安装前请关闭所有已打开的 Visual Studio 实例 - 使用哪个版本的 SOUI，就安装对应版本的向导

安装步骤¶

定位安装文件 在 SOUI 项目根目录下找到 wizard 文件夹
运行安装程序 双击执行 wizard.setup.exe 启动安装向导
选择 Visual Studio 版本
安装程序会自动检测系统中安装的 VS 版本
选择目标 Visual Studio 版本
点击“安装”按钮开始安装过程
完成安装 安装成功后将显示确认信息

安装验证¶

重新打开 Visual Studio，在“新建项目”中应该能够在“Visual C++”分类下找到“SOUI 应用程序向导”选项。

注意事项： - 向导已经进行优化，安装后无需重启系统 - 但已打开的 VS 实例需要重新启动才能识别新环境变量

使用向导创建项目¶

创建步骤¶

启动新建项目向导
打开 Visual Studio
选择“文件” → “新建” → “项目”
或使用快捷键 Ctrl+Shift+N
选择项目模板
在“新建项目”对话框中展开“Visual C++”
找到并选择“SOUI 应用程序向导”
配置项目信息
项目名称：输入有意义的项目名称
位置：选择项目存储路径
解决方案名称：默认与项目名称相同
点击“确定”按钮
配置 SOUI 项目选项 在 SOUI 向导页面中配置以下选项：

资源存储方式： - ☑️ 编译进 EXE 文件：资源嵌入可执行文件，单文件分发 - ☐ 外部资源文件：资源以文件形式存储，便于调试修改

项目类型： - ☑️ 标准应用程序：创建常规的 SOUI 应用程序 - ☐ 对话框应用：创建基于对话框的应用程序

完成创建 点击“完成”按钮，向导将自动：
创建项目文件结构
配置编译环境
生成示例代码和资源
设置项目属性

项目结构说明¶

向导创建的项目包含以下结构：

ProjectName/
├── uires/                 # UI 资源文件夹
│   ├── uires.idx         # 资源索引文件
│   ├── xml/              # XML 布局文件
│   │   ├── init.xml      # 全局初始化
│   │   └── dlg_main.xml  # 主窗口布局
│   └── image/            # 图片资源
├── source/               # 源代码文件
│   ├── MainDlg.h/.cpp    # 主窗口类
│   └── main.cpp          # 程序入口
└── ProjectName.vcxproj   # VS 项目文件

立即运行¶

项目创建完成后，可以直接：

编译运行：按 F5 或点击“运行”按钮
查看效果：将显示一个简单的 SOUI 应用程序窗口
开始开发：在此基础上进行 UI 设计和功能开发

常见问题与解决¶

安装问题¶

Q: 向导安装后在 VS 中找不到 SOUI 项目模板？

A: 检查以下几点： - 确认安装时选择了正确的 VS 版本 - 完全重新启动 Visual Studio - 检查是否以管理员权限运行安装程序

Q: 编译错误：找不到 SOUI 头文件？

A: 检查 SOUI 环境变量配置： - 验证 SOUI4PATH 环境变量是否正确设置 - 重新安装 SOUI 向导并重启 VS

运行问题¶

Q: 程序运行时出现 DLL 丢失错误？

A: 处理方案： - 确认 SOUI 动态库路径在系统 PATH 中 - 或者将所需 DLL 复制到可执行文件目录 - 考虑使用静态链接方式

下一步¶

成功创建 SOUI 项目后，可以：

⭐️ 学习 XML 布局：修改 dlg_main.xml 设计界面
🎨 设计皮肤：在 init.xml 中定义皮肤和样式
⚙️ 添加逻辑：在 MainDlg.cpp 中实现业务逻辑
📚 参考文档：阅读 SOUI 官方文档和示例

提示：向导创建的项目包含了完整的示例代码和注释，是学习 SOUI 开发的良好起点。建议初学者从理解项目结构和基本概念开始。