This commit is contained in:
LZX committed 2026-09-13 18:05:41 +08:00
1 parent e932c60dbd
commit 55f35673df
21 files changed
+1430 -3

No files matched your search

+64
View File
@@ -0,0 +1,64 @@
# tool/ —— proot / shmem 的构建与补丁
这里的产物**已经编译好并提交在仓库里**(`android/app/src/main/jniLibs/*/lib*.so` 与 `assets/shims/*/`),
正常开发**不需要**重新构建。只有在升级 proot、改补丁、或换 ABI 时才需要。
构建所需的中间目录(`proot-source/`、`build_proot_deps/`、`build_proot_out/`)都在 `.gitignore` 里,
可随时删除、按下面步骤重建。
---
## 一、重建 proot(含本地补丁)
```powershell
# 1) 取源码(必须是 termux 的 fork —— 我们需要它的 --link2symlink/--kill-on-exit/l2s)
git clone --depth 1 --branch v5.1.107.92 https://github.com/termux/proot.git proot-source
# 2) 应用本地补丁(proot 层"传统 syscall 现代化",见补丁头部注释)
git -C proot-source apply tools\patches\proot-legacy-syscalls.patch
# 3) 取 talloc 头文件(编译期需要;libtalloc.so 用仓库里现成的)
# 任一 talloc 2.x 版本即可:
git clone --depth 1 --filter=blob:none --sparse https://github.com/samba-team/samba.git build_proot_deps\samba
git -C build_proot_deps\samba sparse-checkout set lib/talloc
# 之后 -TallocInclude 指向 build_proot_deps\samba\lib\talloc
# 4) 编译(双架构,loader 内嵌,链接仓库里的 libtalloc.so / libandroid-shmem.so)
pwsh tools\build\build-proot.ps1 -TallocInclude build_proot_deps\samba\lib\talloc `
-ShmemLib build_proot_out\shmem `
-Install
```
## 二、重建 libandroid-shmem(仅当要改 `--sysvipc` 后端时)
```powershell
pwsh tools\build\build-shmem.ps1 # 自动克隆 termux/libandroid-shmem 并应用 tools\patches\libandroid-shmem-runtime-ashmem.patch
```
## 三、重建 shim
shim 是 freestanding C(无 libc),直接用 NDK clang 编:
```powershell
$ndk = "D:\Android\SDK\ndk\28.2.13676358\toolchains\llvm\prebuilt\windows-x86_64\bin"
$src = "android\app\src\main\cpp"
foreach ($t in @(@("x86_64","x86_64-linux-android24"), @("arm64-v8a","aarch64-linux-android24"))) {
& "$ndk\clang.exe" --target=$($t[1]) -shared -fPIC -nostdlib -ffreestanding `
-fno-builtin -fno-stack-protector -O2 -o "assets\shims\$($t[0])\libfix_seccomp.so" `
"$src\libfix_seccomp.c" "$src\libfix_dns.c"
Copy-Item "assets\shims\$($t[0])\libfix_seccomp.so" "android\app\src\main\assets\shims\$($t[0])\libfix_seccomp.so" -Force
}
```
## 四、补丁清单
| 补丁 | 作用 |
|---|---|
| `patches/proot-legacy-syscalls.patch` | proot 层把 Android 在 x86_64 上拒绝的传统 syscall 改写成现代等价形式(`poll→ppoll`、`select→pselect6`、`epoll_wait→epoll_pwait`、`pipe→pipe2`、`dup2→dup3`、`fork/vfork→clone(SIGCHLD)`、`clone` 去掉 `CLONE_VM\|CLONE_VFORK`、`clone3→clone`)。新增 `src/syscall/legacy.c`,并在 `src/syscall/seccomp.c` 的过滤表里登记这些调用 |
| `patches/libandroid-shmem-runtime-ashmem.patch` | `libandroid-shmem` 的后端选择从**编译期**(`__ANDROID_API__ >= 26`)改成**运行时** `dlsym(ASharedMemory_*)`,拿不到再回退 `/dev/ashmem`。原因:Android 11+ 对应用进程已拒绝 `/dev/ashmem`(实测 EACCES),而 API 26 编译又会把设备门槛抬到 8.0 |
## 五、注意
- **不要用 proot-me 上游**:`--link2symlink`(本环境禁止 `link(2)`,必须用 l2s 模拟)与 `--kill-on-exit` 都来自 termux fork。
- **不要原地覆盖运行中的 shim**:必须「写临时文件 → `mv`」,否则正在映射它的进程会 SIGSEGV。
- 构建产物请用 `-Install` 安装(会自动把旧文件备份到 `build_proot_out/backup/`)。