Basic steps to build Cypress binary locally

[samtsai]

I'm trying to troubleshoot and fix a potential bug but I have difficulty building the Cypress binary.

My basic steps I follow are:

• checkout develop
• make code changes
• run yarn
• run yarn start

yarn installation/build step often hits: #28049

yarn start I sometimes get:

yarn start
yarn run v1.22.21
$ yarn ensure-deps
$ ./scripts/ensure-dependencies.sh
success Folder in sync.
$ cypress open --dev --global
[0109/092039.662023:FATAL:v8_initializer.cc(538)] Error loading V8 startup snapshot file

Then I run:

yarn build-v8-snapshot-dev

Are these the main steps I need to run?

npx envinfo

  System:
    OS: macOS 14.2.1
    CPU: (10) arm64 Apple M2 Pro
    Memory: 643.00 MB / 16.00 GB
    Shell: 5.9 - /bin/zsh
  Binaries:
    Node: 18.15.0 - ~/Library/Caches/fnm_multishells/39448_1704809902474/bin/node
    Yarn: 1.22.21 - /opt/homebrew/bin/yarn
    npm: 8.12.1 - ~/Code/cypress/node_modules/.bin/npm
    pnpm: 8.12.0 - ~/Library/pnpm/pnpm
    Watchman: 2023.12.04.00 - /opt/homebrew/bin/watchman
  Managers:
    Cargo: 1.70.0 - ~/.cargo/bin/cargo
    Homebrew: 4.2.3 - /opt/homebrew/bin/brew
    pip3: 23.3.1 - /opt/homebrew/bin/pip3
    RubyGems: 3.0.3.1 - /usr/bin/gem
  Utilities:
    Make: 3.81 - /usr/bin/make
    GCC: 15.0.0 - /usr/bin/gcc
    Git: 2.43.0 - /opt/homebrew/bin/git
    Clang: 15.0.0 - /usr/bin/clang
    Curl: 8.4.0 - /usr/bin/curl
  Servers:
    Apache: 2.4.56 - /usr/sbin/apachectl
  Virtualization:
    Docker: 24.0.6 - /usr/local/bin/docker
  IDEs:
    Android Studio: 2022.2 AI-222.4459.24.2221.10121639
    Vim: 9.0 - /usr/bin/vim
    Xcode: 15.1/15C65 - /usr/bin/xcodebuild
  Languages:
    Bash: 3.2.57 - /bin/bash
    Java: 1.8.0_372 - /usr/bin/javac
    Perl: 5.30.3 - /usr/bin/perl
    Python3: 3.11.7 - /opt/homebrew/bin/python3
    Ruby: 2.6.10 - /usr/bin/ruby
    Rust: 1.70.0 - /Users/satsai/.cargo/bin/rustc
  Databases:
    SQLite: 3.43.2 - /usr/bin/sqlite3
  Browsers:
    Chrome: 120.0.6099.199
    Edge: 120.0.2210.121
    Safari: 17.2.1
  Monorepos:
    Yarn Workspaces: 1.22.21
    Lerna: 6.6.2

[samtsai]

Actually this workflow has been working pretty well, just hit the types issue from time to time.

Maybe I can review and add to the Docs to make a little more clear if not already.