用于Chromium开发的工具。要支持python 3,需要python 2.7或3.8。
depot_tools是个工具包(depot是仓库的意思),里面包含gclient、gcl、gn和ninja等工具,这些根据都是使用python写的。其主要的功能是对git的增强,让代码管理和编译更加简单,要学这个的前提是要会使用git。
工具最重要的工具是:
fetch
:gclient
用于签出项目的包装器。使用fetch --help
更多的细节。gclient
:元签出工具。考虑repo或git子模块,除非它支持特定于操作系统的规则,例如,签出Android时不要签出Windows依赖项。使用gclient help
更多的细节和README.gclient.md。git cl
:与Rietveld或Gerrit交互的代码审查工具。使用git cl help
更多的细节和README.git-cl.md。roll-dep
:一个gclient依赖性管理工具,用于提交dep roll,将依赖性更新为较新的修订版。
包含很多git实用程序。
depot_tools安装下面这个操作,最好是使用境外服务器或者用一个好的vpn,不然的话,不要问为什么
linux/mac
克隆depot_tools存储库:
$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
将depot_tools添加到PATH 的末尾(您可能希望将其放入您的~/.bashrc
或~/.zshrc
)。假设您将depot_tools克隆为 /path/to/depot_tools
:
$ export PATH=$PATH:/path/to/depot_tools
windows
下载depot_tools https://storage.googleapis.com/chrome-infra/depot_tools.zip并将其解压缩到某处。
或者csdn下载地址:depot_tools.zip
配置环境变量,这里需要注意,这个位置必须在python和以及git之前
从cmd.exe
中运行命令gclient
(不带参数)。在第一次运行时,gclient将安装使用代码所需的所有Windows工具,包括msysgit和python。
-
如果从非cmd shell(例如,cygwin,PowerShell)运行gclient,它可能看起来运行正常,但msysgit,python和其他工具可能无法正确安装。
-
如果在第一次运行gclient时看到文件系统出现奇怪错误,则可能需要禁用Windows索引。
-
运行gclient后打开命令提示符并输入
where python
并确认depot_tools python.bat位于python.exe的任何副本之前。使用gn时未能确保这会导致过度构建 - 请参阅 crbug.com/611087。
depot_tools
运行gclient
工具时会自动更新。要禁用自动更新,请设置环境变量DEPOT_TOOLS_UPDATE=0
。
要手动更新软件包,请update_depot_tools.bat
在Windows或./update_depot_tools
Linux或Mac上运行。
仅在Windows上,运行gclient
会安装git
和python
。
获取代码
选择一个空目录并运行以下命令之一:
$ fetch chromium # Basic checkout for desktop Chromium
$ fetch android # Chromium checkout for Android platform
$ fetch ios # Chromium checkout for iOS platform
当fetch
工具完成,你应该在你的工作目录下:
.gclient # A configuration file for you source checkout
src/ # Top-level Chromium source checkout.
如果您使用的是Linux,并且是首次获取代码,则需要运行:
$ cd src && ./build/install-build-deps.sh
最后:
$ gclient sync
这将拉出Chromium src检出的所有依赖项。每当您更新主src签出时(包括切换分支时),都将需要运行此命令。