CoreBluetooth中CBService.peripheral未文档化API变更问题咨询

问题背景 #

CoreBluetooth框架中CBService.peripheral的Swift接口映射在Xcode 12.3和Xcode 13.0版本间存在未公开的差异：

• Xcode 12.3版本中，对应Objective-C头文件未添加nullable标记，Swift侧映射为非可选类型：

  unowned(unsafe) open var peripheral: CBPeripheral { get }
  

• Xcode 13.0版本中，Objective-C头文件补充了空性标注，Swift侧映射为可选类型：

  weak var peripheral: CBPeripheral? { get }
  

该变更未在官方文档中更新，导致同一份Swift代码无法同时适配两个Xcode版本。

兼容解决方案 #

方案1：全局无侵入扩展适配 #

利用Swift编译条件判断编译器版本（Xcode 13对应Swift 5.5及以上版本），为CBService扩展统一的兼容属性，业务侧无需修改原有逻辑的调用习惯：

extension CBService {
    /// 兼容多Xcode版本的peripheral属性
    var compatiblePeripheral: CBPeripheral? {
        #if compiler(>=5.5)
        return peripheral
        #else
        return peripheral
        #endif
    }
}

所有业务场景统一调用compatiblePeripheral即可，两种Xcode环境下均可正常编译。

方案2：单调用点轻量适配 #

无需全局修改代码，在单独的调用位置通过显式类型转换即可兼容两个版本：

// 全版本通用写法
if let peripheral = service.peripheral as CBPeripheral? {
    // 执行业务逻辑
}

该写法的兼容原理：Xcode 12.3下的非可选值做可选类型转换会永久成功，自动包装为可选值；Xcode 13下的可选值做转换会直接返回本身，逻辑完全符合预期。

注意事项 #

Xcode 12.3版本中该属性为unowned(unsafe)修饰，访问时请确保关联的CBPeripheral对象未被释放，避免出现野指针崩溃。该运行时风险与编译层面的可选性无关，两个版本都需要做好peripheral的生命周期管理。

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