Install depot_tools
Chromium and Chromium OS use a package of scripts called
depot_
tools to manage checkouts and code reviews. If you want more details about
depot_
tools, you can check the
depot_tools information page.
The depot_ tools package includes
The depot_ tools package includes
gclient
,
gcl
,
git-cl
,
repo
, and others.
Linux and Mac
- Make sure you have the necessary Chromium dependencies set up locally:
- On Linux: git is installed by default in normal configurations.
- On Mac: git is installed and available once Xcode is installed. See our Mac build instructions for more info on Xcode.
- Fetch depot_tools: git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
- Add
depot_tools
to your PATH:
$ export PATH=`pwd`/depot_tools:"$PATH"
(Yes, you want to put depot_tools ahead of everything else, otherwise gcl will refer to the GNU Common Lisp compiler.)
- You may want to add this to your
.bashrc
file or your shell's equivalent so that you don’t need to reset your $PATH manually each time you open a new shell.
Windows (Cygwin and non-Cygwin)
Preamble
Chromium is mostly designed to be run using the native Windows
tools and the
Msys (Git for Windows) toolchain. You can also use Cygwin, but that is supported in a more ad-hoc manner. The cygwin
tools do not interoperate with the native
tools very well, so f
irst decide if you want to use cygwin or not. Then,
do not switch.
If you use native svn on a cygwin's svn checkout and it blows up, you are on your own, e.g. you'll need to do a fresh checkout.
Instructions
If using Cygwin, you should have already installed cygwin by this point.
- Get a copy of depot_tools:
- Cygwin: Check out the tools using the command in step (2) for Linux and Mac above.
New versions of cygwin do not include root certs by default so you need to install a "ca-certificates-1.*-*" package! - Non-cygwin: Download depot_tools.zip and decompress it.
- Do not use drag-n-drop or copy-n-paste extract from Explorer, this will not extract the hidden ".git" folder which is necessary for depot_tools to autoupdate itself. You can use "Extract all..." from the context menu though.
- Do not extract to a path containing spaces. If you do, gclient will produce the error "update_depot_tools.bat was not expected at this time" or similar.
- Cygwin: Check out the tools using the command in step (2) for Linux and Mac above.
- Add
depot_tools
to the end (not start!) of your PATH:- With Administrator access:
- Control Panel > System and Security > System > Advanced system settings
- Modify the PATH system variable to include depot_tools
- Without Administrator access:
- Control Panel > User Accounts > User Accounts > Change my environment variables
- Add a PATH user variable: %PATH%;C:\path\to\depot_tools
- With Administrator access:
- Non-cygwin: Run
gclient
from the cmd shell. The first time it is run, it will install its own copy of svn and other tools. If you run gclient from a non-cmd shell, it may appear to run properly, but svn, python, and other tools may not get installed correctly (while it should work fine from a msys bash shell, you may still trip over bugs from time to time).- If you see strange errors with the file system on the first run of gclient, you may want to disable Windows Indexing.
- If you see errors like "The system cannot execute the specified program", try installing "Microsoft Visual C++ 2008 Redistributable Package".
- If it complains that it can't find python, make sure you don't already have a .gclient file in the same directory.
- Cygwin only: Close your shells, reopen a Cygwin shell, and ensure that
which svn
reports/usr/bin/svn
. If not, you either didn't install the svn package properly when installing Cygwin, or you put depot_tools on the front of your PATH instead of the back. Fix this before checking out any code, as once you check out, you want to always use the same svn (Cygwin or depot_tools) to work with that checkout -- otherwise strange things can happen that are most easily fixed by completely wiping the checkout.