docs: remove node-gyp contributor workarounds / restrictions #30671
+4
−18
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Additional details
This PR addresses documentation changes following the merge of PR #30633, which updated @electron/[email protected] to @electron/[email protected] in packages/server in the release/14.0.0 branch.
The update allows [email protected] to be used, with cascading restrictions relieved:
3.12
version of Ubuntu24.*
can be used.24.04
no downgrading to Python3.11
necessary.24.10
. (Downgrading Python on Ubuntu24.10
is not available)Building Cypress from source is then possible, without errors from
node-gyp
and without resorting to these workarounds.Corresponding workaround instructions and restrictions are removed from CONTRIBUTING > Requirements.
Steps to test
Follow the modified instructions in CONTRIBUTING > Requirements for Cypress 14 beta, including the use of Node.js
v20.18.0
.Confirm that the installation was successful and that the following log sequence shows no errors between the steps:
Remove any workarounds previously installed, which are no longer part of the updated CONTRIBUTING > Requirements instructions, as follows:
Ubuntu 24.04
If the system has been previously set up for Python
3.11
, then execute the following before runningyarn
:unset NODE_GYP_FORCE_PYTHON
Ubuntu 24.10
Python
3.11
is not available for Ubuntu24.10
, so no special preparatory steps are necessary.Windows 11
In Visual Studio Installer remove any Windows 10 SDK installed. Install Python
3.12
through Microsoft Store.Confirm that the error "could not find a version of Visual Studio 2017 or newer to use" no longer occurs.
How has the user experience changed?
This issue affects contributors only. Contributor instructions are changed for Ubuntu and Windows.
PR Tasks
cypress-documentation
?type definitions
?