自研Swift SDK中播放内部MP3文件问题求助（Swift5、iOS11）

核心原因分析 #

• Bundle.main指向宿主APP的资源包，无法获取SDK内部的私有资源
• Bundle.module是Swift Package Manager（SPM）自动生成的属性，仅适用于SPM管理的包；若你的SDK通过CocoaPods或手动打包，该属性不存在，且iOS11环境下也存在兼容性问题

解决方案步骤 #

1. 确保资源文件正确打包 #

将sound_tap.mp3添加到SDK的target中，在Build Phases > Copy Bundle Resources列表里确认该文件已被包含，确保打包时资源会被嵌入SDK的framework包内。

2. 手动获取SDK的Bundle实例 #

通过SDK内部的类定位自身Bundle，替代Bundle.module或Bundle.main：

import AVFoundation

class SoundPlayer {
    // 获取SDK自身的Bundle
    private static var sdkBundle: Bundle {
        let baseBundle = Bundle(for: self)
        
        // 特殊场景：若SDK资源放在独立子Bundle（如"YourSDKResources.bundle"），需额外获取
        // if let resourceBundleURL = baseBundle.url(forResource: "YourSDKResources", withExtension: "bundle") {
        //     return Bundle(url: resourceBundleURL) ?? baseBundle
        // }
        
        return baseBundle
    }
    
    // 播放音频的方法
    static func playTapSound() {
        guard let soundURL = sdkBundle.url(forResource: "sound_tap", withExtension: "mp3") else {
            print("SDK内部未找到sound_tap.mp3资源")
            return
        }
        
        do {
            // 初始化AVAudioPlayer并播放
            // 注意：若需持续播放，建议将audioPlayer设为类属性持有，避免局部变量被释放导致播放中断
            let audioPlayer = try AVAudioPlayer(contentsOf: soundURL)
            audioPlayer.play()
        } catch {
            print("音频播放失败: \(error.localizedDescription)")
        }
    }
}

3. 关键注意事项 #

• 持有播放器实例：如果直接在方法内创建局部AVAudioPlayer，方法执行完毕后实例会被释放，音频可能中途停止，建议将其设为类属性
• 验证资源路径：通过print(sdkBundle.bundlePath)打印SDK的Bundle路径，手动检查该路径下是否存在sound_tap.mp3，确认资源打包是否正确
• iOS11兼容性：AVAudioPlayer在iOS11上完全兼容，前台播放场景无需额外权限配置

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