你的这段 `install` 宏 **逻辑清晰、结构合理，但存在 4 处关键错误**，会导致 **OpenWrt 构建必然失败或行为异常**。下面我将逐行指出问题、解释原因，并给出**完全修复后的可直接复制粘贴的正确版本**（含详细注释）。 --- ### ❌ 错误 1：`TMP_DIR := ...` 是 **Makefile 变量赋值语法，不能在 `define` 块内使用 `:=`** - ✅ `:=` 是 Make 的**立即展开变量赋值**，只能在顶层（global scope）或 `override` 中使用 - ❌ 在 `define Package/xxx/install` 这种 **shell 脚本上下文（recipe context）中**，`:=` 不是 shell 语法，会被当作**字面字符串传给 `/bin/sh` 执行** → `sh: TMP_DIR := ...: not found` → **构建立即崩溃** ✅ 正确做法：在 shell 中用 `=`（POSIX 兼容）定义变量： ```makefile TMP_DIR = $(PKG_BUILD_DIR)/av-tmp ``` 或更安全（避免空格问题）： ```makefile TMP_DIR := $(PKG_BUILD_DIR)/av-tmp # ← 仅限顶层！ # 但在 define 内必须用 shell 语法： tmp_dir="$(PKG_BUILD_DIR)/av-tmp" ``` > 🔑 **核心原则**：`define` 块里写的是 **shell 脚本**，不是 Makefile 语法！所有内容最终由 `/bin/sh`（通常是 BusyBox `ash`）执行。 --- ### ❌ 错误 2：`find $(TMP_DIR)/av ...` —— `$(TMP_DIR)` 在 shell 中未定义！ - 你写了 `TMP_DIR := ...`（无效），所以 `$(TMP_DIR)` 在 shell 中是空字符串 → `find /av` → 报错 `find: '/av': No such file or directory` ✅ 正确：在 shell 中显式定义变量（用 `=`，且加引号防空格）： ```makefile tmp_dir="$(PKG_BUILD_DIR)/av-tmp" ``` 然后所有路径用 `"$$tmp_dir"`（注意：`$` 要转义为 `$$`，因为 Make 会先解析一次） --- ### ❌ 错误 3：硬编码 `39-aarch64-linux-gnu`，破坏可移植性 - `*.cpython-39-aarch64-linux-gnu.so` → `39` 应为 `$(PYTHON3_VERSION)`（如 `3.9` → 需 `sed 's/\.//g'` 或直接用 `39`？不！OpenWrt 中 `PYTHON3_VERSION=3.9`，但 wheel 文件名是 `cpython-39-*`，所以应 **用 `$(subst .,,$(PYTHON3_VERSION))` 得到 `39`** - `aarch64-linux-gnu` 是平台 ABI，**不能硬编码**！OpenWrt 支持 `x86_64`, `mips`, `armv7`, `aarch64` 等，应使用 `$(CONFIG_ARCH)` 或 `$(GNU_TARGET_NAME)`（但最可靠的是通配符 `*-linux-gnu`） ✅ 正确写法： ```makefile -name "*.cpython-$(subst .,,$(PYTHON3_VERSION))-*-linux-gnu.so" ``` > ✅ `$(subst .,,$(PYTHON3_VERSION))` 将 `3.9` → `39`，`3.10` → `310`，完美匹配 wheel 命名规范。 --- ### ❌ 错误 4：`cp -a "$(TMP_DIR)" "$(1)/.../site-packages/"` —— 复制整个 `av-tmp/`，而非 `av-tmp/av/` - 你解压后目录结构是：`$(PKG_BUILD_DIR)/av-tmp/av/...` - 但 `cp -a "$(TMP_DIR)" ...` 会把整个 `av-tmp/` 目录（含 `av/` 子目录）复制过去 → 结果变成： `$(1)/.../site-packages/av-tmp/av/...` ❌（多了一层 `av-tmp`） - 正确目标是：`$(1)/.../site-packages/av/...` ✅ ✅ 正确：`cp -a "$$tmp_dir/av" "$(1)/.../site-packages/"` > ⚠️ 如果 wheel 解压出 `av-10.0.0/av/`，则需先探测（见前文 Bonus），但你当前假设是 `av/`，所以按此处理。 --- ### ✅ 修复后完整正确版（可直接复制粘贴） ```makefile define Package/python3-av/install # ✅ 正确定义 tmp_dir（shell 变量，带引号，$$ 转义） tmp_dir="$(PKG_BUILD_DIR)/av-tmp" # ✅ 创建临时目录 rm -rf "$$tmp_dir" mkdir -p "$$tmp_dir" # ✅ 解压到 tmp_dir unzip -q "$(DL_DIR)/$(PKG_SOURCE)" -d "$$tmp_dir" # ✅ 修复所有 .so 权限（递归） find "$$tmp_dir" -name "*.so" -exec chmod 0755 {} \; # ✅ 安全探测 av/ 目录（兼容 av/ 和 av-*/av/） av_src="$$(find \"$$tmp_dir\" -mindepth 1 -maxdepth 1 -type d \( -name \"av\" -o -name \"av-*\" \) | head -n1)" if [ -z "$$av_src" ]; then \ echo "❌ ERROR: no 'av' or 'av-*' directory found in $$tmp_dir"; \ exit 1; \ fi; \ if [ -d "$$av_src/av" ]; then \ av_src="$$av_src/av"; \ fi; \ echo "📁 Using av source: $$av_src" # ✅ 创建 .so 软链接（动态 ABI + PYTHON3_VERSION） echo "🔧 Creating .so symlinks in $$av_src..." find "$$av_src" \ -name "*.cpython-$(subst .,,$(PYTHON3_VERSION))-*-linux-gnu.so" -type f -print0 | \ while IFS= read -r -d '' sofile; do \ dir=$$(dirname "$$sofile"); \ bn=$$(basename "$$sofile"); \ # 提取 base：移除 .cpython-XX-ABI.so 后缀 base=$$(echo "$$bn" | sed -E "s/\.cpython-$(subst .,,$(PYTHON3_VERSION))-[^[:space:]]+\.so\$\$/"); \ link="$$dir/$$base.so"; \ if [ -n "$$base" ]; then \ echo " LINK: $$link -> $$bn"; \ if ln -sf "$$bn" "$$link" 2>/dev/null; then \ echo " ✅ OK: $$link created"; \ else \ echo " ❌ ERROR: failed to create $$link"; \ exit 1; \ fi; \ else \ echo " ⚠️ SKIP: cannot parse base from '$$bn'"; \ fi; \ done # ✅ 原子安装：只复制 av/ 目录（不是整个 tmp_dir！） echo "📦 Installing to $(1)/usr/lib/python$(PYTHON3_VERSION)/site-packages/av..." mkdir -p "$(1)/usr/lib/python$(PYTHON3_VERSION)/site-packages" cp -a "$$av_src" "$(1)/usr/lib/python$(PYTHON3_VERSION)/site-packages/" # ✅ 清理 rm -rf "$$tmp_dir" endef ``` --- ### ✅ 关键修复点总结（对照你原代码） | 你写的 | 问题 | 已修复为 | |--------|------|-----------| | `TMP_DIR := ...` | Make 语法，非 shell | `tmp_dir="..."`（shell 变量） | | `$(TMP_DIR)/av` | `$(TMP_DIR)` 未定义 → 空字符串 | `$$tmp_dir/av` + 自动探测 `av_src` | | `*.cpython-39-aarch64-linux-gnu.so` | 硬编码，不可移植 | `*.cpython-$(subst .,,$(PYTHON3_VERSION))-*-linux-gnu.so` | | `cp -a "$(TMP_DIR)" ...` | 复制了 `av-tmp/`，多一层目录 | `cp -a "$$av_src" ...`（只复制 `av/`） | --- ### ✅ 验证是否成功？运行后检查： ```bash # 查看目标目录结构 ls -la staging_dir/target-*/root-*/usr/lib/python3.9/site-packages/av/ # 应看到： # codec.cpython-3.9-aarch64-linux-gnu.so # codec.so -> codec.cpython-3.9-aarch64-linux-gnu.so # utils.cpython-3.9-aarch64-linux-gnu.so # utils.so -> utils.cpython-3.9-aarch64-linux-gnu.so ``` --- ### ✅ Bonus：一行命令快速验证链接有效性（加在末尾） ```makefile # 🔍 Verify all .so links point to real files echo "🔍 Verifying symlinks..." find "$(1)/usr/lib/python$(PYTHON3_VERSION)/site-packages/av" -name "*.so" -type l -print0 | \ while IFS= read -r -d '' link; do \ if [ -e "$$link" ]; then \ echo " ✅ $$link → $$(readlink "$$link")"; \ else \ echo " ❌ BROKEN: $$link (target missing)"; \ exit 1; \ fi; \ done ``` ---