#!/bin/sh # build_defender_lib.sh — 把 defender/ 全部 C 源交叉编译并打包成可集成静态库。 # # 产物(默认输出到 dist/): # dist/lib/libIGDefender.a arm64 iphoneos 静态库 # dist/include/IGGuard.h 统一公共头(umbrella) # dist/include/... 随附的全部公共头(保持相对目录,供 IGGuard.h 相对引用) # # 用法: # sh tools/build_defender_lib.sh [输出目录] # sh tools/build_defender_lib.sh # → ./dist # sh tools/build_defender_lib.sh /path/to/out # → 指定目录 # # 接入方式见 docs/18_READOOR_DEFENDER_INTEGRATION.md。 set -eu ROOT=$(cd "$(dirname "$0")/.." && pwd) OUT=${1:-"$ROOT/dist"} SDK=iphoneos ARCH=arm64 MINVER=15.0 # -fvisibility=hidden(§7 抗静态调用关系):默认隐藏所有符号,只有头里标 IG_PUBLIC 的 # 入口导出;内部的 ig_poison_mark/mask、ig_policy_* 等成为 private extern,接入方最终 # 链接 + strip 后从符号表消失,nm 再也捞不到名字。 CFLAGS="-arch $ARCH -miphoneos-version-min=$MINVER -O2 -Wall -Wextra -fvisibility=hidden -I$ROOT/defender -I$ROOT/defender/include" # §7.3 OLLVM/VMP 钩子(默认不启用):设 IG_OBFUSCATOR=/path/to/ollvm-clang 时,用它编译 # 毒化/策略两个敏感 TU 并附加 Fla/BCF/Sub 混淆;未设则用 stock clang,不做混淆(如实)。 OBF_CC=${IG_OBFUSCATOR:-} OBF_FILES="defender/poison/IGPoison.c defender/policy/IGPolicy.c" OBF_FLAGS="-mllvm -fla -mllvm -bcf -mllvm -sub" # 先让 §7.1 混淆表与路径清单保持同步(CI 口径:不一致即失败)。 python3 "$ROOT/tools/gen_jb_paths.py" --check OBJDIR=$(mktemp -d) trap 'rm -rf "$OBJDIR"' EXIT echo "[1/4] 交叉编译 ($SDK/$ARCH)…" find "$ROOT/defender" -name '*.c' | while read -r f; do o="$OBJDIR/$(echo "$f" | sed "s|$ROOT/||; s|/|_|g").o" rel=${f#"$ROOT/"} if [ -n "$OBF_CC" ] && echo "$OBF_FILES" | grep -qw "$rel"; then echo " [obf] $rel" xcrun -sdk "$SDK" "$OBF_CC" $CFLAGS $OBF_FLAGS -c "$f" -o "$o" else xcrun -sdk "$SDK" clang $CFLAGS -c "$f" -o "$o" fi done echo "[2/4] 打包 libIGDefender.a…" mkdir -p "$OUT/lib" "$OUT/include" xcrun -sdk "$SDK" ar rcs "$OUT/lib/libIGDefender.a" "$OBJDIR"/*.o xcrun -sdk "$SDK" ranlib "$OUT/lib/libIGDefender.a" echo "[3/4] 拷贝公共头…" # 单一 HEADER_SEARCH_PATH=/include 即自洽: # - defender/include/ 下的头(IGGuard.h / IGDefender.h …)平移到 include 根 # - 其余子目录头(poison/ policy/ syscall/ …)保持相对目录,供 umbrella 相对引用 ( cd "$ROOT/defender" && \ find . -name '*.h' | sed 's|^\./||' | sort -u | while read -r h; do case "$h" in include/*) dst="${h#include/}" ;; # include/ 下平移到根 *) dst="$h" ;; esac mkdir -p "$OUT/include/$(dirname "$dst")" cp "$ROOT/defender/$h" "$OUT/include/$dst" done ) echo "[4/4] 校验可见性(§7):公共入口导出(T)、内部符号已私有化…" echo " — 导出入口(应为 IG_PUBLIC 四个):" xcrun -sdk "$SDK" nm -g "$OUT/lib/libIGDefender.a" 2>/dev/null \ | grep -E ' T _ig_(policy_scan_and_mark|poison_apply|poison_init|defender_scan)$' | sort -u || true echo " — 内部符号可见性(应标 private external,最终 strip 后消失):" xcrun -sdk "$SDK" nm -m "$OUT/lib/libIGDefender.a" 2>/dev/null \ | grep -E '_ig_(poison_mark|poison_mask|policy_sink|policy_evaluate_and_mark|anti_jb_check)$' \ | sed 's/^/ /' | sort -u | head -20 || true echo "完成:$OUT/lib/libIGDefender.a ($(lipo -archs "$OUT/lib/libIGDefender.a"))" echo "公共头:$OUT/include/IGGuard.h"