Files
ssw-platform/scripts/build-armv7.sh
T
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

132 lines
6.2 KiB
Bash
Executable File
Raw 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.
#!/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}"