SDK 文档 / 12 · 路线图与未实现能力

12 · 路线图与未实现能力

这一章把"文档里出现但代码还没有"的东西全列出来,避免你照着写却跑不通。标 【未实现】 = 有设计意图、没有代码;标 【不做】 = 明确不在计划内。

12.1 未实现(按优先级)

① 应用管理页(图形化装/卸)【已实现 2026-11-03】

现在:桌面「应用」屏 —— 列表 / 详情(占用、能力声明、运行状态)/ 安装 /卸载 / 停止后台(04)。包仍要先用 adb 推到 /blackbox/tmp/,只是不用再敲 unzip 和 rm -rf。

遗留:解压依赖设备上的 unzip / busybox unzip;导 U 盘选包还没做;包很大时安装会阻塞界面。

② 应用图标(icon 字段 + PNG)【已实现 2026-11-03】

现在:卡片用"名字首字 + 版本"画一个色块(src/desktop.c:draw_app_ext)。

现状:icon 字段生效 —— bb_apps_icon_surface() 首次加载 + 缓存(扫描时清空),桌面卡片与管理页头像都画 PNG;没写 icon 时回退 assets/icon.png,加载失败回退首字色块。

{ "icon": "assets/icon.png" }

③ 能力声明 needs【已实现(展示)】

现在:清单里的 needs[] 会被解析,在「应用 → 详情」里显示成一行shell, camera, network,并明确标注"声明只用于展示,不是沙箱"。

{ "needs": ["shell", "camera", "network"] }

仍然没有任何强制力:应用以 root 跑,能碰什么就是能碰什么(08)。

④ 后台常驻【已实现 2026-11-03】

现在:清单 "background": true 的应用,「返回」后进程不退出:释放触摸、销毁surface、写 run.pid,桌面「应用」里显示「后台中」,再点图标用 SIGUSR1 唤醒(05)。

没有做的部分:常驻通知/角标;后台应用在桌面卡片上的实时指示只有管理页里有;后台期间不能画任何东西(没有 surface)。

⓪ 副屏(342×342)SDK 支持【未实现,2026-11-03 评估】

现状:SDK 只能跑主屏。BBAPP_OUTPUT=342x342 能选中副屏并全屏,但画不出来 ——DJI 的前屏取景走 EGL/NV12 直通,SDM backend 会把它提到独立的 VIG 硬件层,MDP/DPU 里 VIG 永远压在 RGB 之上(bbui 里量过:两块 plane 的 normalized-zpos 都是 0)。

bbui 里已经有解(src/ui.c 的 sub_init / sub_base_init),要搬进 SDK 需要:

依赖 说明
wl_subcompositor 副屏要做一块 NV12 底座,SDK 现在没绑这个全局
gbm + gbm_buffer_backend 底座是 dma-buf NV12 buffer,要 dlopen DJI 的私有协议造 wl_buffer
opaque region 副屏 surface 必须声明整块不透明,否则取景盖在我们图上
独立触摸 副屏是 fts_ts(event8,343×343),要单独 EVIOCGRAB
背光 panel1 sysfs,副屏默认是关的

结论:不是"接个 output 就行",是另一套渲染底座。等主屏 SDK 稳定后单独做。

⑤ 滑动 / 长按【已实现 2026-11-03,API v2】

现在:down / move / up / long_press 四个回调,up 还带 held_ms(按了多久)和 moved(有没有拖过),见 09 API。

更省事的做法:别自己接这些回调,用控件层 —— 列表的滚动、惯性、边缘回弹、长按、点击 vs 拖动的判定都在框架里,应用只写"这一行画什么"。

控件层自己还缺的:文本输入(需要键盘)、对话框、分段控件、横向列表、拖动排序,清单在 13.9。

⑥ 多点触控【未实现】

现在:只跟踪一组 raw_x/raw_y,第二根手指会覆盖第一根(07)。控件层也建立在单点之上,所以列表里做不了双指缩放。

判断:这台 7 寸屏上双指缩放的需求不强,优先级最低。

⑦ 崩溃日志落盘【未实现】

现在:rc=139 写进日志,dmesg 里有段错误记录,但没有调用栈。

目标:SDK 装 SIGSEGV 处理器,用 backtrace_symbols_fd 打到 app.log。(需要 -rdynamic 编译,符号表会变大,作为可选宏 BBAPP_CATCH_CRASH。)

12.2 明确不做

项 为什么
多窗口 / 分屏 wl_shell + 触摸独占的物理限制,做了也不稳
沙箱 / 权限系统 整个系统就是 root,做一层假沙箱只会让人误以为安全
包签名 / 校验 单用户设备,装了就等于信任;加签名只会增加安装摩擦
GPU 加速绘制 DJI 的合成器没有可用的 GL 路径给我们,cairo CPU 已够用
自绘控件库 / 布局引擎 会让 SDK 变成框架,体积和不确定性都上一个量级
应用间通信 独立进程 + 单前台,IPC 需求可以先落在文件上

12.3 文档与代码的差距(自查表)

文档里说的 代码里有吗
app.json 的 id/name/version/entry ✅ src/apps.c:slot_load
app.json 的 abi ⚠️ 只有 mkbbapp.py 校验,bbui 不读
app.json 的 files[] ✅ mkbbapp.py:collect(打包用)
app.json 的 icon / needs ❌ 无代码(本章草案)
数据目录 data/ 自动创建 ✅ src/apps.c:mkdir_p
自动补执行位 ✅ slot_load 里 chmod
mtime 触发重扫 ✅ bb_apps_maybe_rescan
BBAPP_NOGRAB 等调试变量 ✅ sdk/bbapp_run.c
返回键强制 ✅ sdk/bbapp_run.c:tap_at
每 2 秒压 DJI 服务 ✅ tools/svc/app-run.sh
崩溃兜底回桌面 ✅ 同上(wait 后 exec bbui)
应用管理页 / 图标 / 后台 / 手势 ❌ 本章 1~7

12.4 想参与的话,先看这三个文件

文件 内容 改动风险
sdk/bbapp.h API 契约(改它要考虑兼容) 高
sdk/bbapp_run.c 运行时(wayland/触摸/帧循环) 高(一次性影响所有应用)
sdk/mkbbapp.py 打包白名单 中(影响发布产物)
src/apps.c 宿主侧扫描与拉起 中
tools/svc/app-run.sh 设备端启动器 高(路径/参数一变,所有已装应用失效)

改完必须真机验证的最小集合:起 → 点 → 返回 → 相机不抢屏 → 再起一次。


返回 文档首页。

bbui 第三方应用 SDK · API 1 · 本文档随仓库 docs/sdk 自动生成