Chromium源码学习（1）—— 拉取源码，编译

2024-05-30 17:36
文章标签 编译 源码 学习 拉取 chromium

本文主要是介绍Chromium源码学习（1）—— 拉取源码，编译，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

阅读建议：先简单过一下整个文章目录结构，大致了解一下各个步骤在干什么，然后在上手操作可能会事半功倍。也许你遇到的有些问题文章中已经提及到了，但是由于你没有往下看导致卡进度。

Chromium简介

Chromium项目于2008年发布，作为Google Chrome浏览器的开源部分。Google的Chrome浏览器基于Chromium开发，但添加了Google品牌、自动更新、内置Flash播放器、PDF阅读器等一些闭源的功能和服务。

除了Chorm，近几年微软大火的Edge浏览器也是基于Chromium进行开发的。

Chromium开源项目有活跃的社区和丰富的学习资源，官方也有详细的开发者文档，涵盖了从环境设置到代码贡献的各个方面。
Chromium官方网站

学习chromium源码并不是很适合编程初学者，初学者应该从编程语言，数据结构，操作系统，网络等知识进行学习。

而chromium主要使用C++语言进行编写，所以，学习chromium需要对C++语言比较熟悉。

这篇文章主要介绍如何拉取chrmmium源码以及如何使用vs系列的编译器进行编译。当然你也可以参照官方文档进行拉取源码以编译。

注意：官方建议环境

  • 硬件和软件需求
    • 具有至少 8GB RAM 的 64 位 Intel 计算机。强烈建议 16GB 以上。
    • NTFS 格式的硬盘上至少有 100GB 的可用磁盘空间。不能使用FAT32格式 ，因为某些 Git 包文件大于 4GB。
    • Windows 10 或更高版本。

如果自己的电脑配置不满足需求，就没必要继续向下进行了。

1.拉取源码

一般公司或者学校都使用Git维护代码，而chromium使用Google自己开发的Depot Tools管理代码仓库工具来维护chromium项目。在整个学习chromium的过程会看到很多东西都是Google自己开发的，并没有使用现有的。比如chromium的UI界面，由于Goolgle看不惯window提供的UI界面，于是自己开发了Views框架做为chormium的ui组件。

depot_tools是个工具包（depot是仓库的意思），里面包含gclient、gcl、gn和ninja等工具，这些根据都是使用python写的。其主要的功能是对git的增强，让代码管理和编译更加简单,如果熟悉Git的话就很容易上手了。不熟悉也没关系，就一些常用的命令，用的时间久了，自然就会了。

与Git不同的是：Depot Tools 更专注于大型项目的管理，提供了一些额外的功能和工具来满足大型项目的开发需求；而 Git 则是一种通用的版本控制系统，可以用于管理各种规模的项目，提供了丰富的版本控制和分支管理功能。

所以在拉取源码之前需要先下载Depot Tools

1.1 安装Depot Tools

下载Depot Tools。https://storage.googleapis.com/chrome-infra/depot_tools.zip
将其解压到指定的文件夹下(不要有中文路径)。

比如我解压在本地E盘下dev文件夹
image.png

注意：解压的时候，请务必使用“全部解压缩”选项或是其他的第三方软件解压缩。，千万不要双击打开复制文件，到文件加中，会丢失隐藏的.git 文件夹，导致工具无法更新

可以在你解压的文件夹中查看是否有.git文件夹。如果没有，则说明你可能解压错了，也有可能是你没有显示隐藏文件。
按照下图打开隐藏文件即可。

image.png
下载完Depot Tools后，顺便把环境变量配置好。按照下面的步骤即可

  • 1.win+i快捷键打开设置
  • 2.搜索框搜索环境变量(我是win11系统，win10界面会不一样)
    image.png
  • 3.选择编辑系统环境变量
  • 4.选择环境变量
    image.png
  • 5.在环境变量设置窗体中，下方的系统变量 选择中 “PATH”项，然后点击编辑。(一定是系统环境变量不要选择位用户环境变量)

image.png

  • 6.点击新建，然后选择刚才解压的depot tools路径。

image.png

  • 7.选中刚才新建的环境变量，使用上移移动到环境变量最顶部。(官方建议，有些电脑已经安装了python环境,而depot tools内置了python环境。)

image.png

  • 8.依次点击“确定”按钮保存(每一层都需要确定)

