Xcode_26 not compiling Metal project

Question

Xcode_26 not compiling Metal project

Hello

Xcode 26.0.1 (17A400) Missing some Metal components

When building a program using Metal, it induces an unexpected error :

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

Command CompileMetalFile failed with a nonzero exit code”

Which terminates the build

The fix given “xcodebuild -downloadComponent MetalToolchain” using sudo does not work

Did someone find a work around or could resolve the issue?

Many thanks

Jean

MacBook Air 15″, macOS 26.0

Posted on Oct 2, 2025 3:02 AM

Reply

Answer 1

Top-ranking reply

mattisssa

Level 1

14 points

Nov 14, 2025 9:02 AM in response to jean-mariefromrixensart

1) Triger this in terminal:

xcodebuild -downloadComponent MetalToolchain

2) Open downloaded asset, it should be located somewhere here

/System/Library/AssetsV2/com_apple_MobileAsset_MetalToolchain/68d8db6212b48d387d071ff7b905df796658e713.asset/AssetData/Restore/022-20369-066.dmg

3) Manually move the Metal.xctoolchain to the xcode' toolchain folder

/Library/Developer/Toolchains/Metal.xctoolchain

4) Clean, Rebuild

Reply

Answer 2

Nov 1, 2025 7:58 PM in response to jean-mariefromrixensart

Hello, good news~I found the way to fix it, just type "xcodebuild -downloadComponent MetalToolchain" in mac terminal, it'll start downloading, works for me~

u can try it

Reply

Answer 3

Rudegar

Level 10

180,072 points

Oct 2, 2025 4:06 AM in response to jean-mariefromrixensart

don't think there are that many developers in these user forums if it was me then I would try

the developer forums Apple Developer Forums

Reply

Answer 4

Nov 14, 2025 3:36 PM in response to mattisssa

@ Mattissa

Hi, I use this already but

It will not work anymore once you restart the computer, I have to redo the process each time.
It does not work correctly on my system. The items drawn are not always those expected

I did issue a Feedback Assistant request and I am waiting for a fix of the issue.

Thank you

Jean

Reply

Answer 5

Oct 2, 2025 4:10 AM in response to Rudegar

Ok Thank you

Reply

Answer 6

Oct 30, 2025 4:23 AM in response to jean-mariefromrixensart

Hello~ having the same issue here, have you find out a way to fix it?

Reply

Answer 7

Nov 1, 2025 10:42 AM in response to Morgan913

Hi, It is not working. I did file a Feedback Assistant request for this

Reply

Answer 8

Nov 3, 2025 1:32 AM in response to Morgan913

Hello, I did try already this before but it does not help in my case. It did work once but after nothing. I retried just now with this fix and no luck

Reply

Answer 9

Dec 1, 2025 8:20 AM in response to jean-mariefromrixensart

Yes, this was the only workaround I found that allows it to compile, at least to some extent

Reply