上游 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 解出的二进制端到端复测同样通过。
149 lines
7.5 KiB
Bash
Executable File
149 lines
7.5 KiB
Bash
Executable File
#!/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"
|