指纹浏览器开发第一步- Chromium 编译教程（Windows）

🛠 指纹浏览器开发第一步- Chromium 编译教程（Windows）

参考官方文档：Chromium Windows Build Instructions

---

一、系统要求

编译 Chromium 对环境有一定要求，请确认你的设备满足以下条件：

• 一台 64 位 处理器电脑
• 推荐内存：16GB 及以上（最少 8GB）
• 硬盘空间：100GB 以上空闲，必须是 NTFS 格式
• 操作系统：Windows 10 或更新版本
• Visual Studio 版本：安装支持 C++ 的版本，见下文

---

二、安装 Visual Studio

Chromium 编译需要使用 Visual Studio 提供的编译工具链。

推荐安装方式

1. 下载 Visual Studio 安装器：下载地址
2. 安装以下组件（手动勾选）：
   • Desktop development with C++
   • MFC/ATL support
3. 或者使用命令行静默安装：

PATH_TO_INSTALLER.EXE ^
--add Microsoft.VisualStudio.Workload.NativeDesktop ^
--add Microsoft.VisualStudio.Component.VC.ATLMFC ^
--includeRecommended

---

三、安装 Windows SDK

需要安装并配置以下 SDK 组件：

• Windows 11 SDK：版本 10.0.22621.2428
• Debugging Tools for Windows：版本 10.0.22621.755 或更高

安装 Debugging Tools 方法：

1. 打开「控制面板」→「程序」→「程序和功能」
2. 找到 Windows Software Development Kit [version] → 点击「更改」
3. 勾选「Debugging Tools for Windows」，然后继续安装

---

四、安装 depot_tools

depot_tools 是 Google 提供的一组工具集，用于下载和管理 Chromium 项目。

安装步骤：

1. 下载地址：https://commondatastorage.googleapis.com/chrome-infra/depot_tools.zip
2. 解压到 C:\src\depot_tools 目录（可以自定义）
3. 将其添加到系统环境变量 PATH 的最前面

---

五、设置环境变量

确保以下环境变量设置正确：

setx PATH "C:\src\depot_tools;%PATH%"
setx vs2022_install "C:\Program Files\Microsoft Visual Studio\2022\Community"  // 按你的安装路径调整

---

六、设置网络代理（科学上网）

Chromium 代码托管在多个国外服务器，需代理才能访问：
假设你的代理服务运行提供的端口是10809，则配置如下。
可以右击 “我的电脑” 属性设置，高级，里面的环境变量设置里面设置

set http_proxy=http://127.0.0.1:10809
set https_proxy=http://127.0.0.1:10809

---

七、配置 Git 与下载源码

先配置 Git 信息：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global core.autocrlf false
git config --global core.filemode false
git config --global branch.autosetuprebase always

下载代码：

mkdir chromium && cd chromium
fetch --no-history chromium
gclient sync

📌 注意：初次下载可能耗时数小时，请耐心等待。

---

八、构建与编译

1. 生成构建文件（使用 GN）

gn gen out\Default --args="is_component_build=false is_debug=false enable_nacl=false blink_symbol_level=0 v8_symbol_level=0 symbol_level=0"

⚠️ 注意事项：

• 不要开启 is_debug=true，否则编译后的浏览器运行非常卡
• 参数字符串中 不要去掉空格

---

2. 编译 Chromium

ninja -C out\Default chrome

编译成功后，out\Default\chrome.exe 即为 Chromium 启动文件。

---

3. 生成安装包

ninja -C out\Default mini_installer

这将会在 out\Default 目录下生成 mini_installer.exe 安装包。

• 安装方式：静默安装
• 默认安装路径：C:\Users\<你的用户名>\AppData\Local\Chromium

---

💡 常见问题

1. fetch 命令找不到？
   • 确保 depot_tools 添加到了 PATH 的最前面
2. 构建失败提示缺少某个工具？
   • 重新检查 VS 和 SDK 是否安装了必要组件
3. 编译太慢？
   • 可用参数开启并行构建，例如 -j 8 表示 8 线程。或增加内存和cpu

---

📚 附录

• 官方文档：Chromium Docs
• 编译所需硬件参考：System Requirements
• 自定义构建参数：GN Args Reference
• 系列教程源码将放在 github 上开源指纹浏览器

---

如果你还想了解如何调试 Chromium 或自定义构建模块，我也可以继续帮你写对应的教程。需要的话告诉我就行 👍