安装与首个窗口

第01课

准备: C++ SDK、CMake 与 x64 工具链
学完可以做: 运行一个可修改的原生窗口

准备编译环境

安装 Visual Studio 2022 的 C++ 桌面工作负载、CMake 和 Windows x64 C++ SDK。下载入门工程并解压。下面的 Kui_DIR 是示意路径，请改成 SDK 内 cmake 目录的位置。

CMake 工程

Kui::Kui 导入库负责头文件和链接依赖。kui_copy_runtime_dlls 为当前配置复制运行库。消费者仍须使用匹配的 CRT：Release /MD 或 Debug /MDd。

cmake

cmake_minimum_required(VERSION 3.20)
project(forge_kui_first_window LANGUAGES CXX)
if(NOT CMAKE_CXX_STANDARD)
  message(FATAL_ERROR "Set CMAKE_CXX_STANDARD to match the selected SDK package.")
endif()
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Kui 3 REQUIRED)
add_executable(first_window main.cpp)
target_link_libraries(first_window PRIVATE Kui::Kui)
kui_copy_runtime_dlls(first_window)

窗口与文档

Platform::init 初始化平台，Window::create 创建窗口。窗口的 Document 加载 HTML；show 显示窗口，Platform::run 处理消息。此工程的按钮尚未绑定业务事件，事件处理在第三课实现。

cpp

#include <kui/kui.h>
int main() {
    kui::Platform::init();
    kui::WindowConfig config;
    config.title = "Forge KUI";
    config.width = 900;
    config.height = 640;
    auto window = kui::Window::create(config);
    if (!window) return 1;
    window->document()->loadHTML(R"(
      <style>body { padding:48px; font-family:sans-serif; }
      button { padding:12px 24px; }</style>
      <h1>Hello KUI</h1><button>Save settings</button>
    )");
    window->show();
    return kui::Platform::run();
}

构建与运行

在工程目录打开 PowerShell。配置成功时应显示找到的 Kui 版本；编译产物和对应运行库位于 build/Release。运行程序后可看到 Hello KUI 标题和保存按钮。

powershell

$cxxStandard = Read-Host SDK-standard
cmake -S . -B build -A x64 "-DCMAKE_CXX_STANDARD=$cxxStandard" -DKui_DIR=G:/SDK/kui/cmake
cmake --build build --config Release --parallel 4
.\build\Release\first_window.exe

常见启动问题

找不到 KuiConfig.cmake 时检查 Kui_DIR。缺少 kui.dll 时确认复制步骤和运行目录。CRT 不匹配时核对 CMake 配置与 SDK 变体。窗口不出现时检查 Window::create 的返回值，以及 show 和事件循环是否执行。

继续制作设置页

动手练习与验收

用这些动作确认自己完成了本课，不必额外抄一份同样的代码。

独立找到 SDK 的 cmake 目录与工程 CMakeLists.txt。
把标题改成自己的名称，重建后新窗口显示修改。
从 build/Release 启动，确认没有借用旧 EXE。

文档有误或遗漏？

反馈此页问题 →