#!/usr/bin/env bash # 打包 Ubuntu/Linux 发布包(--onedir 目录形式)。 # # CPU / GPU 两个变体由**构建环境里装的 paddlepaddle 版本**自动决定,不需要手动指定: # 装了 paddlepaddle -> CPU 包,输出到 dist/ # 装了 paddlepaddle-gpu -> GPU 包,dist/ocr-server-gpu/,且 config.yaml 的 device 预置为 auto # GPU 包的同一个分发包在没显卡的机器上也能启动(会自动回落 CPU,见 README)。 # # 关键参数说明,改动前请先读: # --collect-all paddle/paddlex/paddleocr Paddle 的原生库与配置必须整体收集,缺一个就跑不起来 # --collect-all pyclipper/pypdfium2/shapely/bidi # 检测后处理与识别的必需依赖,漏了会在推理时报错 # --copy-metadata * PaddleX 通过 importlib.metadata 检查依赖, # 缺元数据会误判「依赖未安装」。 # ⚠️ paddle 的发行包名随变体变化(paddlepaddle / # paddlepaddle-gpu),写死会打不出包, # 所以由 scripts/paddle_env.py 动态取。 # --additional-hooks-dir scripts 启用 scripts/hook-imagesize.py # --hidden-import imagesize 源码环境下按需导入,打包时必须显式声明 # # 必须在 Linux 上执行:PyInstaller 不能交叉编译,Windows 上无法生成 ELF 二进制。 # # 用法: # ./scripts/package-ubuntu.sh # 按环境自动判断变体 # ./scripts/package-ubuntu.sh --gpu # 断言必须是 GPU 版 paddle set -euo pipefail PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" cd "$PROJECT_ROOT" if [[ "$(uname -s)" != "Linux" ]]; then printf '%s\n' '该脚本必须在 Ubuntu/Linux 环境执行,不能在 Windows 上生成 ELF 二进制。' >&2 exit 1 fi REQUIRE_GPU=0 for arg in "$@"; do case "$arg" in --gpu) REQUIRE_GPU=1 ;; *) printf '未知参数:%s\n' "$arg" >&2 exit 2 ;; esac done # --inexact + --no-install-package paddlepaddle:只同步除 paddle 以外的依赖。 # pyproject.toml 里声明的是 CPU 版 paddlepaddle,裸跑 uv sync 会「卸载 # paddlepaddle-gpu 和全部 nvidia-* 运行库、装回 CPU 版」,把 GPU 环境悄悄冲掉; # 而单独用 --no-install-package 又会把 paddlepaddle-gpu 当多余包删掉。 # 这两个参数合用才能保住当前装的 paddle 变体(实测 dry-run 为 no changes)。 uv sync --dev --inexact --no-install-package paddlepaddle --python 3.12 # ── 判断变体 ────────────────────────────────────────────────── VARIANT="$(uv run --no-sync python scripts/paddle_env.py variant)" PADDLE_DIST="$(uv run --no-sync python scripts/paddle_env.py distribution)" if [[ "$VARIANT" == "missing" ]]; then printf '%s\n' '环境里没有安装 paddlepaddle,请先执行 uv sync。' >&2 exit 1 fi if [[ "$REQUIRE_GPU" == "1" && "$VARIANT" != "gpu" ]]; then cat >&2 </bin,正好是 paddle 在 __init__.py 里 # 用 os.add_dll_directory 寻找的路径(os.path.dirname(paddle.__file__)/../nvidia)。 EXTRA_COLLECT=() if [[ "$BUILD_VARIANT" == "gpu" ]]; then EXTRA_COLLECT=(--collect-binaries nvidia) fi uv run --no-sync pyinstaller --noconfirm --clean --onedir --name "$APP_NAME" \ --distpath "$DIST_PATH" \ --paths src \ --collect-all paddleocr \ --collect-all paddlex \ --collect-all paddle \ "${EXTRA_COLLECT[@]+"${EXTRA_COLLECT[@]}"}" \ --collect-all cv2 \ --collect-all PIL \ --collect-all pyclipper \ --collect-all pypdfium2 \ --collect-all shapely \ --collect-all bidi \ --hidden-import paddlex.inference.models.text_detection.processors \ --copy-metadata paddlex \ --copy-metadata paddleocr \ --copy-metadata "$PADDLE_DIST" \ --copy-metadata imagesize \ --add-data 'config.yaml:.' \ --add-data 'http:http' \ --additional-hooks-dir scripts \ --hidden-import imagesize \ --hidden-import imagesize.imagesize \ --hidden-import ocr_server.app \ --hidden-import ocr_server.config \ scripts/packaged_entry.py # shellcheck disable=SC2086 uv run --no-sync python scripts/prepare_release_config.py config.yaml "$RELEASE_DIR/config.yaml" $CONFIG_OVERRIDE cp -a models "$RELEASE_DIR/models" chmod +x "$RELEASE_DIR/ocr-server" BIN="$RELEASE_DIR/$APP_NAME" if [[ ! -x "$BIN" ]]; then printf '打包失败:未生成 %s\n' "$BIN" >&2 exit 1 fi TOTAL_MB="$(du -sm "$RELEASE_DIR" | cut -f1)" printf '\nUbuntu 发布目录:%s\n' "$RELEASE_DIR" printf '变体:%s\n' "$BUILD_VARIANT" printf '%s\n' '启动:'"$RELEASE_DIR/$APP_NAME" printf '整个发布目录体积:%s MB\n' "$TOTAL_MB" printf '二进制 SHA256:%s\n' "$(sha256sum "$BIN" | cut -d' ' -f1)" if [[ "$BUILD_VARIANT" == "gpu" ]]; then printf '%s\n' '已把发布包里的 config.yaml 预置为 device: auto;有可用显卡时用 GPU,否则自动用 CPU。' else printf '%s\n' 'CPU 包。客户机若要用 GPU,需要改用 GPU 版分发包(用 paddlepaddle-gpu 环境重新打包)。' fi printf '%s\n' '(发布时要连 _internal 和 models 一起复制,不能只替换二进制)'