Metal Migration Diagnostics

Systematic diagnosis for common Metal porting issues.

When to Use This Diagnostic Skill

Use this skill when:

• Screen is black after porting to Metal
• Shaders fail to compile in Metal
• Colors or coordinates are wrong
• Performance is worse than the original
• Rendering artifacts appear
• App crashes during GPU work

Mandatory First Step: Enable Metal Validation

Time cost: 30 seconds setup vs hours of blind debugging

Before ANY debugging, enable Metal validation: