This document specifically refers to upgrades from previous versions of macOS to Catalina (10.15). It should be removed from the source repository when Catalina ceases to be the latest macOS version or when future Catalina versions no longer raise these issues.
Both upgrading to macOS Catalina and running a Software Update in Catalina may cause normal node-gyp installations to fail. This might manifest as the following error during npm install:
gyp: No Xcode or CLT version detected!
The newest release of node-gyp should solve this problem. If you are using node-gyp directly then you should be able to install v7 and use it as-is.
If you need to use node-gyp from within npm (e.g. through npm install), you will have to install node-gyp (either globally with -g or to a predictable location) and tell npm where the new version is. Either use:
npm config set node_gyp <path to node-gyp>; ornpm with an environment variable prefix: npm_config_node_gyp=<path to node-gyp> npm installWhere “path to node-gyp” is to the node-gyp executable which may be a symlink in your global bin directory (e.g. /usr/local/bin/node-gyp), or a path to the node-gyp installation directory and the bin/node-gyp.js file within it (e.g. /usr/local/lib/node_modules/node-gyp/bin/node-gyp.js).
If you use npm config set to change your global node_gyp you are responsible for keeping it up to date and can’t rely on npm to give you a newer version when available. Use npm config delete node_gyp to unset this configuration option.
node-gypLet’s first make sure that your Mac is running Catalina:
% sw_vers
ProductName: Mac OS X
ProductVersion: 10.15
BuildVersion: 19A602
If ProductVersion is less then 10.15 then this document is not for you. Normal install docs for node-gyp on macOS can be found at https://github.com/nodejs/node-gyp#on-macos
To see if Xcode Command Line Tools is installed in a way that will work with node-gyp, run:
curl -sL https://github.com/nodejs/node-gyp/raw/main/macOS_Catalina_acid_test.sh | bash
If test succeeded, you are done! You should be ready to install node-gyp.
If test failed, there is a problem with your Xcode Command Line Tools installation. Continue to Solutions.
There are three ways to install the Xcode libraries node-gyp needs on macOS. People running Catalina have had success with some but not others in a way that has been unpredictable.
App Store app.xcode-select --installnode-gyp using the full Xcodexcodebuild -version should show Xcode 11.1 or later.
sudo xcodebuild -license accept # If you agree with the licensing terms.softwareupdate -l # No listing is a good sign.
xcode-select -version # Should return xcode-select version 2370 or later.xcode-select -print-path # Should return /Applications/Xcode.app/Contents/Developersudo xcode-select --reset # Enter root password. No output is normal.node-gyp using the Xcode Command Line Tools via xcode-select --installxcode-select --installxcode-select: error: command line tools are already installed, use "Software Update" to install updates, continue to remove and reinstallsoftwareupdate -l # No listing is a good sign.
xcode-select -version # Should return xcode-select version 2370 or later.xcode-select -print-path # Should return /Library/Developer/CommandLineToolssudo xcode-select --reset # Enter root password. No output is normal.node-gyp using the Xcode Command Line Tools via manual downloadsudo rm -rf $(xcode-select -print-path) # Enter root password. No output is normal.sudo rm -rf /Library/Developer/CommandLineTools # Enter root password.sudo xcode-select --resetxcode-select --installnpm explore npm -g -- npm install node-gyp@latestnpm explore npm -g -- npm explore npm-lifecycle -- npm install node-gyp@latestLessons learned from: