Brave132 编译指南 Windows 篇：部署 depot_tools（三）
1. 引言
在 Brave 浏览器 132 版本的编译过程中，depot_tools 扮演着举足轻重的角色。作为 Chromium 项目官方提供的工具集，depot_tools 是获取、管理和更新 Chromium 及其衍生项目（包括 Brave）源代码的核心组件。借助 depot_tools，开发者可以高效地同步最新的源代码版本，并进行项目的构建、测试和维护。
本篇将详细阐述在 Windows 环境下部署和配置 depot_tools 的详细步骤。我们将引导您完成从工具获取到环境设置的整个过程，确保 depot_tools 能在您的开发环境中稳定运行。掌握这些步骤，将为后续的 Brave 132 浏览器编译和开发工作奠定坚实的基础。
2. depot_tools 部署与配置
2.1 获取 depot_tools
- 下载 depot_tools 压缩包： 访问以下链接下载 depot_tools 的压缩包：https://storage.googleapis.com/chrome-infra/depot_tools.zip
- 解压 depot_tools： 将下载的压缩包解压到您选择的目录中，例如
C:\depot_tools。
重要提示： 请务必使用右键菜单中的“全部解压缩...”选项进行解压，而不要使用拖放或复制粘贴的方式。后者可能导致隐藏的 .git 文件夹丢失，该文件夹对于 depot_tools 的自动更新至关重要。
2.2 配置系统环境变量
- 打开系统属性： 按下
Win + X组合键，选择“系统”。 - 进入高级系统设置： 在“系统”窗口中，点击“高级系统设置”。
- 打开环境变量： 在“系统属性”对话框中，点击“环境变量”按钮。
- 编辑 Path 变量： 在“系统变量”区域，选中名为
Path的变量，然后点击“编辑”按钮。 - 添加 depot_tools 路径： 点击“新建”按钮，输入 depot_tools 的完整解压路径（例如
C:\depot_tools），然后点击“确定”。
- 调整优先级： 选中新添加的 depot_tools 路径，并使用“上移”按钮将其移动到列表的最前面，确保其优先级高于任何已有的 Python 安装路径。
- 确认更改： 依次点击“确定”按钮，关闭所有打开的对话框。
2.3 设置 DEPOT_TOOLS_WIN_TOOLCHAIN 变量
- 新建系统变量： 在“环境变量”对话框的“系统变量”区域，点击“新建”按钮。
- 设置变量名： 在“变量名”文本框中输入
DEPOT_TOOLS_WIN_TOOLCHAIN。 - 设置变量值： 在“变量值”文本框中输入
0。 - 确认更改： 点击“确定”按钮。
此步骤指示 depot_tools 使用本地安装的 Visual Studio 版本，而不是 Google 内部使用的版本。
2.4 配置 Visual Studio 路径（可选）
如果您的 Visual Studio 2022 安装在非默认路径，或者您希望明确指定其安装位置，可以设置 vs2022_install 环境变量。例如：
set vs2022_install=C:\Program Files\Microsoft Visual Studio\2022\Community2.5 验证安装
- 打开命令提示符： 按下
Win + R组合键，输入cmd，然后按下回车键。 - 运行 gclient： 在命令提示符窗口中，输入
gclient并按下回车键。
首次运行 gclient 时，它会自动下载并安装必要的 Windows 组件，包括 msysgit 和 Python。
重要提示： 请务必使用 cmd.exe（命令提示符）运行此命令。在其他 shell 环境（如 Cygwin 或 PowerShell）中运行可能导致组件安装不完整或失败。
如果遇到与文件系统相关的异常错误，您可以尝试暂时禁用 Windows 索引服务。
3. 结语
本篇详细介绍了在 Windows 平台下部署和配置 depot_tools 的完整过程。这套工具集是编译 Brave 132 浏览器的基石，对于源代码的获取、管理和更新至关重要。我们涵盖了从下载到环境变量设置的每个关键步骤，确保 depot_tools 能在您的开发环境中稳定运行。
完成 depot_tools 的部署后，您已为获取 Brave 源码和开始编译过程做好了准备。接下来的步骤将涉及 Git 的安装，它是版本控制和源码管理的核心工具。在下一篇文章《Brave132 编译指南 Windows 篇：配置 Git（四）》中，我们将详细讲解如何在 Windows 系统上安装和配置 Git，为您的开发工作提供全面的版本控制支持。敬请关注后续内容，继续为 Brave 浏览器的开发之旅做好充分准备。