build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
cclauss wants to merge 9 commits into from
Closed

build: Add macOS_Catalina.md document #1940

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
e6aca7d
src,win: allow 403 errors for arm64 node.lib
richardlau Oct 23, 2019
a7661bb
build: Add macOS_Catalina.md document
cclauss Oct 25, 2019
f25a41f
fixup: typos
cclauss Oct 25, 2019
f21b984
Add Time To Live statement to the document
cclauss Oct 30, 2019
e6d1932
fixup: revert all changes to install.js
cclauss Oct 30, 2019
6ee07ff
Add link from README.md to notes-on-macOS-Catalina
cclauss Oct 30, 2019
98b631f
fixup: macOS_Catalina.md
cclauss Oct 30, 2019
30ce8eb
fixup: Update macOS_Catalina.md
cclauss Oct 30, 2019
5402880
fixup: add the missing dash in "--install"
cclauss Nov 1, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
* `Python v2.7, v3.5, v3.6, or v3.7`
* [Xcode](https://developer.apple.com/xcode/download/)
* You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
* If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down
69 changes: 69 additions & 0 deletions macOS_Catalina.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
* If nothing is listed, then [skip to the next section](#Two-roads).
* If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
* If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
* If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
* If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
* If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(

@GregBrimbleGregBrimbleOct 26, 2019

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)

@cclausscclaussOct 27, 2019

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?

1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.

@peterquentinpeterquentinOct 30, 2019

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!

2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
build: Add macOS_Catalina.md document#1940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

cclauss
wants to merge
9
commits into

from

 Closed


build: Add macOS_Catalina.md document
#1940
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


9 commits


Select commit
Hold shift + click to select a range
e6aca7d

src,win: allow 403 errors for arm64 node.lib


richardlau Oct 23, 2019
a7661bb

build: Add macOS_Catalina.md document


cclauss Oct 25, 2019
f25a41f

fixup: typos


cclauss Oct 25, 2019
f21b984

Add Time To Live statement to the document


cclauss Oct 30, 2019
e6d1932

fixup: revert all changes to install.js


cclauss Oct 30, 2019
6ee07ff

Add link from README.md to notes-on-macOS-Catalina


cclauss Oct 30, 2019
98b631f

fixup: macOS_Catalina.md


cclauss Oct 30, 2019
30ce8eb

fixup: Update macOS_Catalina.md


cclauss Oct 30, 2019
5402880

fixup: add the missing dash in "--install"


cclauss Nov 1, 2019

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1 change: 1 addition & 0 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -37,6 +37,7 @@ Depending on your operating system, you will need to install:
 * `Python v2.7, v3.5, v3.6, or v3.7`
 * [Xcode](https://developer.apple.com/xcode/download/)
 * You also need to install the `XCode Command Line Tools` by running `xcode-select --install`. Alternatively, if you already have the full Xcode installed, you can find them under the menu `Xcode -> Open Developer Tool -> More Developer Tools...`. This step will install `clang`, `clang++`, and `make`.
 * If your Mac has been _upgraded_ to macOS Catalina (10.15), please read [macOS_Catalina.md](macOS_Catalina.md).

### On Windows

Expand Down

69 changes: 69 additions & 0 deletions
macOS_Catalina.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
# Installation notes for macOS Catalina (v10.15)

_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 updated to deal with challenges involved in upgrades to the next version of macOS._

Lessons learned from:
* https://github.com/nodejs/node-gyp/issues/1779
* https://github.com/nodejs/node-gyp/issues/1861
* https://github.com/nodejs/node-gyp/issues/1927 and elsewhere

Installing `node-gyp` on macOS can be found at https://github.com/nodejs/node-gyp#on-macos

However, upgrading to macOS Catalina changes some settings that may cause normal `node-gyp` installations to fail.

### Is my Mac running macOS Catalina?
Let's make first make sure that your Mac is currently 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 really for you.

### The acid test
Next, lets see if `Xcode Command Line Tools` are installed:
1. `/usr/sbin/pkgutil --packages | grep CL`
 * If nothing is listed, then [skip to the next section](#Two-roads).
 * If `com.apple.pkg.CLTools_Executables` is listed then try:
2. `/usr/sbin/pkgutil --pkg-info com.apple.pkg.CLTools_Executables`
 * If `version: 11.0.0` or later is listed then _you are done_! Your Mac should be ready to install `node-gyp`. Doing `clang -v` should show `Apple clang version 11.0.0` or later.

As you go through the remainder of this document, at anytime you can try these `acid test` commands. If they pass then your Mac should be ready to install `node-gyp`.

### Two roads
There are two main ways to install `node-gyp` on macOS:
1. With the full Xcode (~7.6 GB download) from the `App Store` app.
2. With the _much_ smaller Xcode Command Line Tools via `xcode-select --install`

### Installing `node-gyp` using the full Xcode
1. `xcodebuild -version` should show `Xcode 11.1` or later.
 * If not, then install/upgrade Xcode from the App Store app.
2. Open the Xcode app and allow it to do an essential install of the most recent compiler tools.
3. Once all installations are _complete_, quit out of Xcode.
4. `sudo xcodebuild -license accept` # If you agree with the licensing terms.
5. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Upgrade" to install them.
6. `xcode-select -version` # Should return `xcode-select version 2370` or later.
7. `xcode-select -print-path` # Should return `/Applications/Xcode.app/Contents/Developer`
8. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
9. If the _acid test_ does _not_ pass then...
10. `sudo xcode-select --reset` # Enter root password. No output is normal.
11. Repeat step 7 above. Is the path different this time? Repeat the _acid test_.

### Installing `node-gyp` using the Xcode Command Line Tools
1. If the _acid test_ has not succeeded, then try `xcode-select --install`
2. Wait until the install process is _complete_.
3. `softwareupdate -l` # No listing is a good sign.
 * If Xcode or Tools upgrades are listed, use "Software Update" to install them.
4. `xcode-select -version` # Should return `xcode-select version 2370` or later.
5. `xcode-select -print-path` # Should return `/Library/Developer/CommandLineTools`
6. Try the [_acid test_ steps above](#The-acid-test) to see if your Mac is ready.
7. If the _acid test_ does _not_ pass then...
8. `sudo xcode-select --reset` # Enter root password. No output is normal.
9. Repeat step 5 above. Is the path different this time? Repeat the _acid test_.

### I did all that and the acid test still does not pass :-(
@GregBrimbleGregBrimbleOct 26, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This worked for me! Thank you :)
@cclausscclaussOct 27, 2019

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I please get your review on this PR?
1. `sudo rm -rf $(xcode-select -print-path)` # Enter root password. No output is normal.
@peterquentinpeterquentinOct 30, 2019

Copy link


Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This actually worked for me, thnx!
2. `xcode-select --install`
3. If the [_acid test_](#The-acid-test) still does _not_ pass then...
4. Add a comment to https://github.com/nodejs/node-gyp/issues/1927 so we can improve.