这个目录负责把启动台的基础开发工具组装成一个 tar,交给 App 解到自己的 files/ 下运行。
每个组件都能查到出处:版本、哈希、构建配方链接都记在锁文件和 SBOM 里。
| 部分 | 来源 | 处理方式 |
|---|---|---|
| 256 个包:clang/lld/cmake/ninja/make、git/ssh、gdb/strace、python、node+npm、JDK 21、aapt2/d8/apksigner、bash/coreutils/grep/sed/awk、rg/fd/bat/delta/helix/yq/jq/sqlite… | Termux 官方仓库,构建配方开源:termux-packages | 构建时下载,校验哈希,原样打进 tar,只做前缀改写(见下) |
android.jar(编译 APK 用的平台存根) |
Google 官方 SDK 仓库 platform-36_r02.zip |
不入包,许可协议不允许再分发。由用户在设备上自行下载并同意许可,与 Claude Code 本体同样处理 |
不再使用的: C4droid 的 GCC 和原 dshtc/prefix 里的那批工具,全部被上表取代。
Termux 的程序在编译时把前缀 /data/data/com.termux/ 写死了,ELF 里是定长槽位。
只要我们的包名恰好 10 个字符(和 com.termux 一样长),就能逐字节等长替换:
/data/data/com.termux/ → /data/data/li.dsh.dkt/
RUNPATH、shebang、配置文件路径一次全部改对。不需要 LD_LIBRARY_PATH、不需要包装脚本、不需要二进制补丁。
这一版改写了 1651 个文件里的 4977 处。
⚠️ 所以发布版 App 的包名必须是 10 个字符。 测试用的是li.dsh.dkt。
node devkit.mjs resolve [--groups core,build] # 只看依赖闭包和体积
node devkit.mjs build --target <10字符包名> [--groups ...] # 产出 out/devkit-<包名>.tar产物:
out/devkit-<包名>.tar:App 解到files/下即可。解完后跑一次usr/libexec/devkit/first-run.shdevkit.lock.json:每个包的版本、文件名、SHA256、配方链接,加上仓库快照时间SBOM.tsv:同上,表格形式
分组见 devkit.json:不加 --groups 时全部分组都打进去,即整包;按模块分块打见下面「模块」一节。包括 graphics(Mesa、Vulkan 加载器等 9 个公共图形包,2026-10-15 并入,GPU 与浏览器组件共用)和 media(ffmpeg,2026-10-15 夜并入:+30 包,下载 +21 MB,解开后 +87 MB;带 MediaCodec 硬件编码)。共 256 个包(devkit-2026.10.28;10.22.1 起基础模块补了 patch、ed、dos2unix、lsof、nano、inetutils、net-tools、tree,10.22.3 补上单独的 which 包),从 Termux 仓库下载约 447 MB,整包 gz 约 680 MB(10.22.2 修了 venv 用的 ensurepip pip wheel),解包后约 1.9 GB。
extra 组(typst、duckdb、imagemagick)依赖很重,作为选装。
node scripts/publish-devkit.mjs devkit-YYYY.MM.DD[.n] --why "这版改了什么":打 tag → 等 CI → 验签并核对 Release(每个 gz 都在、大小对;devkit.json 点名的包都进了清单;和上一版比少了包就停)→ 改钉 App(devkit-sources.txt、devkit-pin.json、本文的包数)→ 市场 bases.json 加一行并等组件重打 → 重打预置浏览器、签索引、上传 → 等镜像同步并逐字节核对 → 打预览包 → main 合到 test → 全链对账。
中途失败再跑同一条命令,从没做完的那步接着来;--check 只对账不改东西。devkit.json 的分组里要写实际的包名,不写虚包(man 要写成提供它的 mandoc),否则对账认不出。
工具包按 devkit.json 的 modules 拆成基础模块 + 若干可选模块,App 里随装随卸:
node devkit.mjs modules [--out DIR] # 出划分 modules.plan.json(并冻结这一刻每个包的下载记录)
node devkit.mjs build --target <包名> --plan <plan> # 按冻结记录打整包(不再拉索引)
node devkit.mjs modules --plan <plan> --build --target <包名> --out DIR # 逐块打包,合并出 modules.json- 基础模块(
required)必装;其余模块只含超出基础的包。被两个以上模块用到、又不小于sharedMinMB的包自动提成共享层(目前是 libllvm),跟着用它的模块自动装卸。更小的共用包各模块各带一份(装到手机上是同一份文件)。 - 每块一个
devkit-<id>-<包名>.tar.gz,带自己的MANIFEST(逐文件 sha256)、FILES(全部路径含软链,卸载按它删)、first-run.sh;基础块在libexec/devkit/,其余在libexec/devkit/modules/<id>/。 - 合并时检查:同一路径在两块里内容必须相同;alternatives 同组不能两块各给一个(依赖块已给、优先级不低的,打包时就跳过)。
- CI 按「划分 → 整包 → 各块」走,同一个 Release 里整包(旧 App 用)和模块(新 App 用)出自同一份快照。
- adb 单独成组并进基础模块:Shizuku 的无线调试自启动要用它。
- 目前的可选模块:命令行增强(
cli)、C/C++ 构建(build)、安卓打包(android)、GPU 图形(graphics)、音视频(media)、文档与数据(extra)、Go 语言(go,含 gopls / goimports / gofumpt / gotestsum / govulncheck / golangci-lint / dlv)、Node.js 生态(node,pnpm / yarn / bun / deno)。clang与libllvm这类多块共用的大家伙由划分自动提成共享层(lib-clang、lib-libllvm)。 - 模块可以标
"full": false:整包里不放它,从整包升级上来的用户也不会自动装上(要用再到扩展页加)。后加的大模块(go、node)都这么标,免得只认整包的旧版 App 和整包用户升级时平白多下几百 MB。
工具包之外的选装件(市场配方、预置组件)用这个子命令打:
node devkit.mjs component <组件 id> --target <10字符包名> --base <工具包的 devkit.lock.json>
node devkit.mjs component --recipe <配方目录> --target <10字符包名> --base <...> [--dry]一个组件 = 底座之外的包(底座里已有的不重复打)+ 组件自带的文件(files,内容里的 {{PREFIX}} 会替换)+
仓库之外的上游原件(fetch)。产出 component-<id>.json(App 与索引用的清单)和
component-<id>-<包名>.tar.gz(里面 MANIFEST 逐文件记 sha256,App 解包后照它核对)。
fetch 的每条是「落地路径 → 来源」,路径只能在 usr/ 下:
- 下载后先核对 sha256 才放进包里(与
devkit.json里 pip wheel 那条同一套)。 mode给权限(默认 644)——要装可执行文件就得写"755"。link不下载,只做一条软链,只能写同目录的文件名(不许绝对路径、不许带/);上游库的 SONAME 是libX.so.1、而文件叫libX.so时用它补上。- 配方里的 fetch 条目 devkit 自己也校验一遍(
usr/下、https、sha256 写全、写 why、mode 是八进制),不全指望配方仓库的检查。 - 上游压缩包:键写落地目录(以
/结尾)并加extract: { format?, strip?, include?, exec? },下载、核对压缩包的 sha256 后解开放进去。 支持 tar.gz / tar.xz / tar.bz2 / tar / zip(bz2 用系统的bzip2)。带..、绝对路径的条目和指出落地目录的软链直接失败; 硬链接改成文件,setuid/setgid 和组、其他人的写位去掉;include写了却找不到、解出来没有文件、和组件自己的 Termux 包撞路径,都失败。 缓存文件名带哈希前缀(fetch-<sha256 前 16 位>-<文件名>),不同上游的同名包不会互相顶掉。写法见市场仓库docs/recipe.md。 source/version/why只记账(进锁文件,便于查出处);fetch 的体积也算进installed。- 配方的发布版本是
<上游版本>-r<revision>;配方顶层写了version就用它当上游版本(fetch 型组件的版本来自上游构件),修订号照样接在后面。
- 校验索引:取
Release,用它核对Packages.gz的 SHA256。InRelease 的 GPG 签名暂未验证,见 TODO。 - 求依赖闭包:包括 Provides 虚包;
a | b取第一个能满足的。 - 下载:用 curl,大包分 4 MB 块、8 路并行。整包哈希不对时,换镜像逐块复核,按两个来源一致选块。
- 解包:先用 JS 解出 xz 这一个包来自举,之后全部用原生 xz 解压。全量构建约 1 分钟(有缓存时)。
- 改写:重写 tar 里的路径、文件内容、软链接目标。
- 处理 postinst:
- 解析
update-alternatives,按优先级生成 java/javac/keytool、pager、editor 等链接; - 其余步骤(dbus machine-id、glib schema、ssh 目录等)收进
first-run.sh。
- 解析
全部原生运行,没有任何包装:
- 编译:clang 21 编 C/C++20;cmake + ninja;gdb 断点 + bt
- 语言与网络:python 3.14(ssl/sqlite);
git clone走 https;npm install - APK 全链:aapt2 → javac 21 → d8 → zip → keytool → apksigner(v2+v3)→ 装机启动成功
runner/:测试 Appli.dsh.dkt。以它的身份执行命令,输出写回run/dkt.sh '<命令>' [超时]:从外面驱动它(需要 priv)。第一次用前要授权存储:pm grant li.dsh.dkt android.permission.{READ,WRITE}_EXTERNAL_STORAGEctl.mjs:列出缓存里各 .deb 的维护脚本
- 验证 InRelease 的 GPG 签名(Termux 仓库公钥),而不只是走 HTTPS
- SBOM 补许可证列:从配方的
TERMUX_PKG_LICENSE抓取。另外有些包的配方在x11-packages/或root-packages/下,链接要修正 - JDK 21 拖进了 x11/pulseaudio(它是完整 JDK)。看能否换 headless 方案减重
- App 侧:解包 + first-run + 外部依赖(android.jar)的下载与许可确认界面
- 换掉旧工具链之后,原来的
cc4/cxx4/mk4、glibc DNS 补丁、shell 槽位补丁就都不需要了