欢迎来到 HoneyGUI !

示例

_动态表盘	_水果忍者	_计算器
_表盘	_计时器	_{音乐播放器}
_矢量图形	_{3D 蝴蝶}	_{2.5D 足球}

介绍

HoneyGUI 是由 Realtek 自主研发的图形显示框架，它是一款专为资源受限的微控制器和嵌入式系统设计的开源嵌入式图形用户界面（GUI）库。HoneyGUI 具备轻量级、功能丰富和高度可定制性的特点，广泛应用于消费电子、家电、医疗设备和智能手表等领域。

HoneyGUI 提供基于 PC 的仿真环境，使开发者能够快速进行应用开发和调试，而无需依赖嵌入式硬件平台。同时，HoneyGUI 还可以与 Realtek 自研的前端设计工具 RVD 配合使用，实现可视化编程。

HoneyGUI 目前主要支持以下两种高效的 APP 开发方式：

C/C++ API 开发
- 开发者可以直接调用基于 RealGUI 显示引擎的 C/C++ API 来构建应用程序。
- 这种方式提供了最高的灵活性和对系统性能的极致控制，适合开发复杂的、对性能要求高的应用。
前端低代码开发
- 采用 JavaScript 和 XML 进行前端应用的开发。
- 推荐使用 RVisualDesigner，通过拖拽组件和可视化配置的方式，快速构建美观的 UI 界面，实现低代码开发，显著提升开发效率。
- 前端低代码开发方式提供了快速开发和迭代的优势，特别适合于快速原型设计和小规模应用开发。

HoneyGUI 框架具有很强的可移植性，可以在多种芯片和 OS 上运行。此次提供了 PC Windows 版本。

版本管理

HoneyGUI 遵循四段式版本号命名规范：

格式： v{主版本}.{次版本}.{补丁版本}.{构建版本}

主版本号（MAJOR）：重大架构变更或产品级别更新
次版本号（MINOR）：API 变更（包括不兼容的 API 变更）
补丁版本号（PATCH）：Bug 修复和小的改进
构建版本号（BUILD）：构建编号（通常为 0）

当前版本： v2.1.1.0

版本示例

v2.1.1.0 - 当前发布版本
v1.2.0.0 - 主要功能更新版本
v1.0.19.0 - 维护版本

特殊版本

部分版本带有 .RVD 后缀（例如 v1.1.1.0.RVD），表示该版本专门针对 RVisualDesigner 工具集成优化的发布版本。

版本信息

项目使用 tool/git_generate_version.py 自动生成版本头文件，包含以下信息：

版本标签
分支名称
提交哈希值
构建日期
仓库状态

软件架构

HoneyGUI 软件架构

安装在 Windows 操作系统上

安装编译器

下载 MinGW-w64 工具链，解压到 C 盘，并将其添加到系统环境变量 Path 中。

Mingw64 下载
解压并复制到目录：C:/mingw64
添加一个环境变量：C:/mingw64/bin
- 打开开始菜单，搜索 高级系统设置。
- 显示 系统属性，然后转到 高级 选项卡。
- 点击 环境变量 按钮。
- 在 用户变量 部分，找到并选择 Path 变量，然后点击 编辑。
- 点击 新建 并添加 C:\mingw64\bin。
- 点击 确定 关闭所有对话框。

安装 Python

测试过 Python 3.9.7 版本。

安装scons

打开一个 CMD 窗口，并执行以下命令来安装 Python 的 scons 库：

> pip install scons==4.4.0

安装 kconfiglib

安装 kconfiglib 用于配置管理：

> pip install kconfiglib

配置应用程序（Menuconfig）

在编译之前，可以使用 menuconfig 图形化配置工具来选择要运行的示例应用程序。此配置对 SCons 和 CMake 两种构建系统都通用。

使用 Menuconfig 进行配置

在 HoneyGUI 文件夹中执行以下命令：

> cd simulator\win32
> menuconfig ../../Kconfig.gui

执行命令后，将打开图形化配置界面：

Menuconfig 配置界面

操作说明

使用 方向键 上下移动选择项目
使用 空格键 或 回车键 取消/选中配置项
选择 Select HoneyGUI Demo (Watch Turnkey Demo 410x502) 进入应用程序配置
选择要运行的示例应用程序：
- Watch Turnkey Demo 410x502：手表应用示例（410x502 分辨率）
- GUI Demo 800x480：仪表盘应用示例（800x480 分辨率）
- 其他可用的示例应用程序

Menuconfig 应用程序配置界面

按 ESC 键返回上一级菜单
选择 < s > 保存配置到 .config 文件
选择 < q > 退出配置界面

配置文件说明

配置完成后，会在 HoneyGUI\simulator\win32 目录下自动生成 .config 文件。构建系统（SCons 或 CMake）会自动读取此配置文件，并根据配置编译相应的应用程序。

注意： 如果不使用 menuconfig 进行配置，构建系统将使用默认配置或已存在的 .config 文件。

安装 mingw-w64 工具链和 scons 库后，可以通过两种方式启动应用程序：通过 CMD 启动或通过 VSCode 启动。

通过 CMD 启动（Scons）

在 HoneyGUI 文件夹中打开一个 CMD 窗口，然后运行以下命令启动应用程序。

> cd simulator\win32
> scons
> cd ..\..
> .\simulator\win32\gui.exe

scons 命令执行构建过程，然后执行 gui.exe 来运行应用程序。

启动应用程序

通过 CMD 启动（CMake）

依赖软件

CMake（测试版本为 3.31.2）：https://cmake.org/download/
MinGW-w64：如前所述

初始化构建环境

在 HoneyGUI 文件夹中执行：

> cd simulator\win32
> mkdir build
> cd build
> cmake -G "MinGW Makefiles" ..

配置应用程序

如需更改应用程序配置，请参考前面的 配置应用程序（Menuconfig） 部分，在 simulator\win32 目录下执行 menuconfig ../../Kconfig.gui 命令。

编译项目

在 HoneyGUI\simulator\win32\build 文件夹中执行：

> cmake -G "MinGW Makefiles" ..
> mingw32-make -j 32

编译过程中，CMake 会自动：

读取 .config 文件中的配置
根据配置选择相应的应用程序源代码
自动处理应用程序所需的二进制资源文件（.bin 文件）
生成可执行文件 gui.exe

运行程序

在 HoneyGUI 文件夹中执行：

> .\simulator\win32\build\gui.exe

通过 VSCode 启动

安装 VSCode

打开项目

单击 HoneyGUI.code-workspace 文件

运行项目

进入 VSCode 界面后，可以选择 Run and Debug 选项，然后点击 Run 按钮。

VSCode 运行项目

显示

手表工程

窗口中显示出表盘，您可以通过滑动和点击与其进行交互。

手表工程示例

仪表盘工程

窗口中显示仪表盘。

仪表盘工程示例

realmcu/HoneyGUI

实测星标增长

关于

README_zh.md