Hi there,
We’re encountering this error in all of our builds when using the latest Xcode and macOS:
The Metal Toolchain was not installed and could not compile the Metal source files. Download the Metal Toolchain from Xcode > Settings > Components and try again.
In short, all builds are failing. I’ve tried fixing this by installing Metal and applying other solutions, but none of them worked reliably.
Is there a way to ensure that the Metal Toolchain is installed on the CI machine?
Please file a Feedback report using Feedback Assistant.
@DTS Engineer Thanks! I'm hitting this as well and just filed. I reproduce this 100% of the time.
Feedback filed. Hopefully this will get addressed soon.
Hi rafaelks,
Would you be able to share the Feedback Assistant ID here? We can help route it to the appropriate team.
Also seeing this on Xcode Cloud builds when specifying the latest toolchain
We're seeing very inconsistent results with Xcode 26.0.1.
Have this in our pre-build script:
if xcodebuild -showComponent metalToolchain >/dev/null 2>&1; then
echo "Metal toolchain is installed"
Which reports that the toolchain is installed, but then ~50% of the time we get this error when building a metal file in our of our local Swift Packages:
error: error: cannot execute tool 'metal' due to missing Metal Toolchain; use: xcodebuild -downloadComponent MetalToolchain
Command CompileMetalFile failed with a nonzero exit code
It was working fine every time with Xcode 26.0 but that was just deprecated last night so we can no longer use it.
Xcode 26.0.1 (17A400)
macOS Tahoe 26 (25A354)
Just submitted a feedback: FB20510351
