新旧体系对照与迁移路线¶
原则:叠加,不替换¶
新包体系是**叠加层**。以下旧入口全部原样保留、行为不变:
make run/make dev-build/ 全部smoke-*门禁;user/rootfs/alpine/build.sh(make rootfs-alpine、make distro-run);- 内核 ramfs 内嵌早期驱动(EARLY_DRVMOD,启动根盘所需,永远在内核里)。
新体系的打包器**只读构建产物目录**,不影响构建过程本身。
唯一的例外是源码构建的 extra 路径,它已退役。user/extra.mk 已删除,user/external/ 下的 vim、git、zlib、curl+mbedtls、binutils+GCC、Rust、 Lamina1 源码树也不再入库:这些软件现在由 world 清单从 Alpine 上游仓库解析。extra-img、run-*-extra、vf2-extra 这些入口刻意保留为**会报错的弃置桩**(tools/mk/targets-extra.mk),每个都打印替代命令后 exit 2,而不是让 make 报一句什么也不教的 "no rule to make target"。
/extra 这个**分区本身没有取消**:真板仍需要一块可写 ext4,make vf2-sdcard现在用 apk world 镜像填它(VF2_WORLD 选 world,默认 devel)。
对照表¶
| 旧做法 | 新做法 | 说明 |
|---|---|---|
用户程序 objcopy 成 .o 链进内核(RAMFS_USER blob) |
a20-base 包 → world 组装进 rootfs |
解耦内核与用户态构建 |
mcopy 逐个塞 FAT32 / mkfs -d 暂存目录 |
mkrootfs.py + world 清单 |
内容有清单、有版本、有依赖 |
已删除的 user/extra.mk 里 vim) stamp=.vim-built ;; 硬编码 case |
world 清单里直接写 Alpine 上游包名 | 加包 = 往 packages/world/*.world 加一行 |
| extra 镜像(独立 ext4 挂 /extra) | extra 包进仓库,world 引用 | 保留 /extra 布局,见下 |
发布 = 手工拷贝 disk.img |
tag → 构建打包 → Release bundle | 多架构,包含仓库、公钥与启动配套 |
| 环境 = 宿主机手装 apt 依赖 | tools/ci/Dockerfile 固化 |
CI 与本地同一容器 |
迁移现状与兼容边界¶
- CI 与发布:常规门禁保留六个 hosted 架构编译和代表性行为;四架构 world 制作与分发归 release,见 CI/CD 说明。
- 打包入口:
make pkgs / pkg-repo / image-world与旧disk.img路径并存;a20-base的平铺布局按旧镜像对齐,发行版 overlay 保留各自用途。 - 源码构建的 userland 退役(已完成):
user/extra.mk与user/external/下的 vendored 树(vim、git、zlib、curl+mbedtls、 binutils+GCC、Rust、Lamina1)全部删除,移植软件一律作为 Alpine 上游包直接写进packages/world/*.world:devel带 musl busybox vim git curl ca-certificates less,devtools再加 gcc musl-dev fastfetch。a20-extra-git/a20-extra-vim这两个孤儿 recipe 一并删除(它们不在任何 world 里,也不在PKG_RECIPES中)。保留的源码输入包括user/cmds/、固定版本 BusyBox、fastfetch 与 libc,具体版本由子模块和打包配方固定。 - distro 路径:
user/rootfs/alpine/packages.txt与packages/world/是现有的两组组装入口,保留各自的 chroot init 和 overlay。 - 启动路径:RAMFS_USER blob 与 EARLY_DRVMOD 引导路径保留;world 打包不要求淘汰内嵌启动支持。
兼容性承诺¶
- 旧 make 目标不删不改,直到对应能力在新体系有等价物且经过验证;
- 包内布局对齐旧镜像(
a20-base平铺根目录、/lib/drivers、/musl/lib/libc.so、extra 包/extra/...),init 与脚本无需改动; - 若发现新旧产物不一致,以旧路径行为为准并提 issue,对齐是新体系的责任。