Files
ssw-platform/scripts/build-libpglite-cross.sh
admin 39201143c5 feat(armv7): 交叉编译 32 位 ARM 平台包,自建 pglite 引擎
上游 pglite-rs 只有 aarch64/x86_64 四架构引擎,没有 armv7 ⇒ 自建。
上游认 PGLITE_LIB_DIR,用它喂自建的 libpglite.a + pglite-runtime.tar。

构建链(amd64 容器 + arm-linux-gnueabihf 交叉工具链 + zig cc 链接):
- build-pglite-engine.sh / build-libpglite-cross.sh / relocate-runtime-cross.sh
- zig-cc-armv7.sh(改写 -Wl,/abs/path + 注入 armhf sysroot)
- build-armv7.sh(一键:引擎 → Rust 交叉编译 → arm/v7 容器冒烟)

三个坑(详见 docs/armv7-build.md):
- strip="symbols" 让 rustc 重建 native 静态库时破坏全局符号 ⇒ 交叉构建强制 strip=none
- PG configure 在 cross_compiling 时假定不支持 --export-dynamic ⇒ 强制 cache 变量
- 上游把 runtime 可移植化拆成独立脚本(RPATH + libpq + libz)⇒ 新增交叉版

release.sh 支持 --target <triple>:跳过宿主消费方编译自检改验架构,
rlib 走隔离目录,解包目录名带 target 后缀(多平台互不覆盖)。

实测(linux/arm/v7 容器):initdb、单用户模式、pglite 读写探针、
sspf-admin 启动 + 14255 条示例数据、登录接口、CurrentUser 菜单树全部通过;
从发布包 tar 解出的二进制端到端复测同样通过。
2026-11-12 20:17:26 +08:00

