Skip to content
sudoevolvePublic

About

Single-header C++17 immediate-mode GUI library for Windows, Linux (X11), and macOS. macOS-inspired widgets, system fonts, and an event-driven loop. No third-party UI dependencies.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

aino logo

aino

跨平台 C++17 桌面 UI 库

单头文件 · 立即模式 · CPU 光栅化 · 事件驱动 · 空闲时阻塞等待

快速开始 · 特性 · 文档 · 官网与 Wiki · Apache-2.0

aino 以原生桌面体验和低空闲开销为目标。核心库集中在 aino.hpp,直接使用各平台窗口、 字体与系统接口,不依赖第三方 UI 框架。界面采用 macOS 风格,背景材质以 CPU 模糊近似。

Screenshots

以下为 Windows 示例实窗截图。

分组设置
分组设置
组件画廊
组件画廊
按钮与输入控件
按钮与输入控件
深色外观
深色外观
关于页面
关于页面
基础图元
基础图元

Features

  • 单头文件:核心实现位于 aino.hpp,C++17,无第三方 UI 依赖。
  • 事件驱动:无事件时阻塞等待;仅在需要时重绘,空闲时 CPU 占用接近 0。
  • CPU 光栅化:自绘几何、图像和材质效果,配合系统字体与窗口后端。
  • 原生平台后端:Windows GDI、macOS Cocoa、Linux X11。
  • 完整组件集:布局、主题、输入控件、表格、图表、浮层与动画等。
  • 图像支持:PNG、JPEG、BMP 与 GIF 首帧,可加载后复用并绘制。

开发规范

界面以 iOS/macOS 设置应用为视觉参考:

  • 按功能分组,同组条目放进一张圆角卡片;分组标题置于卡片外。
  • 使用系统字体、清晰的标题与说明层级、主题配色,兼容深浅外观。
  • 卡片默认圆角 12、左右内边距 16、设置项行高 64;标题和说明在左,控件居中贴右,分隔线缩进。
  • 内容区居中并限制宽度,窄窗口调整布局;文字完整显示,卡片底部留足间距,长内容可滚动。
  • 样式直接写在各示例内,保留交互与状态;修改后检查深浅主题、最小窗口及 DPI,并同步更新预览截图。

详细尺寸与参考示例见 AGENTS.md。

Quick Start

Requirements:

  • C++17 编译器:MSVC 19.29+、GCC 12+ 或 Clang 14+
  • 核心 UI 无第三方开发依赖,不要求构建系统或资源文件;系统运行库说明见下文

main.cpp:

#define AINO_IMPLEMENTATION          // 只能出现在一个编译单元里
#include "aino.hpp"

#include <string>

int main() {
    aino::Window win(880, 560, "aino 示例");
    if (!win.ok()) return 1;

    std::string email;
    bool notify = true;

    win.run([&](aino::Ui& ui) {
        ui.panel({24, 24, 400, 240});
        aino::Stack col = ui.vbox({24, 24, 400, 240}, 10.0f, 18.0f);
        ui.heading("设置", col.next(34.0f), aino::Style().left());
        ui.input(&email, col.next(24.0f), aino::Style().hint("you@example.com"));
        ui.checkbox(&notify, "邮件通知", col.next(22.0f));
        if (ui.button("保存", col.next(24.0f), aino::Style().primary())) {
            win.set_title("设置已保存");
        }
    });
    return 0;
}

Build:

# MSVC(/utf-8 必须加,否则中文字面量按 GBK 编;/MT = 静态链 CRT,目标机不用装运行库)
cl /std:c++17 /utf-8 /EHsc /O2 /MT main.cpp user32.lib gdi32.lib ole32.lib windowscodecs.lib

# MinGW(-static = 静态链接编译器运行时)
g++ -std=c++17 -O2 -mwindows -s -static main.cpp -o app.exe -lgdi32 -luser32 -lole32 -lwindowscodecs

# GCC / X11
g++ -std=c++17 -O2 main.cpp -o app -lX11 -ldl

-static 需要工具链提供完整静态运行时;不能全静态链接时,可使用 -static-libgcc -static-libstdc++ 并按导入表随附所需的 libwinpthread-1.dll。 MSVC 的 /MT 静态链接 CRT;应用仍使用平台系统 DLL。

Run:

./app.exe

仓库里自带的 gallery 示例:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
./build/Release/aino_gallery.exe  # Visual Studio;Ninja/Makefiles 使用 ./build/aino_gallery

CMake 自动扫描 examples/*.cpp,每个文件生成 aino_<文件名>; 新增或删除顶层示例源码后,构建会触发重新配置;Visual Studio 可能需重新加载后再构建一次。 也可先执行 cmake -S . -B build 更新目标。.hpp 不生成程序。 Visual Studio 产物在 build/Release/,Ninja/Makefiles 通常在 build/。

cmake --build build --config Release --target aino_primitives_demo

ssh_client.cpp 保留兼容目标名 aino_ssh,需额外安装 libssh2(MSVC 使用预编译 libssh2 + mbedTLS)。 默认关闭,-DAINO_BUILD_SSH=ON 显式启用并检查依赖;详见 构建说明。

win.run(frame_cb) 管理主循环,窗口按需重绘;动画与后台数据更新方式见 快速开始。

图片可使用 aino::Image 加载一次,再通过 ui.draw_image(image, box) 绘制; 支持 PNG、JPEG、BMP 和 GIF 首帧。Linux 运行时需要 GdkPixbuf。 可通过 WindowConfig::icon_path 自定义窗口图标;Windows 示例将默认 ICO 和 Gallery 图片嵌入可执行文件。 macOS Finder 图标需要 .app 和 .icns;Linux 桌面图标需要 .desktop 入口, 仅设置窗口图标不会改变文件管理器显示的图标。非 Windows 示例仍需旁置 PNG。详见 图元文档。

三个后端:Windows(GDI)、Linux(X11)和 macOS(Cocoa)。Windows 是唯一完成实机验收的后端; Linux/macOS 的绘制、输入、剪贴板与窗口路径已实现,原生桌面互通和多显示器仍需验收, 接入前请读 平台能力矩阵。Wayland 会话通过 XWayland 运行, 目前没有原生 Wayland 后端。

Project Layout

aino.hpp                     核心库
examples/gallery.cpp         组件画廊
examples/sidebar_demo.cpp    侧栏导航与设置
examples/pomodoro.cpp        番茄钟
examples/primitives_demo.cpp 基础图元
examples/function_viewer.cpp 函数可视化
examples/ssh_client.cpp      SSH/SFTP 客户端(可选依赖)
docs/wiki/                   正式教程与 API
docs/reviews/                工程审查与历史记录
docs/design/                 设计研究
site/                        官网与 Markdown Wiki 阅读器
screenshots/                 预览截图
tools/                       构建、测试与性能检查
CMakeLists.txt               示例构建配置

日常开发只编译受影响目标;发布验收使用 python tools/regress.py,完整检查加 --full; 工具说明见 开发工具。

Docs

正式 Wiki 索引 · 在线 Wiki · 网站预览与发布 · 工程审查记录

License

Copyright © 2026 sudoevolve(sudoevolve@gmail.com)

Apache License 2.0。可以商用、修改、再分发,保留版权与许可声明即可。

About

Single-header C++17 immediate-mode GUI library for Windows, Linux (X11), and macOS. macOS-inspired widgets, system fonts, and an event-driven loop. No third-party UI dependencies.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages