如何解决Unity iOS归档报OpenGLES弃用需迁移至Metal的错误

彻底修复方案（推荐，符合苹果长期兼容要求） #

• 切换图形渲染API为Metal：打开Unity 2019.4.21f1的Player Settings，切换到iOS平台配置页，在Graphics API列表中删除OpenGLES2(Deprecated)、OpenGLES3(Deprecated)两个选项，仅保留Metal即可。Unity 2019.4 LTS版本对Metal的适配已经非常稳定，切换后不仅能直接消除归档报错，还能获得比OpenGLES更高的渲染效率、更低的设备功耗，也能规避后续iOS版本移除OpenGLES支持导致的应用无法运行问题。
• 切换后做兼容校验：逐一排查项目内的自定义Shader、原生渲染插件、第三方后处理资源，把硬编码依赖OpenGLES的逻辑做Metal适配：比如将纯GLSL编写的Shader改为Unity支持自动跨编译的HLSL/Surf写法，替换仅支持OpenGLES的原生插件为Metal兼容版本，避免上线后出现渲染异常、黑屏等问题。

临时绕过方案（仅适用于紧急出包场景，不推荐长期使用） #

这类方案不会从根源解决OpenGLES废弃的问题，只是将编译阶段的错误降级为告警，存在后续审核被拒、高版本iOS系统运行异常的风险。

• 手动修改Xcode编译配置：Unity导出Xcode工程后，打开工程找到对应Target的Build Settings配置页：
  • 找到Deprecated Declarations选项，将值从Yes改为No
  • 在Other C Flags、Other Linker Flags配置项中新增-Wno-error=deprecated-declarations参数，强制将废弃API相关的错误降级为普通告警，修改完成后即可正常执行Archive操作。
• 通过Unity后处理脚本自动修改配置：如果需要频繁导出iOS工程，可以在项目的Editor文件夹下新增C#脚本，在导出工程时自动完成上述配置修改，无需每次手动调整，核心实现代码如下：

using UnityEditor;
using UnityEditor.Callbacks;
using UnityEditor.iOS.Xcode;
using System.IO;

public class IosBuildOpt
{
    [PostProcessBuild(999)]
    public static void OnBuildEnd(BuildTarget buildTarget, string exportPath)
    {
        if (buildTarget != BuildTarget.iOS) return;
        string projPath = PBXProject.GetPBXProjectPath(exportPath);
        PBXProject pbxProj = new PBXProject();
        pbxProj.ReadFromFile(projPath);
        
        string mainTarget = pbxProj.GetUnityMainTargetGuid();
        string frameworkTarget = pbxProj.GetUnityFrameworkTargetGuid();
        
        // 关闭废弃函数告警报错
        pbxProj.SetBuildProperty(mainTarget, "GCC_WARN_ABOUT_DEPRECATED_FUNCTIONS", "NO");
        pbxProj.SetBuildProperty(frameworkTarget, "GCC_WARN_ABOUT_DEPRECATED_FUNCTIONS", "NO");
        // 增加编译标记，避免废弃声明被判定为错误
        pbxProj.AddBuildProperty(mainTarget, "OTHER_CFLAGS", "-Wno-error=deprecated-declarations");
        pbxProj.AddBuildProperty(frameworkTarget, "OTHER_CFLAGS", "-Wno-error=deprecated-declarations");
        
        pbxProj.WriteToFile(projPath);
    }
}

• 注意：使用临时方案出包前，必须在目标iOS版本的真机上完成全流程测试，确认OpenGLES相关渲染逻辑运行正常，避免上线后出现兼容性问题。

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