Skip to content

使用向导创建 SOUI 项目

Warning

The current page still doesn't have a translation for this language.

You can read it through google translate.

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

概述

向导的优势

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

适用场景

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

向导安装

安装准备

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

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

安装步骤

  1. 定位安装文件 在 SOUI 项目根目录下找到 wizard 文件夹

  2. 运行安装程序 双击执行 wizard.setup.exe 启动安装向导

  3. 选择 Visual Studio 版本

  4. 安装程序会自动检测系统中安装的 VS 版本
  5. 选择目标 Visual Studio 版本

  6. 点击“安装”按钮开始安装过程

  7. 完成安装 安装成功后将显示确认信息

安装验证

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

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

使用向导创建项目

创建步骤

  1. 启动新建项目向导
  2. 打开 Visual Studio
  3. 选择“文件” → “新建” → “项目”

  4. 或使用快捷键 Ctrl+Shift+N

  5. 选择项目模板

  6. 在“新建项目”对话框中展开“Visual C++”

  7. 找到并选择“SOUI 应用程序向导”

  8. 配置项目信息

  9. 项目名称：输入有意义的项目名称
  10. 位置：选择项目存储路径
  11. 解决方案名称：默认与项目名称相同

  12. 点击“确定”按钮

  13. 配置 SOUI 项目选项 在 SOUI 向导页面中配置以下选项：

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

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

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

项目结构说明

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

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

立即运行

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

  1. 编译运行：按 F5 或点击“运行”按钮
  2. 查看效果：将显示一个简单的 SOUI 应用程序窗口
  3. 开始开发：在此基础上进行 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 开发的良好起点。建议初学者从理解项目结构和基本概念开始。