Swift Package Manager集成公司内部包Release模式编译崩溃求助

SPM集成与源码直接集成的核心差异 #

• 编译参数继承规则：源码直接集成时，库的编译参数完全跟随主项目构建设置；SPM集成的包默认使用自身Package.swift中定义的编译配置，仅显式声明配置继承时才会同步主项目参数，之前单独修改主项目优化选项不生效大概率是该原因导致
• 依赖解析规则：SPM会自动解析全链路依赖版本，存在你集成的xcframework版本和内部库预期版本不一致的可能；源码集成时依赖完全由主项目手动管理，不会出现自动替换版本的问题
• 符号可见性规则：SPM Release模式下默认会对内部包的符号做隐藏和剥离优化，可能导致ObjC runtime相关的符号、分类调用失败，进而导致AVPlayerItemVideoOutput初始化返回nil
• 模块隔离规则：SPM集成的每个包都是独立模块，默认internal访问权限的代码/分类仅在包内部可见；源码集成时如果和主项目在同一个target下，internal权限的内容全局可见，可能存在内部库依赖的内部分类在SPM集成时无法生效，导致初始化失败的情况

针对性排查步骤 #

1. 先确认AVPlayerItemVideoOutput返回nil的根本原因，替换原有强制解包代码，新增上下文日志输出：

self.playerItem = AVPlayerItem(asset: asset)
let outputSettings = [
    kCVPixelBufferPixelFormatTypeKey as String: NSNumber(value:kCVPixelFormatType_32BGRA),
    kCVPixelBufferMetalCompatibilityKey as String: NSNumber(value: true)
]
// 替换原有强制初始化逻辑，新增错误捕获
guard let videoOutput = AVPlayerItemVideoOutput(outputSettings: outputSettings) else {
    print("AVPlayerItemVideoOutput初始化失败，参数：\(outputSettings)，设备：\(UIDevice.current.model)，系统：\(UIDevice.current.systemVersion)")
    return
}
self.videoOutput = videoOutput
self.playerItem?.add(videoOutput)

2. 核对依赖的xcframework版本，确认SPM解析的版本和内部库测试用的版本完全一致，SPM多链路依赖同一个xcframework时会自动选择最高兼容版本，可能和内部库适配的版本不匹配
3. 验证SPM配置有效性：使用path参数本地依赖内部库源码，排除远程依赖缓存、版本差异的干扰，如果本地路径依赖也崩溃即可确定是编译配置问题

编译参数调整方案 #

• 在内部库的Package.swift中显式指定Release模式编译选项，覆盖SPM默认配置：

.target(
    name: "你的内部库名称",
    dependencies: [],
    swiftSettings: [
        // 禁用Release模式Swift编译优化
        .unsafeFlags(["-O0"], .when(configuration: .release)),
        // 强制启用ObjC交互，避免runtime相关调用失效
        .unsafeFlags(["-Xfrontend", "-enable-objc-interop"], .when(configuration: .release))
    ],
    cSettings: [
        // 禁用Release模式Clang编译优化
        .unsafeFlags(["-O0"], .when(configuration: .release))
    ]
)

• 主项目的Other Linker Flags中添加-no_dead_strip参数，禁用符号死代码剥离，避免AVFoundation相关的分类、符号被优化掉
• 如果依赖的xcframework是静态库类型，在Package.swift中显式声明链接类型为静态，避免动态链接导致的符号冲突：

.product(name: "xcframework对应产品名", type: .static, targets: ["xcframework目标名"])

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