recording.gif

1.2验证depot_tools是否安装成功

按win键，搜索Windows PowerShell。打开即可。
(windows powershell也适用一些linux命令，比如ls，cd等等)
image.png
在打开的Windows PowerShell工具的窗体中输入glcient。

注意：后续拉取源码等操作需要代理。

  • 如果出现下面这种情况，则说明是代理的问题，关于代理自行解决。
    image.png

  • 如果报错，那么在安装Depot Tools时或者环境变量配置出错了，重新安装配置即可。

  • 如果显示如下，恭喜您安装成功了，并且已经初始化升级成功。
    image.png

2.拉取源码

在本地创建一个文件夹，用于存放Chromium的源代码。建议空闲空间在200G以上。

比如我这里在本地创建了一个chromium文件夹用来存放源码(忽略已存在的文件，新建的是一个空白什么都没有的文件夹)

image.png
在此处打开Windows PowerShell工具shitf+右键选择在此处打开Powershell窗口即可。

image.png
在Windows PowerShell工具 使用 fetch chromium 命令拉取Chromium的源代码。

这里为了节约时间，我们添加 “–no-history”选项，不拉取历史记录，只拉取最新版Chromium
fetch --no-history chromium

image.png
如果出现下面这种情况，则说明你网络问题，没有设置代理，因为源码在国外，这个办法自己百度解决。(这个东西不敢教，多多包含…)一般设置为全局代理+TUN模式就可以了。如果你使用的是校园网，学校可能会拦截你，也是无法拉取的。
image.png
正常拉取源码如下图：
image.png
出现下面这种情况耐心等待即可。整个时长大概十分钟左右。
这是在向你的磁盘中写入数据， 打开你的存放chromium的文件夹，就可以看到在有新的文件夹被写入。
image.png
写入完成后就开始下载源码了。

image.png
整个源码大概40Gb左右，拉取时间非常长，耐心等待即可。
如果中途断掉了，不用删除全部文件重新拉取，使用gclient sync命令继续拉取即可。(gclient sync 是用于同步 Chromium 源代码的命令)
image.png
如果使用gclient sync进行同步时，出现错误，也是由于网络原因造成的，将你的windows PwoerShell设置代理即可。(我这里使用的使用clash for window，端口号使用的是默认的7890，你的端口号取决于你使用的代理。)

设置代理命令如下：

$env:HTTP_PROXY="http://127.0.0.1:7890"

$env:HTTPS_PROXY="http://127.0.0.1:7890"
image.png
设置完代理后，就可以正常的同步进行下载了

image.png

3.编译项目

3.1配置环境

编译项目使用官方推荐的vs2022即可，关于vs2022的安装，参考本人另一篇博客：
vs2022安装

安装完成后，也需要设置Visual Studio 2022 的安装路径的环境变量。
在系统环境变量中直接新建环境变量vs2022_install。变量值设置为vs2022的安装路径即可。

image.png

除了设置vs2022的安装环境变量，还需要设置DEPOT_TOOLS_WIN_TOOLCHAIN环境变量。

因为我们需要使用本地算力编译Chromium，所以需要添加 DEPOT_TOOLS_WIN_TOOLCHAIN 环境变量，并将其设置为 0。这告诉 depot_tools 使用本地安装的 Visual Studio 版本（默认情况下，depot_tools 将尝试使用 google 内部版本）

一样的，添加系统环境变量，变量名为：DEPOT_TOOLS_WIN_TOOLCHAIN,值为0即可。

image.png

3.2安装Windows SDK

Windows SDK - Windows app development | Microsoft Developer
因为在编译chrom时需要 10.0.22621.2428版本的Windows 11 SDK ，上面连接就是下载地址。
进入后点击下面下载即可。这里建议使用.ios镜像，直接在线下载完安装就行了。
image.png
下载完成后，安装即可

image.png
一路next即可，在安装组件的时候，选择Debugging Tools for Windows组件。

image.png

安装完成后，设置环境变量WINDOWSSDKDIR,值为安装Windows SDK 的安装路径。

image.png

3.3生成sln工程文件

在Depot Tools工具包中提供了一个gn构建文件的工具。它的全称是 “Generate Ninja”，gn 工具的主要作用是将配置文件转化为 Ninja 构建系统可以使用的文件，从而管理项目的编译和链接。

