离线SDK5.0.7版本 && Xcode 26.5 编译报错

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

这个问题是由于 Xcode 26 对静态库（.a 文件）的 .o 目标文件有了更严格的 8 字节对齐要求，而离线 SDK 5.0.7 中部分静态库（如 libTouchJSON.a、libmp3lame.a）的编译方式不满足这一新规范导致的。

根据社区反馈，目前可以通过编写脚本对受影响的静态库进行重新打包来解决。你可以参考以下步骤：

1. 定位受影响的库文件：在你的 SDK 目录中，找到报错的库文件，通常是 SDK/SDK/libs/libmp3lame.a 和 SDK/SDK/libs/libTouchJSON.a。

2. 备份原文件：为了防止操作失误，建议先备份这两个文件。

3. 使用脚本修复对齐问题：在终端中执行以下脚本，它会提取库中的目标文件并重新打包，以修复对齐问题。

#!/bin/bash  

# 修复静态库 .o 文件 8 字节对齐问题  
# 适用于 Xcode 26 / 新版 ld 要求  

set -e  

# 获取当前脚本所在目录，请根据实际情况调整 LIBS_DIR 路径  
BASE_DIR="$(cd "$(dirname "$0")" && pwd)"  
LIBS_DIR="$BASE_DIR/SDK/SDK/Libs"  
WORK_DIR="/tmp/fix_alignment_work"  

fix_library() {  
    local LIB_PATH="$1"  
    local LIB_NAME=$(basename "$LIB_PATH")  
    echo "=========================================="  
    echo "正在修复: $LIB_NAME"  
    echo "=========================================="  

    # 备份原文件  
    if [ ! -f "${LIB_PATH}.bak" ]; then  
        cp "$LIB_PATH" "${LIB_PATH}.bak"  
        echo "✅ 已备份为 ${LIB_NAME}.bak"  
    else  
        echo "⚠️ 备份已存在，跳过备份"  
    fi  

    # 获取架构列表  
    ARCHS=$(xcrun lipo -info "$LIB_PATH" | sed 's/.*are: //' | sed 's/.*is architecture: //')  
    echo "包含架构: $ARCHS"  

    # 创建工作目录  
    rm -rf "$WORK_DIR"  
    mkdir -p "$WORK_DIR"  

    local THIN_LIBS=()  
    for ARCH in $ARCHS; do  
        echo " 处理架构: $ARCH"  
        local ARCH_DIR="$WORK_DIR/$ARCH"  
        mkdir -p "$ARCH_DIR"  
        # 提取单架构  
        xcrun lipo "$LIB_PATH" -thin "$ARCH" -output "$ARCH_DIR/thin.a"  
        # 使用 libtool 重新打包（会修复对齐问题）  
        cd "$ARCH_DIR"  
        xcrun ar x thin.a  
        rm -f thin.a .SYMDEF "*.SYMDEF SORTED"  
        xcrun libtool -static -o "fixed_${ARCH}.a" *.o  
        THIN_LIBS+=("$ARCH_DIR/fixed_${ARCH}.a")  
        cd "$BASE_DIR"  
    done  

    # 合并回 fat 库  
    xcrun lipo -create "${THIN_LIBS[@]}" -output "$LIB_PATH"  
    echo "✅ 修复完成: $LIB_PATH"  
    echo ""  
}  

# 修复需要处理的库  
fix_library "$LIBS_DIR/libmp3lame.a"  
fix_library "$LIBS_DIR/libTouchJSON.a"  

echo "全部修复完成！"

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

1. 保存并运行脚本：将上述脚本保存为 fix_alignment.sh 文件，放在与 SDK 目录同级的路径下，然后在终端中运行 bash fix_alignment.sh。

2. 重新编译：脚本执行完毕后，回到 Xcode 清理项目（Product -> Clean Build Folder），然后重新编译运行即可。

这个问题的根本原因是 Xcode 26 工具链的更新，官方后续发布的离线 SDK 版本应该会修复此问题。如果你暂时不想使用脚本，也可以关注官方离线 SDK 的更新动态：iOS平台SDK下载。