Skip to content

v0.3.0,焕然一新的版本 (2026-07-07)

Latest

Choose a tag to compare

@Charliechen114514 Charliechen114514 released this 07 Jul 04:18
· 20 commits to main since this release

AwesomeQT在经过小两个月的各种痛苦的转型和打磨后,终于迈出了最艰难的一步:

进阶层全部完成(134 篇)、专家层启动(2/102 连载)、实例库从 1 件扩到 20 件真成品(控件 13 + 整机 7)、站点完成旗舰化改造(Qt 绿身份 + 三重 CI 质量门 + 可拖拽侧栏)。

已完成内容

进阶层 · Advanced — 全量完成(134 篇)

v0.2.0 上线了 QtBase 16 + QtGui 6 共 22 篇,本版补齐剩余 112 篇,进阶层 134 篇全部到位:

模块 篇数 说明
QtBase 16 v0.2.0 已上线
QtGui 6 v0.2.0 已上线
QtWidgets 74 布局 / 事件 / Model-View / QSS / 自定义绘制 / 对话框 / 主窗口 / 图形视图 / 动画 / MDI + 64 控件进阶
QtNetwork 6 TCP / UDP / HTTP / WebSocket / SSL / 串口
扩展模块 25 SQL / Charts / Multimedia / SVG / Bluetooth / MQTT / Modbus 等
QML 7 语法 / Controls / C++ 互操作 / 动画 / 模型视图

配套示例工程 examples/advanced/ 134 个,全部 CMake + Qt 6 可直接编译。

同时修复 issue #5:指针迭代的 const auto& 误导建议。

专家层 · Expert — 启动 + 规划敲定(2 / 102)

  • 规划清单从 142 收敛到 102:控件双轨制(复杂控件三层全做,8 个 trivial 控件标「无专家层」)+ 砍 8 个小众模块(NFC / SCXML / WebEngine 等稳定后再评估)。完整清单见 todo/expert.md。
  • 首批 2 篇成稿(源码拆解,每条结论带 qt_src/qt6.9.1 文件:行号 可复现证据):
    • 01 COW 隐式共享
    • 02 COW 容器实战
  • 配套基础设施:code-index(按源码机制分片的行号索引)、claims-registry(已查证结论 append-only 复用表)、.audit/ 交接单。

实例库 — 从 1 件扩到 20 件真成品

v0.2.0 只有 StatusLED 1 个控件,本版扩到 widget 13 + app 7 = 20 件。每件都是可独立编译的成品,配「成品导览 + 手搓手册」两套文档,统一 AwesomeQt:: 命名空间 + STATIC 库式构建。

widget 通用控件(13 件 · PR#10 / #14):

控件 类别
StatusLED / ToggleSwitch 状态 / 开关
CircleProgress / SpeedMeter / LineChart 自绘显示
RangeSlider / EditableTable / CheckboxTree / CheckboxList 交互输入
LogViewer / PasswordEdit / IpEdit 专项输入显示
FadeAnimation 动画

app 整机成品(7 件 · PR#16):

应用 说明
image-viewer 图片查看器(缩放 / 旋转 / 翻页 / 幻灯片)
json-editor JSON 编辑器(格式化 / 校验 / 树)
sqlite-browser SQLite 浏览器(表浏览 + 任意 SQL)
serial-tool 串口调试助手(收发 + Hex/ASCII)
network-tool TCP / UDP 调试工具
tetris 俄罗斯方块(自绘 + 消行计分)
cpu-memory-monitor CPU / 内存监控(Windows 路径待实机复验)

骨架就位:model 栏 undo-redo-framework(reference 范式)、industrial 栏 hmi-dashboard,待后续放量。

站点改进

旗舰化基建(PR#13)

  • 单一真相源:抽 shared.ts 统一 dev / build 双配置,根治历史 defineConfig 漂移。
  • CI 质量门(四道):
    • build-check — VitePress 构建验证
    • lint — markdownlint 强制拦截
    • content-quality — 内部链接可达性 + 专家层源码引用验真
    • build-examples — 275 个示例工程编译门(install-qt-action 装全套 Qt6 模块)
  • SEO 基础:sitemap.xml + robots.txt + favicon 修复,供搜索引擎收录。
  • 站点体验:代码折叠(>30 行)、字号五档切换、快捷键、页脚版本号、mermaid 图表渲染、首页 3D coverflow 轮播。
  • License NOTICE:代码 MIT / 文档 CC BY-SA 4.0 / Qt 源码引用按 Qt Company 许可,分档授权写清。
  • 贡献者入口:CONTRIBUTING / AGENTS / Issue & PR 模板。
  • third_party submodule 钉到 release tag(benchmark v1.9.5 / googletest v1.17.0)。

站点样式大更新(PR#17)

  • Qt 绿身份重塑:亮 / 暗双主题统一品牌色。
  • 可拖拽侧栏:左右栏宽度可调,localStorage 持久化。
  • 阅读进度条 + 长代码折叠 + 字号五档切换。

宣传门面统一

  • README 加在线站点入口、实例库双表(widget 13 + app 7)、进度数字纠正、markdownlint 清零。
  • 首页 tagline 改「聚焦 C++/QtWidgets · 三层递进 · 学→做闭合」。
  • 专家层导航页按 102 篇重写。

内容数据

指标 v0.2.0 v0.3.0
入门层教程 137 篇 137 篇
进阶层教程 22 篇 134 篇(+112)
专家层教程 0 篇 2 篇(连载中 · 规划 102)
代码示例工程 156 个 275 个(+119)
实例库成品 1 件 20 件(widget 13 + app 7)
构建系统 CMake 3.26+ CMake 3.26+
Qt 版本 6.9.1 6.9.1
C++ 标准 C++17/20 C++17/20
支持平台 Windows / Ubuntu / WSL2 同
静态文档站 VitePress VitePress(Qt 绿身份 + 拖拽侧栏)

开发中

  • 专家层 · Expert — 剩余 100 篇源码拆解(按 QtBase 硬核机制优先:MOC / activate 调用链 / 事件循环 / 对象树)
  • 实例库 model 栏放量(17 件照 undo-redo-framework 范式)
  • 实例库 industrial 栏 hmi-dashboard 成品化(复用 widget 递进链)