通过gn工具，可以生成vs的工程文件。
按照一下步骤进行生成工程文件。

  • 1.打开Window PowerSheell,切换到chromium的src路径下。
  • 2.使用gn工具生成sln工程文件。gn args --ide=vs --filters=//chrome --no-deps .\out\vs_dev

    • 参数说明:

      • gn：调用 GN 工具。GN 是 “Generate Ninja” 的缩写，它用于生成构建文件（如 Ninja 构建系统的文件）。
      • args：GN 的一个子命令，用于生成或更新 args.gn 文件中的构建参数。
      • --ide=vs：指定生成适用于 Visual Studio 的项目文件。这个参数告诉 GN 生成 .sln 和 .vcxproj 文件，以便在 Visual Studio 中打开和编辑。
      • filters=//chrome：指定只生成 //chrome 目录下的项目文件。这个过滤器确保只有与 //chrome 模块相关的文件会被包括在生成的项目中。
      • --no-deps：指示 GN 不包括 //chrome 模块的依赖项。通常，模块可能依赖于其他许多库和组件，这个选项确保这些依赖项不会被包含，从而减少生成的项目文件数量。

    • 解释:

      • 由于整个chormium项目是非常庞大的，通过指定参数生成特定的模块项目，这里使用--filters=//chrome --no-deps选项只生成chrome相关的模块。
      • 这样做的好处就是能大幅度减少项目文件的数量，让开发和调式更高效。最直观的就是在第一次编译的时候，chrome相关的大概有五万多个文件，编译一般在6-8小时。如果全部都进行编译的话，时间只会更长。

image.png

  • 3.添加编译参数，方便调式
    • 执行上面的命令后，会自动弹出一个args文件，在弹出的args文件中添加is_debug = true 和 is_component_build = true。
    • 添加完成后 关闭即可。
    • 这样你可以启用调试模式和组件构建模式。在后续使用vs中可以很好的调式代码。就不用在进行配置啦。

image.png

  • 4.等待工程文件生成即可。
    • 生成工程文件的时间并不会很长，生成后，使用vs2022打开即可。
    • 如果生成失败错误如下：说明环境变量搞错了。
    • 在window powershell 窗口中设置临时环境变量即可$env:WINDOWSSDKDIR = "D:\Windows Kits\10"替换为你的windows sdk安装路径。
      image.png
    • 成功生成如下：
      image.png
    • 同时，在你本地路径下就可看到sln工程文件了。

image.png

  • 5.使用vs2022 编译chromium项目

    • 右键all.sln工程文件，使用vs2022打开。

    image.png

    • 打开后 出现下面的信息，不用升级取消即可。升级后版本不匹配会带来问题的。

    image.png

    • 正常打开如下，点击运行即可进行编译。

    image.png

    • 如果出现下面的报错信息，下载ninja即可。

    image.png

    • nijia官网Ninja, a small build system with a focus on speed (ninja-build.org)下载nijia进行安装

    image.png

    image.png

    • 解压下载好的nijia即可
      image.png
    • 下载完nijia同样需要配置系统环境变量的PATH。需要保证在deptos_tools的上面即可。
      image.png
    • 然后重启vs2022重新进行编译即可。(不重启环境变量可能没生效)
    • 整个编译周期很长，CPU资源会被吃完，建议晚上进行编译，整个过程大概在6-8小时，不同配置的电脑存在区别。(不用担心，后续进行编译调式的时候用不了这么长时间，因为第一次已经成了ojb文件，后续直接进行连接即可，不用重新生成，后续进行调式编译的时候，大概是10分钟以下)

这篇关于Chromium源码学习（1）—— 拉取源码，编译的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1016616。

相关文章

HarmonyOS学习(七)——UI（五）常用布局总结

HarmonyOS学习(七)——UI（五）常用布局总结

自适应布局 1.1、线性布局（LinearLayout） 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列，Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距，达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式，且在各类尺寸屏幕上表现一致，其中交叉轴为垂直时，取值为Vert
阅读更多...
Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya（不是本人，claude AI）在社交媒体上分享了他在OpenAI学习到的15个Prompt撰写技巧。 以下是详细的内容： 提示精确化:在编写提示时,力求表达清晰准确。清楚地阐述任务需求和概念定义至关重要。例:不用"分析文本",而用"判断这段话的情感倾向:积极、消极还是中性"。 快速迭代:善于快速连续调整提示。熟练的提示工程师能够灵活地进行多轮优化。例:从"总结文章"到"用
阅读更多...
【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【课程链接】 AntV G6：深入图形与图形分组、自定义节点、节点动画（下）_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中，应该怎样去计算和绘制图形，如何给一个图形制作不间断的动画，以及在鼠标事件之后产生动画。（有点难，需要好好理解） <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06
阅读更多...
学习hash总结

