HoloCubic App SDK

从 Lua 与 LVGL 开始开发 HoloCubic App

App 包定义名称、入口和资源；Lua 处理生命周期、网络与设备逻辑；LVGL 构建界面。仅在需要原生性能时使用公开 C ABI。

holo://appREADY

hello/
├── app.info
├── main.lua
├── main.png
├── assets/
└── modules/ # optional

$ app.rescan()
✓ Hello is ready

基本流程

创建 App 包

准备 app.info、main.lua 与所需资源。

使用 LVGL 控件或 Canvas 适配 320 × 240。

上传到 /sd/apps/{app-id}，然后执行 App 重扫。

SDK STACK

从应用包到原生扩展，每一层都有明确边界。先使用 Lua 与 LVGL，只有确有性能需要时才进入 C ABI。

APP.INFO

目录、元信息、入口、生命周期、部署与资源释放。App 必须能独立启动，也必须在退出时停止任务并清理资源。

[app]
name = "Hello"
entry = "main.lua"
icon = "main.png"

LUA

NodeMCU 风格的定时器、网络和文件模块，并提供 BLE Service、IPC、设备状态等 HoloCubic 能力。

local timer = tmr.create()
timer:alarm(1000, tmr.ALARM_AUTO, function()
  print("tick", tmr.time())
end)

LVGL 8.3

控件、样式、事件、动画、图片、字体与 Canvas。所有界面围绕 320 × 240 屏幕和短回调设计。

local label = lv_label_create(lv_scr_act())
lv_label_set_text(label, "Hello, Holo.")
lv_obj_center(label)

C ABI

版本化 Host API，用于音频、协议和持续计算等性能敏感模块；不暴露也不得依赖宿主固件内部符号。

const holo_host_api_v1 *host;
int holo_module_init(const holo_host_api_v1 *api) {
  host = api;
  return HOLO_OK;
}

PUBLIC BOUNDARY