Files
Vivid2DRenderer/README.md
lyxyz5223 e3b42e4f70 feat(Logger): Add a universal logger
- Add a Logger framework
- Add a spdlog logger adapter
- Update README and vcpkg.json
- fix some language error
2025-11-16 15:10:59 +08:00

2.3 KiB
Raw Permalink Blame History

Vivid2DRenderer 项目构建指南

本指南详细介绍了如何设置开发环境并构建 Vivid2DRenderer 项目。

作者信息

  • 作者: tzdwindows 7
  • QQ 3076584115

一、先决条件

在开始之前,请确保你已经安装了以下软件:

  1. Visual Studio (VS): 推荐使用最新版本,并确保安装了 C++ 桌面开发工作负载。
  2. vcpkg: 微软的 C/C++ 库管理器。

二、配置 vcpkg

vcpkg 用于下载和安装项目所需的第三方库。 下列方法二选一:

  1. 手动安装vcpkg
    1. 下载并引导 vcpkg:
    • 克隆 vcpkg 仓库或下载压缩包。
    • 运行引导脚本Windows 上通常是 .\bootstrap-vcpkg.bat)。
    1. 安装项目依赖库: 打开命令行或 PowerShell进入 vcpkg 目录,然后运行以下命令来安装项目所需的库:
    .\vcpkg install glfw3 glew stb glad spdlog glm stduuid
    
    • 此命令将下载并安装 glfw3 (窗口和上下文管理)、glew/glad (OpenGL 扩展加载)、stb (图像处理/加载等)、spdlog (日志记录) 和 glm (数学库)。
  1. 使用Visual Studio Installer安装的vcpkg
    • 使用Visual Studio打开项目点击 工具-命令行-开发者命令提示/开发者 PowerShell执行下列命令
    • vcpkg integrate install
    • (可选)执行下列命令,编译会自动执行
    • vcpkg install

三、使用 Visual Studio 构建项目

一旦依赖库安装完毕,你可以直接在 Visual Studio 中打开并构建项目。

  1. 打开项目:

    • 在 Visual Studio 中,打开 Vivid2DRenderer 项目的解决方案文件 (.sln) 或 CMake 项目文件夹。
  2. 配置 vcpkg 集成:

    • 如果项目使用的是 CMake并且你已经按照 vcpkg 的指引正确设置了环境变量或用户范围集成Visual Studio 通常会自动找到依赖库。
    • 如果需要手动集成,请确保 Visual Studio 知道 vcpkg 的安装路径,通常是通过运行 .\vcpkg integrate install 实现的。
  3. 构建:

    • 在 Visual Studio 中,选择你需要的配置(例如 DebugRelease)。
    • 在菜单栏中,选择 构建 (Build) -> 构建解决方案 (Build Solution)