MTLTextureDescriptor宽高超限报错，同模拟器下示例项目却正常？

以下是几个可能的原因及对应的排查/解决步骤：

• GPU Frame Capture 调试选项差异
  模拟器开启GPU Frame Capture时，会限制纹理尺寸以适配调试需求。检查你的项目Scheme设置：

  1. 打开Xcode，点击顶部菜单栏的Product -> Scheme -> Edit Scheme
  2. 切换到Run标签页，选择Options栏
  3. 将GPU Frame Capture设置为Disabled，重启模拟器后重新运行项目

• Metal API Validation 开启状态
  开启Metal API验证时，模拟器会强制执行旧版GPU的纹理规格限制。排查步骤：

  1. 在Scheme的Run标签页切换到Diagnostics栏
  2. 取消勾选Metal API Validation选项，重新运行项目

• iOS部署目标版本不一致
  低版本iOS系统对大尺寸纹理的支持有限，即使使用同一模拟器，部署目标版本差异也会导致模拟的系统限制不同：

  1. 在项目的Build Settings中找到iOS Deployment Target
  2. 将其调整为与示例项目相同的版本（建议iOS 14及以上，更好支持大纹理）

• 纹理加载逻辑的隐性差异
  看似相同的代码可能存在细节差异，比如纹理加载选项或Asset配置：

  • 检查纹理加载代码：如果使用MTKTextureLoader，确保MTKTextureLoaderOptionTextureUsage、MTKTextureLoaderOptionAllocateMipmaps等参数与示例项目完全一致
  • 检查Asset Catalog：打开纹理所在的Asset，取消勾选Compress Texture选项，避免压缩导致的尺寸限制

• 模拟器GPU特性集配置
  模拟器的GPU特性集模拟不同设备的硬件能力，可能被设置为低规格模式：

  1. 打开运行中的模拟器，点击顶部菜单栏Debug -> Graphics -> Metal Feature Set
  2. 选择最高级的特性集（如iOS GPU Family 7 Apple Silicon），重启模拟器后重试

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