149 lines
7.5 KiB
Bash
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/bin/bash
# build-libpglite-cross.sh —— 上游 build-libpglite.sh 的**交叉编译**变体
#
# 🔴 为什么需要它:上游脚本假定「configure && make 在本机跑」,产出本机架构的
# libpglite.a。本项目要 armv7 产物 ⇒ 必须在 amd64 宿主上交叉编译出 ARM 的
# 静态库(qemu 原生编译太慢,实测 apt 装依赖就跑了 9 分钟还没完)。
#
# 与上游脚本的差异(只有这些,其余流程逐字照抄):
# 1. CC 换成交叉 gcc(arm-linux-gnueabihf-gcc),并加 --host=arm-linux-gnueabihf
# 2. configure 传 CC/CFLAGS/AR/RANLIB 等交叉变量
# 3. 生成的 libpglite.a 用交叉 ar(宿主 ar 也能做,但用目标 ar 更稳)
# 4. 不跑 relocate-runtime.sh(那是给本机跑的 patchelf/initdb 校验)
#
# 产物:native/out/libpglite.a(ARM EABI5)+ native/out/pglite-runtime.tar
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
SRC="${PGLITE_SRC:-${ROOT}/postgres-pglite}"
# 🔴 OUT 必须落在挂载卷里(容器内 /work),否则产物留在容器可写层,宿主取不到。
OUT="${PGLITE_OUT:-${ROOT}/native/out}"
TARGET="${TARGET:-arm-linux-gnueabihf}"
CC="${CC:-${TARGET}-gcc}"
AR="${AR:-${TARGET}-ar}"
RANLIB="${RANLIB:-${TARGET}-ranlib}"
HOST="${HOST:-${TARGET}}"
BUILD="$OUT/build"
PREFIX="$OUT/install"
mkdir -p "$BUILD" "$PREFIX" "$OUT"
# 🔴 交叉编译时 configure 需要在 build 目录里写 Makefile.global 等;OUT 必须在挂载卷上
# (容器里 /work 是 bind mount),否则宿主拿不到 libpglite.a。
echo "==> OUT=${OUT}"
echo "==> SRC=${SRC}"
# ── 打补丁(上游 0001~0005,Linux 相关)──────────────────────
# 🔴 源码可能是 tarball 解压来的(**没有 .git**)⇒ `git apply` 用不了,
# 必须走 `patch -p1`。而且补丁**打不上必须报错**:静默跳过会得到一个
# 缺符号的 libpglite.a(ProcessStartupPacket / pgl_shmem_reset 未导出),
# 错误会推迟到最终链接才爆,浪费整个交叉编译周期。
for p in "$ROOT"/native/patches/*.patch; do
b="$(basename "$p")"
# Windows 专用补丁在 Linux 上不适用(上游就是按平台挑的)
case "$b" in *win32*) continue ;; esac
if patch -d "$SRC" -p1 --forward --dry-run < "$p" >/dev/null 2>&1; then
patch -d "$SRC" -p1 --forward < "$p" >/dev/null
echo "patched: $b"
elif patch -d "$SRC" -p1 --forward --dry-run -R < "$p" >/dev/null 2>&1; then
echo "already applied: $b"
else
echo "FATAL: patch does not apply: $b" >&2
echo " (补丁必须全部打上,否则引擎缺导出符号,链接期才爆)" >&2
exit 1
fi
done
# ── pglitec + native 胶水层 ───────────────────────────────────
PGLITEC_COMPAT="-include stdlib.h -include stdbool.h"
"$CC" -O2 -fPIC $PGLITEC_COMPAT -Dexit=pgl_native_exit -c "$SRC/pglite/src/pglitec/pglitec.c" -o "$OUT/pglitec.o"
"$CC" -O2 -fPIC -I"$ROOT/native" -c "$ROOT/native/pglite_native.c" -o "$OUT/pglite_native.o"
"$CC" -O2 -fPIC -I"$ROOT/native" -c "$ROOT/native/pglite_reset.c" -o "$OUT/pglite_reset.o"
"$CC" -O2 -fPIC -I"$ROOT/native" -c "$ROOT/native/pglite_static_ext.c" -o "$OUT/pglite_static_ext.o"
# ── configure(交叉)─────────────────────────────────────────
# 🔴🔴 **必须强制 export-dynamic**(2026-11-12 定位):
# PostgreSQL 的 configure 在**交叉编译时直接跳过** `--export-dynamic` 探测:
# if test "$cross_compiling" = yes; then
# pgac_cv_prog_cc_LDFLAGS_EX_BE__Wl___export_dynamic="assuming no"
# ⇒ `LDFLAGS_EX_BE` 里就没有 `-Wl,--export-dynamic`
# ⇒ `postgres` 不导出 backend 符号(实测:官方 10802 个 vs 自建 0 个)
# ⇒ 扩展模块 dlopen 时解析不到 CurrentMemoryContext 等符号:
# FATAL: could not load library ".../dict_snowball.so":
# undefined symbol: CurrentMemoryContext
#
# 本机编译(官方 x86_64 包)时探测能跑通,所以官方没这问题。
# 交叉编译必须强制打开(已实测 arm-linux-gnueabihf-gcc 支持该标志且确实导出符号)。
#
# ⚠️ cache 变量名带 `pg` 前缀(configure 里是 pgac_cv_prog_cc_...),
# 写成 ac_cv_... 会被忽略 —— 实测传了 ac_cv_ 之后 LDFLAGS_EX_BE 仍是空的。
# 双保险:既传 cache 变量,也直接给 make 传 LDFLAGS_EX_BE(后者一定生效)。
EXPORT_DYNAMIC_CACHE="${EXPORT_DYNAMIC_CACHE:-pgac_cv_prog_cc_LDFLAGS_EX_BE__Wl___export_dynamic=yes}"
export LDFLAGS_EX_BE="${LDFLAGS_EX_BE:--Wl,--export-dynamic}"
if [[ ! -f "$BUILD/config.status" ]]; then
(cd "$BUILD" && "$SRC/configure" \
--prefix="$PREFIX" \
--host="$HOST" \
--build="$(uname -m)-pc-linux-gnu" \
--without-icu \
--without-readline \
--with-zlib \
CC="$CC" AR="$AR" RANLIB="$RANLIB" \
CFLAGS="-O2 -fPIC -I/usr/arm-linux-gnueabihf/include" \
${EXPORT_DYNAMIC_CACHE})
fi
PGLITE_DEFS="-D__PGLITE__ -U_FORTIFY_SOURCE \
-Dsystem=pgl_system -Dpopen=pgl_popen -Dpclose=pgl_pclose \
-Dgeteuid=pgl_geteuid -Dgetuid=pgl_getuid -Dgetpwuid=pgl_getpwuid \
-Dexit=pgl_exit \
-Dmunmap=pgl_munmap \
-Dfcntl=pgl_fcntl \
-Datexit=pgl_atexit \
-Dsetsockopt=pgl_setsockopt -Dgetsockopt=pgl_getsockopt -Dgetsockname=pgl_getsockname \
-Drecv=pgl_recv -Dsend=pgl_send -Dconnect=pgl_connect \
-Dpoll=pgl_poll \
-Dshmget=pgl_shmget -Dshmat=pgl_shmat -Dshmdt=pgl_shmdt -Dshmctl=pgl_shmctl \
-Dlongjmp=pgl_longjmp -Dsiglongjmp=pgl_siglongjmp \
-Dsetitimer=pgl_native_setitimer"
NPROC="${NPROC:-4}"
LINK_OBJS="$OUT/pglitec.o $OUT/pglite_native.o"
rm -f "$BUILD/src/backend/main/main.o" "$BUILD/src/backend/main/objfiles.txt" \
"$BUILD/src/bin/initdb/initdb.o" "$BUILD/src/backend/postgres"
# 🔴 LDFLAGS_EX_BE 必须带上 -Wl,--export-dynamic(见上方注释):
# 没有它,postgres 不导出 backend 符号,扩展模块 dlopen 时报
# "undefined symbol: CurrentMemoryContext"。官方本机构建靠 configure 探测拿到,
# 交叉编译探测被跳过 ⇒ 必须手动给。
make -C "$BUILD" -j"$NPROC" CC="$CC" COPT="$PGLITE_DEFS" \
LDFLAGS_EX="$LINK_OBJS" LDFLAGS_EX_BE="$LDFLAGS_EX_BE" LDFLAGS_SL=""
make -C "$BUILD" install CC="$CC" COPT="$PGLITE_DEFS" \
LDFLAGS_EX="$LINK_OBJS" LDFLAGS_EX_BE="$LDFLAGS_EX_BE" LDFLAGS_SL=""
rm -f "$BUILD/src/backend/main/main.o"
make -C "$BUILD/src/backend/main" main.o CC="$CC" COPT="$PGLITE_DEFS -Dmain=pgl_backend_main"
# ── 收集静态库 ───────────────────────────────────────────────
BACKEND_OBJS="$(cd "$BUILD" && cat $(find src/backend src/timezone -name objfiles.txt) | tr ' ' '\n' | sed '/^$/d' | sort -u)"
(cd "$BUILD" && {
echo "create libpglite.a"
for o in $BACKEND_OBJS; do echo "addmod $o"; done
echo "addlib src/common/libpgcommon_srv.a"
echo "addlib src/port/libpgport_srv.a"
echo "addmod ../pglitec.o"; echo "addmod ../pglite_native.o"; echo "addmod ../pglite_reset.o"
echo "addmod ../pglite_static_ext.o"
echo "save"
echo "end"
} | "$AR" -M && mv -f libpglite.a "$OUT/libpglite.a")
# ── 运行时资产 ───────────────────────────────────────────────
tar -C "$PREFIX" --exclude lib/postgresql/pgxs -cf "$OUT/pglite-runtime.tar" \
share/postgresql lib/postgresql "bin/initdb" "bin/postgres"
ls -lh "$OUT/libpglite.a" "$OUT/pglite-runtime.tar"
file "$OUT/libpglite.a"