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" }
- 建议 96×96 PNG(显示尺寸 40×40,按设备像素);
- 缺省时回退到"首字"方案;
- 打包器不需要改(
assets/**本来就会进包)。
③ 能力声明 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 |
设备端启动器 | 高(路径/参数一变,所有已装应用失效) |
改完必须真机验证的最小集合:起 → 点 → 返回 → 相机不抢屏 → 再起一次。
返回 文档首页。