aino 以原生桌面体验和低空闲开销为目标。核心库集中在 aino.hpp,直接使用各平台窗口、
字体与系统接口,不依赖第三方 UI 框架。界面采用 macOS 风格,背景材质以 CPU 模糊近似。
以下为 Windows 示例实窗截图。
分组设置![]() |
组件画廊![]() |
按钮与输入控件![]() |
深色外观![]() |
关于页面![]() |
基础图元![]() |
- 单头文件:核心实现位于
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。
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(¬ify, "邮件通知", 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_galleryCMake 自动扫描 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_demossh_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 后端。
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;
工具说明见 开发工具。
正式 Wiki 索引 · 在线 Wiki · 网站预览与发布 · 工程审查记录
- 01 快速开始
- 02 样式与主题
- 03 布局
- 04 文本类组件
- 05 容器类组件
- 06 交互类组件
- 07 展示类组件
- 08 浮层类组件
- 09 图元与度量
- 10 逐组件性能实测(历史基准)
- 11 动画与变换
- 12 组件与示例索引
- 文档索引
Copyright © 2026 sudoevolve(sudoevolve@gmail.com)
Apache License 2.0。可以商用、修改、再分发,保留版权与许可声明即可。





