Xcode macOS Swift项目中libimobiledevice.a未定义符号问题求助

问题根源 #

你遇到的_ASN1_INTEGER_free、_ASN1_INTEGER_new等未定义符号，确实是因为libimobiledevice编译时未正确关联openssl的libcrypto库。brew安装的libimobiledevice依赖系统或brew的openssl，但通过build_xcf.sh单独编译时，脚本没有自动引入openssl的依赖，导致生成的xcframework缺失相关符号引用。

解决方案 #

步骤1：确认openssl版本与路径 #

先确保brew安装的openssl版本与libimobiledevice依赖匹配，并获取其安装路径：

# 查看libimobiledevice依赖的openssl版本
brew info libimobiledevice
# 获取openssl安装根目录
export OPENSSL_ROOT=$(brew --prefix openssl)

步骤2：修改build_xcf.sh，添加openssl编译与关联 #

修改原脚本，让它在编译libimobiledevice时指定openssl路径，同时可选生成openssl的xcframework：

1. 在脚本中添加openssl编译函数（如果需要单独生成openssl xcframework）：

build_openssl() {
    local ARCH=$1
    local SDK=$2
    local BUILD_DIR=$3
    local OPENSSL_SRC_DIR=./openssl

    # 拉取对应版本的openssl源码（版本需与libimobiledevice依赖一致）
    if [ ! -d "$OPENSSL_SRC_DIR" ]; then
        git clone --depth 1 --branch openssl-3.0.10 https://github.com/openssl/openssl.git $OPENSSL_SRC_DIR
    fi

    cd $OPENSSL_SRC_DIR
    make clean
    # 根据架构配置编译参数
    if [ "$ARCH" = "arm64" ]; then
        ./Configure ios64-cross --prefix=$BUILD_DIR/$ARCH
    else
        ./Configure iossimulator-x86_64 --prefix=$BUILD_DIR/$ARCH
    fi
    make -j$(sysctl -n hw.ncpu)
    make install_sw
    cd ..
}

2. 修改libimobiledevice的编译配置，添加openssl依赖参数：

# 在编译libimobiledevice的configure命令中添加--with-openssl
./configure --host=$HOST \
    --prefix=$BUILD_DIR/$ARCH \
    --enable-static --disable-shared \
    --with-openssl=$OPENSSL_ROOT \
    --with-libplist=$BUILD_DIR/$ARCH \
    --with-libusbmuxd=$BUILD_DIR/$ARCH

3. 执行脚本重新编译所有库，包括openssl（如果添加了上述函数）。

步骤3：手动生成openssl xcframework（如果修改脚本有困难） #

如果不想改动原脚本，可以单独编译openssl为xcframework：

1. 创建编译目录并拉取源码：

mkdir -p openssl-build/{arm64,x86_64}
git clone --depth 1 --branch openssl-3.0.10 https://github.com/openssl/openssl.git
cd openssl

2. 编译真机arm64架构：

./Configure ios64-cross --prefix=$(pwd)/../openssl-build/arm64
make clean && make -j$(sysctl -n hw.ncpu) && make install_sw

3. 编译模拟器x86_64架构：

make clean
./Configure iossimulator-x86_64 --prefix=$(pwd)/../openssl-build/x86_64
make -j$(sysctl -n hw.ncpu) && make install_sw

4. 打包为xcframework：

xcodebuild -create-xcframework \
    -library ../openssl-build/arm64/lib/libcrypto.a \
    -headers ../openssl-build/arm64/include \
    -library ../openssl-build/x86_64/lib/libcrypto.a \
    -headers ../openssl-build/x86_64/include \
    -output ../openssl.xcframework

步骤4：Xcode项目配置调整 #

1. 将生成的openssl.xcframework添加到项目的Frameworks, Libraries and Embedded content中，设置为Embed & Sign。
2. 调整库的链接顺序：在Xcode的Build Phases -> Link Binary With Libraries中，将openssl.xcframework移到libimobiledevice.xcframework上方（链接器从后往前解析符号，依赖库需前置）。
3. 清理Xcode派生数据（Product -> Clean Build Folder），重新编译项目。

内容的提问来源于stack exchange，提问作者swainwri