4cb9d7422d
The upcoming CL, https://chromium-review.googlesource.com/c/563036, updates "bootstrap/win"'s mechanism. However, if that patch needs to be reverted, its "python.bat" stub may still exist in the reverted repository, and will continue to point to the reverted toolchain. We don't have a good way to detect whether we should revert "python.bat". Instead, we will look a file generated by the CL, "//python_bin_reldir.txt". If we find it, we will assume that the updated "python.bat" is in use, and reinstall. Note that if that CL lands and does not require a revert, this logic will be deleted. It's just there as a safety mechanism to allow a safe revert. BUG=chromium:740171 TEST=local Change-Id: Ifc638cf0512d2a889c37fbf6b8e3f7a3269331b1 Reviewed-on: https://chromium-review.googlesource.com/566073 Commit-Queue: Daniel Jacques <dnj@chromium.org> Reviewed-by: Robbie Iannucci <iannucci@chromium.org> |
8 years ago | |
|---|---|---|
| .. | ||
| README.md | 8 years ago | |
| get_file.js | 10 years ago | |
| git-bash.template.sh | 10 years ago | |
| git.template.bat | 9 years ago | |
| git_bootstrap.py | 8 years ago | |
| git_version.txt | 9 years ago | |
| git_version_bleeding_edge.txt | 8 years ago | |
| profile.d.python.sh | 10 years ago | |
| pylint.new.bat | 10 years ago | |
| python276.new.bat | 10 years ago | |
| unzip.js | 10 years ago | |
| win_tools.bat | 8 years ago | |
README.md
Windows binary tool bootstrap
This directory has the 'magic' for the depot_tools windows binary update
mechanisms.
Software bootstrapped
- Python (https://www.python.org/)
- Git for Windows (https://git-for-windows.github.io/)
Mechanism
Any time a user runs gclient on windows, it will invoke the depot_tools
autoupdate script depot_tools.bat. This, in
turn, will run win_tools.bat, which does the bulk of the
work.
win_tools.bat will successively look to see if the local version of the binary
package is present, and if so, if it's the expected version. If either of those
cases is not true, it will download and unpack the respective binary.
Downloading is done with get_file.js, which is a windows script
host javascript utility to vaguely impersonate wget.
Through a comedy of history, each binary is stored and retrieved differently.
Git
Git installs are mirrored versions of the official Git-for-Windows Portable releases.
- Original:
https://github.com/git-for-windows/git/releases - Mirror:
gs://chrome-infra/PortableGit*.7z.exe
Updating git version
- Download the new
PortableGit-X.Y.Z-{32,64}.7z.exefrom the git-for-windows release page. - From either console.developers.google.com or the CLI, do:
1. Upload those to the gs://chrome-infra Google Storage bucket.
1. Set the
allUsers Readerpermission (click the "Public link" checkbox next to the binaries). - Edit the
git_version.txtorgit_version_bleeding_edge.txtfile to be the new version. 1. You can use the bleeding edge version to get early feedback/stage a rollout/etc. Users can select this version by 'touch'ing the.git_bleeding_edgefile in the root depot_tools directory. - Commit the CL.
Note that in order for the update to take effect, gclient currently needs to
run twice. The first time it will update the depot_tools repo, and the second
time it will see the new git version and update to it. This is a bug that should
be fixed, in case you're reading this and this paragraph infuriates you more
than the rest of this README.
Python
Python installs are sourced from gs://chrome-infra/python276_bin.zip .
The process to create them is sort-of-documented in the README of the python zip file.