From f730e6fc4fc92606fe57b051280c621a6406ecd1 Mon Sep 17 00:00:00 2001 From: sabine_schmitt Date: Fri, 21 Aug 2026 08:47:07 +0200 Subject: [PATCH 1/3] chore(mac): update setup document - add comment on use of bash 4 and XCode 26.2 /XCode 26.3 --- docs/build/macos.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/build/macos.md b/docs/build/macos.md index 99d6d9997e0..76a6577ea1f 100644 --- a/docs/build/macos.md +++ b/docs/build/macos.md @@ -28,6 +28,7 @@ The following projects **cannot** be built on macOS: ## System Requirements * Minimum macOS version: macOS Catalina 10.15 or Big Sur 11.0 +(make sure bash 4.0 is installed and used as modern macOS defaults to Zsh as its primary system shell) **Note:** to make a fully M1-compatible release build of Keyman for macOS (for the setup Applescript), Big Sur 11.0 is required, as osacompile on earlier @@ -41,6 +42,8 @@ Many dependencies are only required for specific projects. * XCode (iOS, macOS) 12.4 or later is needed only for Keyman for macOS and Keyman for iOS. + (Be sure to install XCode 26.2 or 26.3 maximum as they use clang 17.0 . Higher versions of XCode use Clang 21.0 which may not work) + * Install from App Store * Accept the Xcode license: `sudo xcodebuild -license accept` From 11a920711328163186c1d5959decdcfb9ee2414a Mon Sep 17 00:00:00 2001 From: SabineSIL <86713187+SabineSIL@users.noreply.github.com> Date: Fri, 21 Aug 2026 14:03:11 +0200 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Marc Durdin --- docs/build/macos.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/build/macos.md b/docs/build/macos.md index 66226452295..c37b1d6bd96 100644 --- a/docs/build/macos.md +++ b/docs/build/macos.md @@ -40,9 +40,8 @@ Rosetta 2 installed. Many dependencies are only required for specific projects. -* XCode (iOS, macOS) 12.4 or later is needed only for Keyman for macOS and Keyman - for iOS. - (Be sure to install XCode 26.2 or 26.3 maximum as they use clang 17.0 . Higher versions of XCode use Clang 21.0 which may not work) +* XCode (iOS, macOS) 26.2 or 26.3 (not higher at this time, see #16416) + is needed only for Keyman for macOS and Keyman for iOS (). * Install from App Store * Accept the Xcode license: `sudo xcodebuild -license accept` @@ -108,7 +107,7 @@ PATH="$HOMEBREW_PREFIX/opt/coreutils/libexec/gnubin:$PATH" ## KeymanWeb Dependencies -* node.js, emscripten 3.1.46 or later +* node.js 20.0, emscripten 3.1.64 ### node.js @@ -144,7 +143,8 @@ If you are updating an existing install of Emscripten: cd emsdk git pull emsdk install 3.1.58 -emsdk activate 3.1.58 +./emsdk install 3.1.64 +./emsdk activate 3.1.64 cd upstream/emscripten npm install ``` @@ -207,7 +207,9 @@ components such as emulator images and SDK updates. ```shell brew install node emscripten -``` +* node.js 20.0, emscripten 3.1.64 + +See section KeymanWeb Dependencies for installation ## Optional Tools From 19680dca467f5aa205106e0d75e6dcf0aadfea39 Mon Sep 17 00:00:00 2001 From: SabineSIL <86713187+SabineSIL@users.noreply.github.com> Date: Fri, 21 Aug 2026 23:04:32 +0200 Subject: [PATCH 3/3] chore(mac): add an info on macOS version Clarify system requirements for macOS, specifying Xcode versions and bash installation. --- docs/build/macos.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/build/macos.md b/docs/build/macos.md index c37b1d6bd96..92203ddb6db 100644 --- a/docs/build/macos.md +++ b/docs/build/macos.md @@ -28,7 +28,8 @@ The following projects **cannot** be built on macOS: ## System Requirements * Minimum macOS version: macOS Catalina 10.15 or Big Sur 11.0 -(make sure bash 4.0 is installed and used as modern macOS defaults to Zsh as its primary system shell) +(For using Xcode 26.2 or 26.3 macOS Sequoia 15.6 or later is required. +Make sure bash 4.0 is installed and used as modern macOS defaults to Zsh as its primary system shell) **Note:** to make a fully M1-compatible release build of Keyman for macOS (for the setup Applescript), Big Sur 11.0 is required, as osacompile on earlier