electron/docs/development/upgrading-crashpad.md

Upgrading Crashpad

1. Get the version of crashpad that we're going to use.

• libcc/src/third_party/crashpad/README.chromium will have a line Revision: with a checksum
  • We need to check out the corresponding branch.
• Clone Google's crashpad (https://chromium.googlesource.com/crashpad/crashpad)
  • git clone https://chromium.googlesource.com/crashpad/crashpad
• Check out the branch with the revision checksum:
  • git checkout <revision checksum>
• Add electron's crashpad fork as a remote
  • git remote add electron https://github.com/electron/crashpad
• Check out a new branch for the update
  • git checkout -b electron-crashpad-vA.B.C.D
  • A.B.C.D is the Chromium version found in libcc/VERSION and will be something like 62.0.3202.94

2. Make a checklist of the Electron patches that need to be applied with git log --oneline

   • Or view https://github.com/electron/crashpad/commits/previous-branch-name

3. For each patch:

• In electron-crashpad-vA.B.C.D, cherry-pick the patch's checksum
  • git cherry-pick <checksum>
• Resolve any conflicts
• Make sure it builds then add, commit, and push work to electron's crashpad fork
  • git push electron electron-crashpad-vA.B.C.D

4. Update Electron to build the new crashpad:

• cd vendor/crashpad
• git fetch
• git checkout electron-crashpad-v62.0.3202.94

5. Regenerate Ninja files against both targets

• From Electron root's root, run script/update.py
• script/build.py -c D --target=crashpad_client
• script/build.py -c D --target=crashpad_handler
• Both should build with no errors

6. Push changes to submodule reference

• (From electron root) git add vendor/crashpad
• git push origin upgrade-to-chromium-62