Xcode 26 Metal compiler error MetalToolChain

Question

Just downloaded Xcode 26 and I see build fails despite Metal toolchain 26.0 downloaded. What am I missing?

cannot execute tool 'metal' due to missing Metal Toolchain; use: xcodebuild -downloadComponent MetalToolchain

Answer 1

It's a known issue of Xcode 26, which is listed on the release note:
Metal/Known Issues workaround is download the toolchain, change the version and then register manually:

xcodebuild -downloadComponent metalToolchain -exportPath /tmp/MyMetalExport/
sed -i '' -e 's/17A5241c/17A5241e/g' /tmp/MyMetalExport/MetalToolchain-17A5241c.exportedBundle/ExportMetadata.plist
xcodebuild -importComponent metalToolchain -importPath /tmp/MyMetalExport/MetalToolchain-17A5241c.exportedBundle