Xcode13调用OSSignposter报Cannot find 'OSSignposter' in scope求助

原因说明 #

OSSignposter 是苹果在 WWDC2021 推出的接口，仅在 macOS 12.0+、iOS 15.0+ 及对应版本的 SDK 中提供，你遇到的作用域找不到错误是编译阶段的 SDK 匹配问题，可按照以下步骤排查修复：

修复步骤 #

• 第一步：升级 Xcode 到 13.1 及以上版本
  Xcode 13.0 内置的默认 SDK 最高仅支持 macOS 11.3，没有包含 macOS 12 对应的接口定义，只有 Xcode 13.1 及更高版本才内置 macOS 12 SDK，升级 Xcode 后可解决 SDK 缺失的问题。
• 第二步：调整项目部署目标配置
  打开项目的 Build Settings 面板，找到 macOS Deployment Target 选项，将版本设置为 12.0 或更高，低版本部署目标不会引入高版本系统的接口定义。
• 第三步：确认导入模块与 API 调用正确性
  确保代码头部导入os模块，初始化代码不需要额外参数，正确示例如下：

  import os
  
  let signpost = OSSignposter()
  

额外注意事项 #

如果开发的是多平台兼容项目，需要添加平台版本判断，避免低版本系统编译报错：

if #available(macOS 12.0, iOS 15.0, *) {
    let signpost = OSSignposter()
    // 后续 signpost 相关逻辑
} else {
    // 低版本系统兼容逻辑
}

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