Selaa lähdekoodia

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>
Fumitoshi Ukai 3 kuukautta sitten
vanhempi
commit
d5d4b956e2
1 muutettua tiedostoa jossa 33 lisäystä ja 1 poistoa
  1. 33 1
      README.md

+ 33 - 1
README.md

@@ -22,6 +22,38 @@ The most important tools are:
 
 
 There are a lot of git utilities included.
 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
 ## Updating
 
 
@@ -32,7 +64,7 @@ run `./update_depot_tools_toggle.py --disable`.
 To update package manually, run `update_depot_tools.bat` on Windows,
 To update package manually, run `update_depot_tools.bat` on Windows,
 or `./update_depot_tools` on Linux or Mac.
 or `./update_depot_tools` on Linux or Mac.
 
 
-On Windows only, running `gclient` will install `python`.
+Running `gclient` will install `python3` binary.
 
 
 
 
 ## Contributing
 ## Contributing