#!/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__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}"