Xcode设置macOS Deployment Target为10.13 屏保无法在10.13.6运行怎么办

问题1：自动检测代码中macOS 10.13不支持的API/特性的方法 #

• 开启Xcode内置可用性检查：在项目Build Settings中，将API Availability Checks - Warn about deprecated API设置为Yes，同时在Other Swift Flags中添加参数-Wpartial-availability，开启后Xcode会在编译阶段对调用了高于Deployment Target版本的API给出警告。
• 将部分可用性警告升级为错误：在Build Settings中将Partial Availability Swift Warnings设置为Yes，此时如果代码中调用了高版本API且未加if #available(macOS 版本号, *)的版本判断逻辑，Xcode会直接抛出编译错误，避免遗漏。
• 运行Xcode静态分析：点击菜单栏Product -> Analyze执行静态扫描，工具会自动识别包括隐式调用高版本系统方法在内的潜在可用性问题。
• 额外注意Swift标准库特性兼容性：Swift 5的部分特性依赖高版本系统，例如Combine框架、Swift Concurrency相关能力都是macOS 10.15及以上才支持，上述检查规则也会覆盖这类场景。

问题2：指定macOS Deployment Target后仍无法在对应版本运行是否常见 #

这种情况比较常见，Xcode默认不会在构建阶段直接抛出错误的原因如下：

• Deployment Target仅声明你期望支持的最低系统版本，默认仅对高版本API调用给出警告，不会强制阻断编译。如果忽略了相关警告，低版本系统运行时就会出现不兼容甚至崩溃。
• 两种常见的Xcode默认检查漏判场景：
  • 依赖的第三方库最低支持版本高于10.13：即便你自己的代码完全符合10.13的API要求，第三方库内部调用高版本API也会触发不兼容。
  • 构建产物架构不匹配：2010款Mac Pro为x86_64架构，如果你构建时仅生成了arm64架构的包，或者Release模式下Build Active Architecture Only设置为Yes，导致产物仅包含构建设备的架构，老设备就无法识别。你可以检查Build Settings中的Architectures是否设置为Standard Architectures (x86_64, arm64)，且Release模式下Build Active Architecture Only为No。

你遇到的系统提示是屏保引擎提前检测到兼容性问题触发的，优先排查架构配置，再按问题1的方法检查API调用即可定位问题。

内容的提问来源于stack exchange，提问作者Erik N.