Xcode16编译iOS12兼容项目时libswift_Concurrency.dylib加载崩溃问题

问题背景 #

项目支持iOS12，依赖libswift_Concurrency.dylib实现异步功能。切换到Xcode16编译后，该库的加载路径被设置为/usr/lib/swift/libswift_Concurrency.dylib（弱引用，兼容版本1.0.0，当前版本0.0.0）。但iOS14系统的/usr/lib/swift/目录下不存在这个库，导致App调用Task、async、await等方法时因符号未解析崩溃，堆栈包含swift_getTypeByMangledName等调用。将IPHONEOS_DEPLOYMENT_TARGET设为iOS13时，路径会变为@rpath/libswift_Concurrency.dylib，可从App的Frameworks目录正常加载，但项目必须保留iOS12支持，此方案不可行。Xcode15下无此问题。

可行解决方案 #

1. 修改链接器参数强制指定库路径 #

在Xcode项目的Build Settings中，找到Other Linker Flags，添加以下参数：

-Xlinker -rpath -Xlinker @executable_path/Frameworks
-Xlinker -force_load_swift_libs

同时确保Always Embed Swift Standard Libraries设置为YES。
该参数会强制链接器优先使用App包内的Swift库路径，覆盖Xcode16针对iOS12部署目标时的系统路径默认设置。

2. 手动调整库的安装路径 #

通过Xcode的Run Script Phase在编译后修改库的加载路径：

1. 给Target添加一个新的Run Script Phase，放在"Embed Frameworks"之后。
2. 输入以下脚本：

# 定位libswift_Concurrency.dylib路径
FRAMEWORK_PATH="${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/libswift_Concurrency.dylib"
if [ -f "$FRAMEWORK_PATH" ]; then
    # 修改库自身的ID为@rpath路径
    install_name_tool -id "@rpath/libswift_Concurrency.dylib" "$FRAMEWORK_PATH"
    # 修正主二进制文件中的引用路径
    MAIN_EXECUTABLE="${BUILT_PRODUCTS_DIR}/${EXECUTABLE_PATH}"
    otool -L "$MAIN_EXECUTABLE" | grep "/usr/lib/swift/libswift_Concurrency.dylib"
    if [ $? -eq 0 ]; then
        install_name_tool -change "/usr/lib/swift/libswift_Concurrency.dylib" "@rpath/libswift_Concurrency.dylib" "$MAIN_EXECUTABLE"
    fi
fi

脚本会在编译完成后，将主二进制文件中对系统路径库的引用替换为@rpath路径，同时修正库自身的ID标识。

3. 使用Xcode隐藏构建设置 #

在Build Settings中添加User-Defined Setting：

• 键：SWIFT_FORCE_DYNAMIC_STDLIB
• 值：YES
  该设置会强制Swift使用动态标准库，即使部署目标是iOS12，从而让链接器默认使用@rpath路径而非系统路径。

4. 条件编译隔离异步代码（兜底方案） #

如果以上方案均不生效，可对iOS14及以下系统的异步代码做条件编译，使用替代实现：

#if !targetEnvironment(macCatalyst) && os(iOS) && iOS_VERSION < 15
// iOS14及以下使用GCD等非async/await逻辑
func fetchData(completion: @escaping (Result<Data, Error>) -> Void) {
    DispatchQueue.global().async {
        // 同步业务逻辑实现
        completion(.success(data))
    }
}
#else
// iOS15+及其他平台使用async/await
func fetchData() async throws -> Data {
    // 异步业务逻辑实现
    return data
}
#endif

该方案需额外维护代码分支，但能彻底避免iOS14上的库加载问题，同时保留iOS12支持。

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