一、软件简介

oat++ 是一个轻量级高性能 Web 服务开发框架，采用纯 C++ 编写而成。
官网：https://oatpp.io/ 这个坑爹的网址在国内经常打不开，要多刷新几次。
Github: https://github.com/oatpp/oatpp

当前版本： 1.3.0

其主要特性有：

•   随处运行
Oat++ 没有任何依赖性，可以很容易地移植到各种支持的平台上（Linux、MacOS、Windows）。
•   构建健壮的api
使用 Oat++ Simple-API，构建灵活而健壮的 API 既简单又有趣。
•   处理 500 万个连接
使用 Oat++ Async-API，可以在单个服务器上处理超过 500 万个并发连接。
•   访问数据库
Oat++ ORM 提供了一种简单而统一的方式来访问数据库
•   保持代码一致
Oat++ 在整个代码库中依靠对象映射来确保 API 和数据模型的一致性
•   生成 API 文档
使用 Swagger-UI 和 OpenAPI 3.0.0 自动记录 endpoints

二、环境要求

• Git
https://git-scm.com/
当前版本2.39.1

• CMake
https://cmake.org/
当前版本3.25.1

• Microsoft Visual Studio
https://visualstudio.microsoft.com/zh-hans/
我使用的是Community 2022版，安装的时候至少要选择“使用C++的桌面开发”，如果要使用MFC，还要选择“适用于最新v143生成工具的C++ MFC （x86和x64）”以及“Visual Studio 扩展开发”

另外我使用的操作系统是Windows 7 旗舰版

三、安装OAT++

在oat++的官网上，安装非常简单，就几行命令。

这几个命令的问题是：只能安装debug win32 的版本，没有release win32 版本的，也没有x64版本的。还有一个问题是github.com 经常连不上。所以我把安装过程改了改。
我们这个文档是给不喜欢使用命令行的同学看的，对于喜欢命令行的同学来说，可以直接使用git和cmake命令。

首先下载oat++源码
运行windows开始菜单里的“Git GUI”

点击Clone Existing Repository

Source Location输入：https://gitee.com/mirrors/oatpp.git
这里用的是镜像站点https://gitee.com/mirrors/oatpp.git，这是国内的网站，速度会快一些。当然你也可以使用原始站点：https://github.com/oatpp/oatpp.git
Target Directory输入：D:\code\oatpp
这是存放源代码的文件夹，要保证这个文件夹是空的。如果没有这个文件夹，倒是没什么关系，Git GUI会自动创建文件夹。

点击Clone按钮，开始下载源代码。下载完成后，会打开工作窗口

这个窗口我们不使用，直接关掉。
现在我们打开oatpp文件夹，就可以看到里面的源码了：

接着建立工作目录

建立两个文件夹x64和win32，这两个文件夹用来作为工作目录

运行windows开始菜单里的“CMake (cmake-gui)”

点击Browse Source…按钮，选择oatpp文件夹，这是设置源代码所在的文件夹
点击Browse Build…按钮，选择x64文件夹，这是设置工作目录

点击Configure按钮

点击Optional platform for generator (if empty, generator uses: x64)下面的下拉框

选择x64 , 这样编译出来的就是x64版本的软件。如果要编译win32版本的，就选择Win32

点击Finish按钮，回到CMake主窗口

点击Generate按钮

窗口最下面出现“Generating done”，就说明Generate工作完成。

现在我们打开x64文件夹就会看到里面已经产生了Visual Studio的解决方案

双击oatpp.sln文件，启动Visual Studio

我们可以看到，现在是在Debug x64模式下，如果要编译Release x64版本，就要点击Debug下拉框，改成Release。如果要编译win32版本，就要在上文提到的CMake里面设置Optional platform for generator (if empty, generator uses: x64)为win32

右击解决方案资源管理器中的“INSTALL”,在弹出菜单中选择“生成”，等几分钟，等它运行结束之后，我们查看输出窗口

可以看到oat++已经被安装到C:\Program Files\oatpp 文件夹了
文件夹C:\Program Files\oatpp\lib\oatpp-1.3.0 里面的oatpp.lib文件，就是我们需要的库文件，它是Debug x64版本的
文件夹C:\Program Files\oatpp\include里面就是头文件
另外x64\src\Debug文件夹下面也有库文件