mirror of
https://chromium.googlesource.com/chromium/tools/depot_tools.git
synced 2026-01-11 10:41:31 +00:00
explain build tools and depot_tools installations
Bug: 414330998 Change-Id: If65a11c2dc5448636ee608866959aad0bf298fd6 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/6497244 Auto-Submit: Fumitoshi Ukai <ukai@google.com> Commit-Queue: Fumitoshi Ukai <ukai@google.com> Reviewed-by: Brian Ryner <bryner@google.com> Reviewed-by: Philipp Wollermann <philwo@google.com> Reviewed-by: Junji Watanabe <jwata@google.com> Reviewed-by: Takuto Ikuta <tikuta@chromium.org>
This commit is contained in:
34
README.md
34
README.md
@@ -22,6 +22,38 @@ The most important tools are:
|
||||
|
||||
There are a lot of git utilities included.
|
||||
|
||||
Also, includes shell script/batch file for tools required to build chromium,
|
||||
e.g.
|
||||
|
||||
- `gn`: a meta-build system that generates build files for Ninja
|
||||
- `autoninja`: a wrapper for `siso` and `ninja`.
|
||||
- `siso`: a build tool that aims to significantly speed up Chromium's build.
|
||||
- `ninja`: a small build system with a focus on speed. deprecated by Siso.
|
||||
|
||||
These shell script/batch file runs python script with `python-bin/python3`
|
||||
that find binaries in chromium checkout, and run with proper setup/check.
|
||||
To use these wrappers, you need to initialize/bootstrap depot_tools (using
|
||||
`gclient`, `update_depot_tools` or `ensure_bootstrap`).
|
||||
|
||||
## Installing
|
||||
|
||||
See [set-up documentation](https://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up).
|
||||
|
||||
depot_tools is also available in
|
||||
|
||||
- chromium's third_party/depot_tools:
|
||||
propagated by [autoroller](https://autoroll.skia.org/r/depot-tools-chromium-autoroll).
|
||||
|
||||
- on builder:
|
||||
[infra_internal/recipe_bundles/chrome-internal.googlesource.com/chrome/tools/build](https://chrome-infra-packages.appspot.com/p/infra_internal/recipe_bundles/chrome-internal.googlesource.com/chrome/tools/build) bundles depot_tools.
|
||||
propagated by [build_internal recipe roller](https://ci.chromium.org/ui/p/infra-internal/builders/cron/build_internal%20recipe%20roller)
|
||||
|
||||
These depot_tools would not be initialized/bootstrapped (i.e. no
|
||||
`python-bin/python3` binary available), so the build tool wrapper won't work,
|
||||
unless it is explicitly initialized by `ensure_bootstrap`.
|
||||
Or, directly call the python script instead of using the shell script/batch
|
||||
file.
|
||||
|
||||
|
||||
## Updating
|
||||
|
||||
@@ -32,7 +64,7 @@ run `./update_depot_tools_toggle.py --disable`.
|
||||
To update package manually, run `update_depot_tools.bat` on Windows,
|
||||
or `./update_depot_tools` on Linux or Mac.
|
||||
|
||||
On Windows only, running `gclient` will install `python`.
|
||||
Running `gclient` will install `python3` binary.
|
||||
|
||||
|
||||
## Contributing
|
||||
|
||||
Reference in New Issue
Block a user