Xcode 16构建失败：AVPlayerItem子类重写seek方法不匹配父类

问题原因 #

1. Xcode 16对方法签名的匹配校验更严格，子类重写的方法与父类AVPlayerItem的方法签名存在细微差异
2. Xcode编译器索引或缓存异常（错误会暂时消失的现象可佐证这点）

具体修复步骤 #

1. 严格对齐父类方法签名 #

确保重写的方法参数类型、返回值、修饰符完全和AVPlayerItem的对应方法一致：

• Objective-C 子类示例：

  // 带容差的seek方法
  - (void)seekToTime:(CMTime)time toleranceBefore:(CMTime)toleranceBefore toleranceAfter:(CMTime)toleranceAfter completionHandler:(void (^)(BOOL finished))completionHandler {
      // 自定义逻辑
      [super seekToTime:time toleranceBefore:toleranceBefore toleranceAfter:toleranceAfter completionHandler:completionHandler];
  }
  
  // 简易seek方法
  - (void)seekToTime:(CMTime)time completionHandler:(void (^)(BOOL finished))completionHandler {
      // 自定义逻辑
      [super seekToTime:time completionHandler:completionHandler];
  }
  

• Swift 子类示例：

  // 带容差的seek方法
  override func seek(to time: CMTime, toleranceBefore: CMTime, toleranceAfter: CMTime, completionHandler: @escaping (Bool) -> Void) {
      super.seek(to: time, toleranceBefore: toleranceBefore, toleranceAfter: toleranceAfter, completionHandler: completionHandler)
      // 自定义逻辑
  }
  
  // 简易seek方法
  override func seek(to time: CMTime, completionHandler: @escaping (Bool) -> Void) {
      super.seek(to: time, completionHandler: completionHandler)
      // 自定义逻辑
  }
  

2. 清理Xcode缓存与索引 #

针对编译器缓存异常的情况，执行以下操作：

• 按下 Cmd+Shift+K 清理项目构建缓存
• 按下 Cmd+Option+Shift+K 清理衍生数据
• 关闭Xcode，手动删除~/Library/Developer/Xcode/DerivedData目录下当前项目的文件夹
• 重启Xcode后重新构建项目

3. 校验子类继承关系 #

确认你的子类正确继承自AVPlayerItem，无拼写错误：

• Objective-C：@interface CustomPlayerItem : AVPlayerItem
• Swift：class CustomPlayerItem: AVPlayerItem

4. 检查项目SDK配置 #

确保项目的Base SDK设置为Xcode 16兼容的最新系统SDK（如iOS 18、tvOS 18等），避免SDK版本不匹配导致方法签名识别失败。

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