ninja-mac is expanded to become a universal (“fat”) executable. The existing x86_64 slice was taken from the x86_64 ninja-mac as it previously existed in this location, and a new arm64 slice was added. This is an aid to native development on arm64. In macOS, subprocesses inherit their parent’s “binpref,” meaning that children of a translated process will, by default, also be translated, if there’s a choice between native and translated. Where ninja-mac is x86_64-only and runs translated on arm64, all tools it invokes will also run translated, even if native versions are available. This has an impact on any part of the toolchain for which universal versions are available: in Chrome’s case, tools such as ld64 are affected. In Crashpad’s build, which uses the compiler provided by Xcode, it even affects the compiler, leading to significant differences in build time on arm64. mark@arm-and-hammer zsh% file $(which ninja-mac) …/ninja-mac: Mach-O 64-bit executable x86_64 mark@arm-and-hammer zsh% time ninja -C out/release ninja: Entering directory `out/release' [1/1] Regenerating ninja files [511/511] LINK ./crashpad_minidump_test ninja -C out/release 1384.03s user 111.05s system 393% cpu 6:19.53 total mark@arm-and-hammer zsh% file $(which ninja-mac) …/ninja-mac: Mach-O universal binary with 2 architectures: [x86_64:Mach-O 64-bit executable x86_64] [arm64:Mach-O 64-bit executable arm64] …/ninja-mac (for architecture x86_64): Mach-O 64-bit executable x86_64 …/ninja-mac (for architecture arm64): Mach-O 64-bit executable arm64 mark@arm-and-hammer zsh% time ninja -C out/release ninja: Entering directory `out/release' [1/1] Regenerating ninja files [511/511] LINK ./crashpad_minidump_test ninja -C out/release 606.80s user 34.71s system 701% cpu 1:31.41 total This differs from the previous attempt, |
4 years ago | |
---|---|---|
bootstrap | 5 years ago | |
fetch_configs | ||
git-templates | ||
infra | 5 years ago | |
man | 5 years ago | |
python-bin | ||
recipes | 5 years ago | |
testing_support | 5 years ago | |
tests | 5 years ago | |
third_party | 5 years ago | |
win_toolchain | 5 years ago | |
zsh-goodies | ||
.cipd_impl.ps1 | 5 years ago | |
.gitattributes | ||
.gitignore | ||
.style.yapf | 5 years ago | |
.vpython | 5 years ago | |
.vpython3 | 5 years ago | |
CROS_OWNERS | 5 years ago | |
GOMA_OWNERS | 5 years ago | |
LICENSE | ||
LUCI_OWNERS | 5 years ago | |
OWNERS | 5 years ago | |
PRESUBMIT.py | 5 years ago | |
README.gclient.md | ||
README.git-cl.md | ||
README.md | 5 years ago | |
WATCHLISTS | 5 years ago | |
auth.py | ||
autoninja | 5 years ago | |
autoninja.bat | 5 years ago | |
autoninja.py | 5 years ago | |
bb | ||
bb.bat | ||
bootstrap_python3 | 5 years ago | |
breakpad.py | ||
cbuildbot | ||
chrome_set_ver | ||
cipd | 5 years ago | |
cipd.bat | 5 years ago | |
cipd_bin_setup.bat | ||
cipd_bin_setup.sh | ||
cipd_client_version | 5 years ago | |
cipd_client_version.digests | 5 years ago | |
cipd_manifest.txt | 5 years ago | |
cipd_manifest.versions | 5 years ago | |
cit | ||
cit.bat | ||
cit.py | ||
clang-format | ||
clang-format.bat | ||
clang_format.py | ||
clang_format_merge_driver | ||
clang_format_merge_driver.bat | ||
clang_format_merge_driver.py | ||
codereview.settings | ||
compile_single_file | ||
compile_single_file.bat | ||
compile_single_file.py | 5 years ago | |
cpplint.bat | ||
cpplint.py | 5 years ago | |
cpplint_chromium.py | ||
cros | 5 years ago | |
cros_sdk | ||
crosjobs | ||
detect_host_arch.py | ||
dirmd | 5 years ago | |
dirmd.bat | 5 years ago | |
download_from_google_storage | ||
download_from_google_storage.bat | ||
download_from_google_storage.py | 5 years ago | |
ensure_bootstrap | ||
fetch | 5 years ago | |
fetch.bat | 5 years ago | |
fetch.py | 5 years ago | |
fix_encoding.py | 5 years ago | |
gclient | 5 years ago | |
gclient-new-workdir.py | ||
gclient.bat | 5 years ago | |
gclient.py | 5 years ago | |
gclient_completion.sh | ||
gclient_eval.py | 5 years ago | |
gclient_paths.py | 5 years ago | |
gclient_scm.py | 5 years ago | |
gclient_utils.py | 5 years ago | |
gerrit_client.py | 5 years ago | |
gerrit_util.py | 5 years ago | |
git-cache | 5 years ago | |
git-cl | 5 years ago | |
git-crrev-parse | ||
git-drover | 5 years ago | |
git-find-releases | 5 years ago | |
git-footers | 5 years ago | |
git-freeze | 5 years ago | |
git-gs | ||
git-hyper-blame | 5 years ago | |
git-map | 5 years ago | |
git-map-branches | 5 years ago | |
git-mark-merge-base | 5 years ago | |
git-nav-downstream | 5 years ago | |
git-nav-upstream | ||
git-new-branch | 5 years ago | |
git-number | 5 years ago | |
git-rebase-update | 5 years ago | |
git-rename-branch | 5 years ago | |
git-reparent-branch | 5 years ago | |
git-retry | 5 years ago | |
git-runhooks | ||
git-squash-branch | 5 years ago | |
git-thaw | 5 years ago | |
git-upstream-diff | 5 years ago | |
git_cache.py | 5 years ago | |
git_cl.py | 5 years ago | |
git_cl_completion.sh | 5 years ago | |
git_common.py | 5 years ago | |
git_dates.py | ||
git_drover.py | 5 years ago | |
git_find_releases.py | 5 years ago | |
git_footers.py | 5 years ago | |
git_freezer.py | ||
git_hyper_blame.py | 5 years ago | |
git_map.py | 5 years ago | |
git_map_branches.py | 5 years ago | |
git_mark_merge_base.py | ||
git_nav_downstream.py | 5 years ago | |
git_new_branch.py | 5 years ago | |
git_number.py | 5 years ago | |
git_rebase_update.py | 5 years ago | |
git_rename_branch.py | ||
git_reparent_branch.py | ||
git_retry.py | ||
git_squash_branch.py | ||
git_upstream_diff.py | ||
gn | ||
gn.bat | ||
gn.py | ||
goma_auth | ||
goma_auth.bat | 5 years ago | |
goma_ctl | ||
goma_ctl.bat | 5 years ago | |
gsutil.py | ||
gsutil.py.bat | 5 years ago | |
gsutil.vpython | 5 years ago | |
led | ||
led.bat | ||
lockfile.py | 5 years ago | |
luci-auth | ||
luci-auth.bat | ||
lucicfg | ||
lucicfg.bat | ||
mac_toolchain | ||
metrics.README.md | 5 years ago | |
metrics.py | 5 years ago | |
metrics_utils.py | ||
my_activity.py | 5 years ago | |
ninja | ||
ninja-linux32 | ||
ninja-linux64 | ||
ninja-mac | 4 years ago | |
ninja.exe | ||
ninjalog.README.md | ||
ninjalog_uploader.py | 5 years ago | |
ninjalog_uploader_wrapper.py | 5 years ago | |
owners.py | 5 years ago | |
owners_finder.py | 5 years ago | |
post_build_ninja_summary.py | 5 years ago | |
presubmit_canned_checks.py | 5 years ago | |
presubmit_support.py | 5 years ago | |
profile.xml | ||
prpc | ||
prpc.bat | ||
pylint | ||
pylint-1.5 | ||
pylint-1.6 | ||
pylint-1.7 | ||
pylint-1.8 | ||
pylint-1.9 | ||
pylint.bat | ||
pylint_main.py | ||
pylintrc | 5 years ago | |
python_runner.sh | 5 years ago | |
rdb | 5 years ago | |
rdb.bat | 5 years ago | |
rdb_wrapper.py | 5 years ago | |
repo | 5 years ago | |
roll-dep | 5 years ago | |
roll-dep.bat | 5 years ago | |
roll_dep.py | 5 years ago | |
scm.py | 5 years ago | |
setup_color.py | ||
split_cl.py | 5 years ago | |
subcommand.py | 5 years ago | |
subprocess2.py | 5 years ago | |
update_depot_tools | 5 years ago | |
update_depot_tools.bat | 5 years ago | |
update_depot_tools_toggle.py | ||
upload_metrics.py | ||
upload_to_google_storage.py | ||
vpython | ||
vpython.bat | 5 years ago | |
vpython3 | 5 years ago | |
vpython3.bat | 5 years ago | |
watchlists.py | ||
weekly | ||
win32imports.py | 5 years ago | |
wtf | ||
yapf | 5 years ago | |
yapf.bat |
README.md
depot_tools
Tools for working with Chromium development. It requires python 2.7 or 3.8 for python 3 support.
Tools
The most important tools are:
fetch
: Agclient
wrapper to checkout a project. Usefetch --help
for more details.gclient
: A meta-checkout tool. Think repo or git submodules, except that it support OS-specific rules, e.g. do not checkout Windows only dependencies when checking out for Android. Usegclient help
for more details and README.gclient.md.git cl
: A code review tool to interact with Rietveld or Gerrit. Usegit cl help
for more details and README.git-cl.md.roll-dep
: A gclient dependency management tool to submit a dep roll, updating a dependency to a newer revision.
There are a lot of git utilities included.
Updating
depot_tools
updates itself automatically when running gclient
tool. To
disable auto update, set the environment variable DEPOT_TOOLS_UPDATE=0
.
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 git
and python
.
Contributing
To contribute change for review:
git new-branch <somename>
# Hack
git add .
git commit -a -m "Fixes goat teleporting"
# find reviewers
git cl owners
git log -- <yourfiles>
# Request a review.
git cl upload -r reviewer1@chromium.org,reviewer2@chromium.org --send-mail
# Edit change description if needed.
git cl desc
# If change is approved, flag it to be committed.
git cl set-commit
# If change needs more work.
git rebase-update
...
git cl upload -t "Fixes goat teleporter destination to be Australia"
See also open bugs, open reviews, forum or report problems.
cpplint.py
Until 2018, our cpplint.py
was a copy of the upstream version at
https://github.com/google/styleguide/tree/gh-pages/cpplint. Unfortunately, that
repository is not maintained any more.
If you want to update cpplint.py
in depot_tools
, just upload a patch to do
so. We will figure out a long-term strategy via issue https://crbug.com/916550.
Note that the cpplint.py
here is also used by the Tricium
analyzer,
so if the cpplint.py here changes, we should also update the copy used there.