From dbe3cc7ca2693b59aa31e61200f8667495339d70 Mon Sep 17 00:00:00 2001 From: Joey Carpinelli Date: Tue, 17 Mar 2026 05:41:59 -0400 Subject: [PATCH] Add `xcodebuild -runFirstLaunch` fallback for Metal toolchain installation documentation (#51631) When setting up on macOS 26, `xcodebuild -downloadComponent MetalToolchain` can fail if Xcode hasn't been initialized yet. Running `xcodebuild -runFirstLaunch` first resolves this. Release Notes: - N/A --- docs/src/development/macos.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/src/development/macos.md b/docs/src/development/macos.md index 82d7264e2bb123b52ece8abcc44c3563d49de453..6315ddcab8a554cf0405f8095c5aff98b09d6251 100644 --- a/docs/src/development/macos.md +++ b/docs/src/development/macos.md @@ -118,7 +118,8 @@ xcrun: error: unable to find utility "metal", not a developer tool or in PATH Try `sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer` -If you're on macOS 26, try `xcodebuild -downloadComponent MetalToolchain` +If you're on macOS 26, try `xcodebuild -downloadComponent MetalToolchain`. +If that command fails, run `xcodebuild -runFirstLaunch` and try downloading the toolchain again. ### Cargo errors claiming that a dependency is using unstable features