0

Update doc for Windows cross-compilation

- Explain the parameters of package_from_installed.py, removing obsolete
  values and providing more recent examples so it matches minimum
  recommended and required values of [1].
- Clarify that URL DEPOT_TOOLS_WIN_TOOLCHAIN_BASE_URL is the directory
  containing the zip file, not the file itself. See [2].

[1] https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/windows_build_instructions.md#visual-studio
[2] https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/1098256

Change-Id: Id6d3b515c15324393b5c21754e0ec2a49306329b
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3297922
Reviewed-by: Maksim Sisov <msisov@igalia.com>
Commit-Queue: Frédéric Wang <fwang@igalia.com>
Cr-Commit-Position: refs/heads/main@{#944915}
This commit is contained in:
Frédéric Wang
2021-11-24 11:29:25 +00:00
committed by Chromium LUCI CQ
parent fb8680ece2
commit b603481c27

@ -60,16 +60,22 @@ After installing [Microsoft's development tools](windows_build_instructions.md#v
you can package your Windows SDK installation into a zip file by running the following on a Windows machine:
cd path/to/depot_tools/win_toolchain
# customize the Windows SDK version numbers
python package_from_installed.py 2017 -w 10.0.17134.0
python package_from_installed.py <vs version> -w <win version>
where `<vs version>` and `<win version>` correspond respectively to the
versions of Visual Studio (e.g. 2019) and of the Windows SDK (e.g.
10.0.19041.0) installed on the Windows machine.
These commands create a zip file named `<hash value>.zip`. Then, to use the
generated file in a Linux or Mac host, the following environment variables
need to be set:
export DEPOT_TOOLS_WIN_TOOLCHAIN_BASE_URL=<path/to/sdk/zip/file>
export DEPOT_TOOLS_WIN_TOOLCHAIN_BASE_URL=<base url>
export GYP_MSVS_HASH_<toolchain hash>=<hash value>
`<base url>` is the path of the directory containing the zip file (note that
specifying scheme `file://` is not required).
`<toolchain hash>` is hardcoded in `src/build/vs_toolchain.py` and can be found by
setting `DEPOT_TOOLS_WIN_TOOLCHAIN_BASE_URL` and running `gclient sync`: