Skip to content

Commit

Permalink
doc: introduce remote acid test
Browse files Browse the repository at this point in the history
  • Loading branch information
vladimyr authored and rvagg committed May 13, 2020
1 parent 548cf7d commit 1c7a985
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 18 deletions.
21 changes: 21 additions & 0 deletions acid-test.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
#!/bin/bash

pkgs=(
"com.apple.pkg.DeveloperToolsCLILeo" # standalone
"com.apple.pkg.DeveloperToolsCLI" # from XCode
"com.apple.pkg.CLTools_Executables" # Mavericks
)

for pkg in "${pkgs[@]}"; do
output=$(/usr/sbin/pkgutil --pkg-info "$pkg" 2>/dev/null)
if [ "$output" ]; then
version=$(echo "$output" | grep 'version' | cut -d' ' -f2)
break
fi
done

if [ "$version" ]; then
echo "Command Line Tools version: $version"
else
echo >&2 'Command Line Tools not found'
fi
21 changes: 3 additions & 18 deletions macOS_Catalina.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,28 +18,13 @@ If `ProductVersion` is less then `10.15` then this document is not for you. Norm
### The acid test
To see if `Xcode Command Line Tools` is installed in a way that will work with `node-gyp`, run:
```
/usr/sbin/pkgutil --pkgs |
grep -i com.apple.pkg.cltools |
head -n1 |
xargs -n1 /usr/sbin/pkgutil --pkg-info
curl -L https://git.io/node-gyp:acid-test | bash
```

Test output format is:
```
package-id: com.apple.pkg.CLTools_Executables
version: 11.4.1.0.1.1586360307
volume: /
location: /
install-time: 1587769775
groups: com.apple.FindSystemFiles.pkg-group
```
**`version: 11.0.0` (or later) should be listed.**

If test did not produce any output
or expected version isn't listed, there is a problem with your Xcode Command Line Tools installation. [Continue to Solutions](#Solutions).

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](#Solutions).

### 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.

Expand Down

0 comments on commit 1c7a985

Please sign in to comment.