上游 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 解出的二进制端到端复测同样通过。
132 lines
6.2 KiB
Bash
Executable File
132 lines
6.2 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
#
|
||
# build-armv7.sh —— 一键交叉编译 armv7 版 sspf-admin(Linux 32 位 ARM, hard-float)
|
||
#
|
||
# 🔴 为什么需要这个脚本(2026-11-12):
|
||
# ssw-platform 的后端把 PostgreSQL 引擎(`libpglite.a`)**静态链进二进制**。
|
||
# 上游 `pglite-rs` 只发布 x86_64 / aarch64 的 darwin 与 linux-gnu 预编译引擎,
|
||
# **没有 armv7** ⇒ 要出 armv7 包必须自己交叉编译引擎 + 交叉链接 Rust 侧。
|
||
#
|
||
# 两条路的取舍(都实测过):
|
||
# A. arm/v7 容器内原生编译(qemu 模拟)—— ❌ apt 装依赖就跑了 9 分钟,
|
||
# PostgreSQL 全量 make 在 qemu 下要数小时,不可行。
|
||
# B. amd64 容器 + arm-linux-gnueabihf 交叉工具链 —— ✅ 本脚本。
|
||
# 容器是原生 x86_64,编译速度正常;Rust 侧用 zig cc 当 linker
|
||
# (zig 0.14.1 自带 lld 与 armv7 libc,免装交叉 libc)。
|
||
#
|
||
# 产物:
|
||
# target/armv7-unknown-linux-gnueabihf/release/sspf-admin (ARM EABI5 可执行)
|
||
# dist/pglite-engine-armv7/ (引擎:libpglite.a + runtime + 头文件)
|
||
#
|
||
# 用法:
|
||
# bash scripts/build-armv7.sh # 只编译二进制
|
||
# bash scripts/build-armv7.sh --engine-only # 只编译引擎
|
||
# bash scripts/build-armv7.sh --skip-engine # 复用已有引擎,只重编二进制
|
||
#
|
||
# 环境变量:
|
||
# PGLITE_ENGINE_TAG 上游引擎 tag(默认 engine-06c837c6a303-p3)
|
||
# PG_SRC_COMMIT postgres-pglite 源码 commit(默认该 tag 对应的 06c837c6a303…)
|
||
# ENGINE_DIR 引擎产物目录(默认 dist/pglite-engine-armv7)
|
||
# SKIP_DOWNLOAD=1 复用已下载的源码 tarball
|
||
#
|
||
set -euo pipefail
|
||
|
||
cd "$(dirname "$0")/.."
|
||
REPO_ROOT="$(pwd)"
|
||
|
||
ENGINE_TAG="${PGLITE_ENGINE_TAG:-engine-06c837c6a303-p3}"
|
||
PG_SRC_COMMIT="${PG_SRC_COMMIT:-06c837c6a30335169df786c610ed224bc51d81c0}"
|
||
ENGINE_DIR="${ENGINE_DIR:-${REPO_ROOT}/dist/pglite-engine-armv7}"
|
||
TARGET_TRIPLE="armv7-unknown-linux-gnueabihf"
|
||
WORK="${WORK:-/tmp/sspf-armv7-build}"
|
||
|
||
ENGINE_ONLY=0
|
||
SKIP_ENGINE=0
|
||
for a in "$@"; do
|
||
case "$a" in
|
||
--engine-only) ENGINE_ONLY=1 ;;
|
||
--skip-engine) SKIP_ENGINE=1 ;;
|
||
-h|--help) sed -n '1,40p' "$0"; exit 0 ;;
|
||
*) echo "未知参数: $a" >&2; exit 2 ;;
|
||
esac
|
||
done
|
||
|
||
# ── 1. 引擎 ──────────────────────────────────────────────────
|
||
if [[ "${SKIP_ENGINE}" == "0" ]]; then
|
||
echo "==> [1/3] 构建 armv7 PGlite 引擎(上游 ${ENGINE_TAG})"
|
||
bash "${REPO_ROOT}/scripts/build-pglite-engine.sh" \
|
||
--engine-tag "${ENGINE_TAG}" \
|
||
--pg-commit "${PG_SRC_COMMIT}" \
|
||
--out "${ENGINE_DIR}" \
|
||
--work "${WORK}"
|
||
else
|
||
echo "==> [1/3] 跳过引擎构建(复用 ${ENGINE_DIR})"
|
||
fi
|
||
|
||
if [[ "${ENGINE_ONLY}" == "1" ]]; then
|
||
echo "==> 仅引擎模式完成: ${ENGINE_DIR}"
|
||
exit 0
|
||
fi
|
||
|
||
# ── 2. Rust 侧交叉编译 ───────────────────────────────────────
|
||
echo "==> [2/3] 交叉编译 sspf-admin → ${TARGET_TRIPLE}"
|
||
# 🔴 链接器用 zig cc:zig 自带 lld + armv7 glibc 头/库,免去装 armhf 交叉 libc。
|
||
# CARGO_TARGET_<TRIPLE>_LINKER 是 cargo 的官方约定(不需要改仓库 .cargo/config)。
|
||
# 包装脚本在 scripts/zig-cc-armv7.sh(改写 -Wl,/path + 注入 sysroot)。
|
||
# 🔴 PGLITE_LIB_DIR 让 pglite-rs-sys 的 build.rs 用我们自建的引擎,
|
||
# 而不是去 GitHub 下不存在的 armv7 预编译包。
|
||
export PGLITE_LIB_DIR="${ENGINE_DIR}"
|
||
|
||
# 🔴🔴 **必须关掉 strip**(2026-11-12 定位,踩了两轮才找到):
|
||
# 仓库根 Cargo.toml 的 `[profile.release] strip = "symbols"` 会让 rustc 在链接前
|
||
# **重建** native 静态库(放到 `deps/rustcXXXX/libpglite.a`),重建时把
|
||
# `ProcessStartupPacket` 从全局 `T` 降级成局部 `t`、`pgl_shmem_reset` 直接消失
|
||
# ⇒ 链接期报 undefined symbol: ProcessStartupPacket / pgl_shmem_reset / ...
|
||
# (实测:重建后的归档比原件小 3228 字节,恰好 4 个 ARM 符号 × 24 字节)
|
||
# ⇒ 规避办法:本次交叉构建覆盖 strip=none。
|
||
# ⚠️ 只影响交叉构建,仓库默认 profile 不动(宿主机 x86_64 构建不受影响)。
|
||
export CARGO_PROFILE_RELEASE_STRIP="${CARGO_PROFILE_RELEASE_STRIP:-none}"
|
||
|
||
# 🔴 zig cc 不认 `-Wl,/abs/path` 合并写法(报 unsupported linker arg),
|
||
# 用仓库里的包装脚本改写成裸路径;它还会注入 armhf sysroot(提供 -lz)。
|
||
export ZIG_SYSROOT="${ZIG_SYSROOT:-${ENGINE_DIR}/sysroot}"
|
||
export CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER="${REPO_ROOT}/scripts/zig-cc-armv7.sh"
|
||
|
||
echo " 引擎目录(PGLITE_LIB_DIR): ${ENGINE_DIR}"
|
||
echo " 链接器(zig cc): ${CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER}"
|
||
echo " sysroot: ${ZIG_SYSROOT}"
|
||
echo " strip: ${CARGO_PROFILE_RELEASE_STRIP}(交叉构建必须 none,见脚本注释)"
|
||
cargo build --release --target "${TARGET_TRIPLE}" -p sspf-admin
|
||
|
||
BIN="target/${TARGET_TRIPLE}/release/sspf-admin"
|
||
[[ -x "${BIN}" ]] || { echo "!! 找不到 ${BIN}" >&2; exit 1; }
|
||
file "${BIN}"
|
||
|
||
# ── 3. 冒烟:在 arm/v7 容器里真跑一下 ─────────────────────────
|
||
echo "==> [3/3] arm/v7 容器冒烟(起服务 → 探活 → 停)"
|
||
SMOKE_DIR="${WORK}/smoke"
|
||
DATA_DIR="${WORK}/pgdata"
|
||
mkdir -p "${SMOKE_DIR}" "${DATA_DIR}"
|
||
cp "${BIN}" "${SMOKE_DIR}/sspf-admin"
|
||
# 🔴 用 arm32v7/debian:bookworm-slim(armhf 基础镜像)而不是 debian:bookworm-slim:
|
||
# 后者是 amd64 镜像,--platform linux/arm/v7 拉下来还得 qemu 转译,白白慢。
|
||
docker run --rm --platform linux/arm/v7 \
|
||
-v "${SMOKE_DIR}:/app:ro" -v "${DATA_DIR}:/data" \
|
||
arm32v7/debian:bookworm-slim sh -c '
|
||
cd /tmp && PGLITE_DIR=/data/pg PORT=30077 /app/sspf-admin > /tmp/srv.log 2>&1 &
|
||
PID=$!
|
||
for i in $(seq 1 90); do
|
||
if wget -q -O /dev/null http://127.0.0.1:30077/api/oauth/CurrentUser 2>/dev/null; then
|
||
echo "HTTP-OK"; break
|
||
fi
|
||
kill -0 $PID 2>/dev/null || break
|
||
sleep 2
|
||
done
|
||
head -30 /tmp/srv.log
|
||
kill $PID 2>/dev/null
|
||
' 2>&1 | tail -30
|
||
|
||
echo ""
|
||
echo "✅ armv7 产物: ${BIN}"
|
||
echo " 引擎: ${ENGINE_DIR}"
|