Known Limitations / 已知限制
这页记录 v0.3.1-beta 的实际边界,不是路线图承诺。
固定容量需要上层处理
App 启动、动画和 Popup API 可以报告容量或 transition 失败,但部分示例仍忽略返回值。AppManager::registerApp() 返回 void,注册数必须在启动前审核。各上限和调参方法见资源上限。
ListView 数据接口偏底层
ListItem 通过回调、union 和非拥有指针表示不同项目。它适合静态嵌入式数据,但类型安全和容量可观测性仍有改进空间。
非拥有数据的寿命由调用者保证
Widget 文本、XBM、Chart buffer、Popup 值引用、App 启动参数和 lambda 捕获通常不会被拷贝。统一规则见回调与对象生命周期。
并发边界很窄
tickFromISR() 是为定时 ISR 提供的特例边界。其他 API 的任务归属见事件驱动渲染。