学习hash总结

2014/1/29/   最近刚开始学hash，名字很陌生，但是hash的思想却很熟悉，以前早就做过此类的题，但是不知道这就是hash思想而已，说白了hash就是一个映射，往往灵活利用数组的下标来实现算法，hash的作用：1、判重；2、统计次数；
阅读更多...
JAVA智听未来一站式有声阅读平台听书系统小程序源码

JAVA智听未来一站式有声阅读平台听书系统小程序源码

智听未来，一站式有声阅读平台听书系统 🌟&nbsp;开篇：遇见未来，从“智听”开始 在这个快节奏的时代，你是否渴望在忙碌的间隙，找到一片属于自己的宁静角落？是否梦想着能随时随地，沉浸在知识的海洋，或是故事的奇幻世界里？今天，就让我带你一起探索“智听未来”——这一站式有声阅读平台听书系统，它正悄悄改变着我们的阅读方式，让未来触手可及！ 📚&nbsp;第一站：海量资源，应有尽有 走进“智听
阅读更多...
零基础学习Redis(10) -- zset类型命令使用

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合，内部除了存储元素外，还会存储一个score，存储在zset中的元素会按照score的大小升序排列，不同元素的score可以重复，score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]
阅读更多...
【机器学习】高斯过程的基本概念和应用领域以及在python中的实例

【机器学习】高斯过程的基本概念和应用领域以及在python中的实例

引言 高斯过程（Gaussian Process，简称GP）是一种概率模型，用于描述一组随机变量的联合概率分布，其中任何一个有限维度的子集都具有高斯分布 文章目录 引言一、高斯过程1.1 基本定义1.1.1 随机过程1.1.2 高斯分布 1.2 高斯过程的特性1.2.1 联合高斯性1.2.2 均值函数1.2.3 协方差函数（或核函数） 1.3 核函数1.4 高斯过程回归（Gauss
阅读更多...
【学习笔记】 陈强-机器学习-Python-Ch15 人工神经网络（1）sklearn

【学习笔记】 陈强-机器学习-Python-Ch15 人工神经网络（1）sklearn

系列文章目录 监督学习：参数方法 【学习笔记】 陈强-机器学习-Python-Ch4 线性回归 【学习笔记】 陈强-机器学习-Python-Ch5 逻辑回归 【课后题练习】 陈强-机器学习-Python-Ch5 逻辑回归（SAheart.csv） 【学习笔记】 陈强-机器学习-Python-Ch6 多项逻辑回归 【学习笔记 及 课后题练习】 陈强-机器学习-Python-Ch7 判别分析 【学
阅读更多...
Java ArrayList扩容机制 （源码解读）

Java ArrayList扩容机制 （源码解读）

结论：初始长度为10，若所需长度小于1.5倍原长度，则按照1.5倍扩容。若不够用则按照所需长度扩容。 一. 明确类内部重要变量含义         1：数组默认长度         2:这是一个共享的空数组实例，用于明确创建长度为0时的ArrayList ，比如通过 new ArrayList<>(0)，ArrayList 内部的数组 elementData 会指向这个 EMPTY_EL
阅读更多...
系统架构师考试学习笔记第三篇——架构设计高级知识（20）通信系统架构设计理论与实践

系统架构师考试学习笔记第三篇——架构设计高级知识（20）通信系统架构设计理论与实践

本章知识考点：         第20课时主要学习通信系统架构设计的理论和工作中的实践。根据新版考试大纲,本课时知识点会涉及案例分析题(25分),而在历年考试中,案例题对该部分内容的考查并不多,虽在综合知识选择题目中经常考查,但分值也不高。本课时内容侧重于对知识点的记忆和理解,按照以往的出题规律,通信系统架构设计基础知识点多来源于教材内的基础网络设备、网络架构和教材外最新时事热点技术。本课时知识
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2