# 开始使用（高级）

CoolQ C++ SDK 提供了一个基本的 项目模板，如果你需要快速地进行体验或者做一些概念验证，不妨直接使用模板；而如果你已经有适合自己或团队的 C++ 和 CMake 项目框架，也可以进行手动配置，本 SDK 的 CMake 配置基本上是非侵入式的。

# 使用模板

直接克隆模板仓库，或者先「Use this template」再克隆你的账号下新建的仓库，并初始化子模块：

# 直接克隆模板仓库
git clone https://github.com/cqmoe/cqcppsdk-template.git awesome-bot
cd awesome-bot
git submodule update --init # 初始化 Git 子模块

# 或者，通过 use this template 从模板创建新仓库后再克隆
git clone https://github.com/yourname/awesome-bot.git awesome-bot
cd awesome-bot
git submodule add https://github.com/cqmoe/cqcppsdk.git extern/cqcppsdk # 添加 Git 子模块

然后运行：

cmake -B build # CMake 配置

来产生工程文件，接着运行：

cmake --build build --target app_dev # CMake 生成

即可构建 dev 模式的可执行文件，运行 ./build/app_dev 会进入一个交互式命令行，输入内容后会产生一个模拟的私聊消息，触发私聊消息事件处理，可进行基本的功能测试。

若要构建能在 酷Q 开发模式运行的 app.dll，需在 Windows 环境下使用 MSVC x86 来构建：

cmake -B build -G 'Visual Studio 16 2019' -A Win32
cmake --build build --target app

将构建出的 app.dll 和项目根目录的 app.json 拷贝到 酷Q 的 dev/com.example.demo 目录中（需手动创建），然后打开 酷Q 的开发模式（见 开发模式），再在应用管理里面启用即可。

# 手动配置

这里假设你的项目结构与 SDK 项目模板类似：

.
├─extern (第三方依赖库)
│  └─curl
├─src (项目源文件)
│  └─app.cpp
└─CMakeLists.txt

首先需要将 CoolQ C++ SDK 导入项目中，可以直接下载 cqcppsdk 到 extern 目录，也可以添加 Git 子模块：

git submodule add https://github.com/cqmoe/cqcppsdk.git extern/cqcppsdk

再在你的 CMakeLists.txt 中添加如下内容：

set(CMAKE_CXX_STANDARD 17) # 设置 C++ 标准版本为 C++17

include(extern/cqcppsdk/cqcppsdk.cmake) # 包含 SDK 的 CMake 脚本

cq_set_app_id("com.your-company.awesome-bot") # 设置 app id, 见酷Q文档

if (CQ_CAN_BUILD_STD_MODE)
    cq_add_std_app(src/app.cpp) # 添加 std 模式的动态链接库构建目标
    cq_install_std_app() # 向 CMAKE_INSTALL_PREFIX 指定的 酷Q 位置安装应用
endif ()

# 添加 dev 模式的可执行文件构建目标
cq_add_dev_app(src/app.cpp)

然后在 src/app.cpp 中使用 SDK 即可：

#include <cqcppsdk/cqcppsdk.hpp>

CQ_INIT {
    cq::on_private_message([](const cq::PrivateMessageEvent &event) {
        if (event.message == "你好") {
            try {
                cq::send_message(event.target, "你也好～");
            } catch (cq::ApiError &) {
            }
        }
    });
}