门禁管理系统是一个使用 HVML 开发的示例应用。
本文将介绍该示例应用的主要功能特点，如何获取该应用的源代码，以及如何使用 xGUI 运行该示例应用。
功能特性
门禁管理系统使用 HVML 语言开发，使用自研的的 xGUI 渲染器运行。
当前 xGUI 发布了 0.9.22 版本，实现了 HTML 5 和 CSS 2.2 定义的绝大部分技术特性，可用于嵌入式系统界面、智能设备界面、桌面应用的开发，支持 Linux + MiniGUI、Linux + Gtk、macOS 三个平台。
下面是使用 xGUI 在 Linux + MiniGUI 嵌入式平台上的运行门禁管理系统应用的效果：
通过上面视频屏示的门禁管理系统，体现了以下的功能特色：
- 设置 WiFi 连接；展示了如何使用 HVML 程序和操作系统交互。
- 联机更新时间和天气；展示了如何使用 HVML 访问互联网内容。
- 自带中英文输入法；而且输入法界面也是用 HVML 编写的。
- 使用 SQLite 管理各种数据；展示了如何使用 HVML 操作 SQLite 数据库。
- 支持常见的输入构件（checkbox、radio、button、select），支持对话框表单的提交。
- 支持触摸操作，自带滑动加速或阻尼效果等。
- 支持 PNG、JPEG、WebP 等图片格式。
- 支持 GIF 动画。
- 支持页面切换过渡效果。
源码获取
这个示例应用的源代码仓库是公开的，通过下面的方式获取:
# github
$ git clone https://github.com/HybridOS2/HBDSamples
# gitee
$ git clone https://gitee.com/HybridOS2/HBDSamples
通过上述命令 clone 源代码仓库之后，子目录 access-control就是门禁管理系统的源代码。
运行应用
安装 HVML 软件包
运行门禁管理系统需要使用 HVML 软件包，我们已经为 Ubuntu 24.04 制作了相关软件包，可以通过以下命令一健安装：
$ curl -fsSL https://hvml.fmsoft.cn/install.sh | sh
也可以通过下面的命令手动安装（Ubuntu 24.04）:
- 添加 FMSoft 的软件包签名秘钥以及仓库：
$ curl -fsSL https://files.fmsoft.cn/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/fmsoft-archive-keyring.gpg >/dev/null
$ curl -fsSL https://files.fmsoft.cn/stable/ubuntu/noble.fmsoft-keyring.list | sudo tee /etc/apt/sources.list.d/fmsoft.list
- 安装 HVML 软件包：
sudo apt-get update
sudo apt-get install hvml-purc-0.9 hvml-xgui-minigui-sa-0.9
至此，已经安装好了运行门禁管理系统所需要的基础软件包。
安装门禁管理系统
要运行门禁管理系统还需要对该应用进行安装，方法如下:
- 自动安装:
我们在 HBDSamples 中提供了 install.sh 脚本，可以一健安装该仓库里的所有应用：
$ cd <path to HBDSamples>
$ ./install.sh
- 手动安装
$ cd <path to HBDSamples>
$ sudo mkdir -p /app
$ sudo cp -r access-control/ /app/cn.fmsoft.hybridos.ac/
$ sudo chown -R $USER /app/cn.fmsoft.hybridos.ac
至此，已经完成了门禁管理系统的安装。
运行门禁管理系统
$ cd /app/cn.fmsoft.hybridos.ac
$ xgui4mgsa -i minigui -d remote -S true -a cn.fmsoft.hybridos.ac -r ac -k -v atd_main.hvml