From ff81bd72a6c3da35df49e4b6f4a9883790aeb6f9 Mon Sep 17 00:00:00 2001 From: George Adams Date: Wed, 27 May 2026 19:59:30 +0000 Subject: [PATCH] 8385525: Suggest Metal toolchain download in configure error on Xcode 26+ Reviewed-by: erikj, serb, shade --- doc/building.html | 2 +- doc/building.md | 2 +- make/autoconf/toolchain.m4 | 2 ++ 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/building.html b/doc/building.html index 534888ef667..86ee3390ead 100644 --- a/doc/building.html +++ b/doc/building.html @@ -545,7 +545,7 @@ earlier versions may also work.

no longer comes bundled with Xcode, so it needs to be installed separately. This can either be done via the Xcode's Settings/Components UI, or in the command line calling -xcodebuild -downloadComponent metalToolchain.

+xcodebuild -downloadComponent MetalToolchain.

The standard macOS environment contains the basic tooling needed to build, but for external libraries a package manager is recommended. The JDK uses homebrew in the examples, but diff --git a/doc/building.md b/doc/building.md index d653d36eb55..93ab386ee8e 100644 --- a/doc/building.md +++ b/doc/building.md @@ -355,7 +355,7 @@ earlier versions may also work. Starting with Xcode 26, introduced in macOS 26, the Metal toolchain no longer comes bundled with Xcode, so it needs to be installed separately. This can either be done via the Xcode's Settings/Components UI, or in the command line -calling `xcodebuild -downloadComponent metalToolchain`. +calling `xcodebuild -downloadComponent MetalToolchain`. The standard macOS environment contains the basic tooling needed to build, but for external libraries a package manager is recommended. The JDK uses diff --git a/make/autoconf/toolchain.m4 b/make/autoconf/toolchain.m4 index c882deb10a7..8a08e86d53f 100644 --- a/make/autoconf/toolchain.m4 +++ b/make/autoconf/toolchain.m4 @@ -692,6 +692,8 @@ AC_DEFUN_ONCE([TOOLCHAIN_DETECT_TOOLCHAIN_EXTRA], AC_MSG_NOTICE([A full XCode is required to build the JDK (not only command line tools)]) AC_MSG_NOTICE([If you have XCode installed, you might need to reset the Xcode active developer directory]) AC_MSG_NOTICE([using 'sudo xcode-select -r']) + AC_MSG_NOTICE([Starting with Xcode 26, the Metal toolchain is no longer bundled with Xcode.]) + AC_MSG_NOTICE([Try installing it with 'xcodebuild -downloadComponent MetalToolchain']) AC_MSG_ERROR([XCode tool 'metal' neither found in path nor with xcrun]) else AC_MSG_RESULT([yes, will be using '$METAL'])