Files
LN-Code-Editor/tools/build
2026-09-13 18:05:41 +08:00
..
1
2026-09-13 18:05:41 +08:00
1
2026-09-13 18:05:41 +08:00
1
2026-09-13 18:05:41 +08:00

tool/ —— proot / shmem 的构建与补丁

这里的产物已经编译好并提交在仓库里(android/app/src/main/jniLibs/*/lib*.so 与 assets/shims/*/), 正常开发不需要重新构建。只有在升级 proot、改补丁、或换 ABI 时才需要。

构建所需的中间目录(proot-source/、build_proot_deps/、build_proot_out/)都在 .gitignore 里, 可随时删除、按下面步骤重建。


一、重建 proot(含本地补丁)

# 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 后端时)

pwsh tools\build\build-shmem.ps1      # 自动克隆 termux/libandroid-shmem 并应用 tools\patches\libandroid-shmem-runtime-ashmem.patch

三、重建 shim

shim 是 freestanding C(无 libc),直接用 NDK clang 编:

$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/)。