入门指南

源代码项目下载

在 GitHub 上下载： https://github.com/realmcu/HoneyGUI
在 Gitee 上下载： https://gitee.com/realmcu/HoneyGUI

介绍

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 版本。

软件架构

https://foruda.gitee.com/images/1753340174900062921/e20848cb_10737458.png — HoneyGUI 软件架构

安装在 Windows 操作系统上

安装编译器

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

MinGW-w64 下载
解压并复制到目录： 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 进行配置

在 win32_sim 目录下执行以下命令：

> cd win32_sim
> menuconfig ../Kconfig.gui

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

https://foruda.gitee.com/images/1764320806391041617/417b0f55_13406851.png — Menuconfig 配置界面

操作说明

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

https://foruda.gitee.com/images/1764321915931205772/1248fc4d_13406851.png — Menuconfig 应用程序配置界面

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

配置文件说明

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

备注

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

安装 MinGW-w64 工具链和 scons 库后，可以通过多种方式启动应用程序。

通过 CMD 启动（Scons）

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

> cd win32_sim
> scons
> cd ..
> .\win32_sim\gui.exe

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

https://foruda.gitee.com/images/1718704649306452668/282ac763_13408154.png — 启动应用程序

通过 CMD 启动（CMake）

依赖软件

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

初始化构建环境

在 HoneyGUI 文件夹中执行：

> cd win32_sim
> mkdir build
> cd build
> cmake -G "MinGW Makefiles" ..

配置应用程序

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

编译项目

在 HoneyGUI\win32_sim\build 文件夹中执行：

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

编译过程中，CMake 会自动：

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

运行程序

在 HoneyGUI 文件夹中执行：

> .\win32_sim\build\gui.exe

通过 VSCode 启动

安装 VSCode

打开项目

单击 HoneyGUI.code-workspace 文件

运行项目

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

https://foruda.gitee.com/images/1699582639386992543/b2078d27_13671125.png — VSCode 运行项目

显示

手表工程

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

https://docs.realmcu.com/HoneyGUI/image/gui_watch.gif — 手表工程示例

仪表盘工程

窗口中显示仪表盘。

https://foruda.gitee.com/images/1753340204000227545/39228f04_10737458.png — 仪表盘工程示例