运行第一个 C++ 窗口

准备工具和 SDK

安装 Visual Studio 2022 的 C++ 桌面工具和 CMake。解压 C++ SDK，确认 cmake、include、lib 和 bin 目录齐全。使用匹配的 x64 工具链，不把仓库内的私有头文件加入工程。

创建 CMake 工程

创建空目录，把下列内容保存为 CMakeLists.txt。Kui::Kui 是 SDK 的导入目标，kui_copy_runtime_dlls 会复制目标需要的运行库。

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)

创建窗口

把下面的代码保存为 main.cpp。这里显式设置窗口配置。窗口显示一段 HTML、一个标题和按钮；业务事件可在下一课继续接入。

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();
}

构建并检查结果

把 Kui_DIR 改成解压 SDK 的实际 cmake 目录。运行后应看到 Hello KUI 窗口和按钮；若找不到 DLL 或链接失败，先核对架构、Debug/Release 和运行库目录。

powershell

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

第一次运行的顺序

在入门工程解压目录运行命令，不是在 SDK 根目录。SDK 是依赖，课程 ZIP 是你的应用。

解压 SDK 到固定目录；路径可以自定，确认 cmake/ 下有 KuiConfig.cmake。
解压 first-window.zip，进入包含 CMakeLists.txt 和 main.cpp 的目录。
在 PowerShell 中输入 SDK 包要求的编译标准，配置 x64，再构建 Release。
运行 build/Release/first_window.exe。看到 Hello KUI 后，再开始改页面。

改一处，确认编译链路

在 main.cpp 中把 Hello KUI 改成自己的应用名，关闭旧窗口并重新构建、运行。标题变化说明你打开的是本次产物。入门按钮只有外观，点击没有保存效果是正常的。

文档有误或遗漏？

反馈此页问题 →