Chromium内核浏览器编译记(四)Linux版本CEF编译

封面

转载请注明出处:https://www.jianshu.com/p/dd7ecb170f41

本文出自 容华谢后的博客

0.写在前面

本篇文章是用来记录编译Linux版本CEF的步骤和踩过的坑,以防止后续再用到的时候忘记,同时也希望能够帮助到遇到同样问题的同学。

简单介绍下CEF,CEF的全称是Chromium Embedded Framework(Chromium嵌入式框架),它是一个开源的软件框架,用于嵌入Chromium浏览器引擎到其他应用程序中。允许开发者将Chromium的强大的Web渲染引擎嵌入到他们自己的应用程序中,以实现内嵌的浏览器功能,目前支持Windows、Linux、macOS平台。

本文的开发环境使用的是VMware虚拟机,在上面安装了Ubuntu 20.04.4 64位操作系统,分配了200G的硬盘空间,16G内存,12核心CPU,编译时间大概在5小时左右。

1.准备工作

因为Chromium的源码都在外面的世界,所以在下载源码之前,先要在Ubuntu系统上开启代理,本文中使用的是Clash工具,在GitHub中可以搜索到Linux版本客户端。

1.1 安装Git

使用以下命令安装:

sudo apt-get install git

设置Git网络代理:

git config --global http.proxy http://127.0.0.1:端口号

git config --global https.proxy https://127.0.0.1:端口号

下载源码的过程中,可能会报Git缓存的异常,可以通过以下命令把缓存设置的大一些:

sudo git config --global http.postBuffer 5242880000

sudo git config --global https.postBuffer 5242880000

1.2 配置depot_tools

Chromium使用了depot_tools来管理代码,先通过Git拉取代码:

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

配置环境变量:

export PATH="$PATH:$HOME/depot_tools"

注意:文章中是把depot_tool下载到了【home/用户名】目录下,所以使用【$HOME】代表,环境变量要根据实际下载的路径修改。

源码的位置在这里:

源码位置

1.3 配置下载工具代理

在【home/用户名】目录下新建一个.boto文件:

[boto]
proxy=127.0.0.1
proxy_port=端口号

配置环境变量:

export NO_AUTH_BOTO_CONFIG="$PATH:$HOME/.boto"

2.源码下载

2.1 创建目录结构

当前处于【home/用户名】目录下,执行以下命令,创建几个文件夹:

mkdir CEF && cd CEF && mkdir automate && mkdir chromium_git

最终的目录结构是这样的:

~/CEF/
    automate/
        automate-git.py/
    chromium_git/
        cef/
        chromium/
        update.sh

~/depot_tools/

2.2 下载automate-git.py脚本

当前在CEF目录下,需要切换到automate目录下,执行下面的命令下载脚本:

cd automate

wget https://bitbucket.org/chromiumembedded/cef/raw/master/tools/automate/automate-git.py

2.3 创建update.sh脚本

当前在automate目录下,需要切换到chromium_git目录下:

cd ..

cd chromium_git

脚本内容:

python3 ../automate/automate-git.py --download-dir=/home/alidili/CEF/chromium_git --branch=5414 --chromium-checkout=109.0.5414.120 --depot-tools-dir=/home/alidili/depot_tools --no-distrib --no-build

其中 --branch 是CEF的分支版本,可以指定需要的版本,如果需要最新版本直接去掉这个参数就可以,--chromium-checkout 是Chromium源码的Tag版本,如果不需要指定可以去掉。注意如果需要指定版本,CEF的版本和Chromium的版本要保持一致。

--download-dir 后的路径修改成你设备上的实际路径,alidili是用户名,--depot-tools-dir 改成在1.2中下载的depot_tools的路径。

2.4 下载源码

当前在chromium_git目录下,执行下面的命令:

chmod 755 update.sh

./update.sh

可以看到下面的进度提示:

下载源码

提示这个就代表下载完了,如果中途下载失败了,重新执行上面的命令就可以了:

下载源码完成

3.源码编译

3.1 支持音视频

源码下载完成后,需要修改下支持音视频,打开这个头文件:

chromium_git/chromium/src/third_party/ffmpeg/chromium/config/Chromium/linux/x64/config_components.h

#define CONFIG_SIPR_PARSER 1 由0修改为1,启用FFmpeg。

3.2 生成工程

终端输入这个命令:

export GN_DEFINES="use_sysroot=true symbol_level=1 is_cfi=false use_thin_lto=false use_vaapi=false ffmpeg_branding=Chrome proprietary_codecs=true is_official_build=true use_gnome_keyring=false chrome_pgo_phase=0"

当前在chromium_git目录下,切换到cef目录下,执行生成工程脚本:

cd chromium/src/cef

./cef_create_projects.sh

看到这个提示就代表构建成功了:

生成工程文件

3.3 编译cefclient与chrome_sandbox

当前在cef目录下,切换到src目录下,终端输入下面的命令:

cd ..

ninja -C out/Release_GN_x64 cefclient chrome_sandbox

如果想要生成Debug版本,Release_GN_x64改成Debug_GN_x64就可以了。

编译过程十分漫长,大概五六个小时,看到下面的提示就代表编译成功了:

编译cefclient & chrome_sandbox

生成的文件如下:

cefclient

3.4 生成CEF二进制分发包

当前在src目录下,切换到tools目录下,执行下面的命令:

cd cef/tools

./make_distrib.sh --ninja-build --minimal --x64-build

这个过程还比较快,出现下面的提示就成功了:

编译完成

生成的文件如下:

分发包

到这里整个CEF就编译完成了。

生成的cefclient在/home/alidili/CEF/chromium_git/chromium/src/out目录下

生成的分发包在/home/alidili/CEF/chromium_git/chromium/src/cef/binary_distrib目录下

4.遇到的问题

4.1 磁盘空间

源码+编译缓存大概会占用100多G的空间,如果用虚拟机的话,硬盘空间一定要预留够,大概200G差不多。

4.2 depot_tools环境变量

Chromium是使用depot_tools来管理源码的,如果拉取源码的时候,提示找不到fetch指令,那一定是环境变量的问题了,仔细看下路径设置的对不对。

4.3 Git网络代理

记得一定要给Git设置网络代理,不能拉取源码会一直超时,梯子我用的收费的Ghelper,里面有Clash的订阅。

4.4 下载源码不全怎么办

在2.4步骤中,使用update.sh下载源码,因为Chroium源码比较大,中间可能因为网络原因,导致下载超时或者个别文件下载不全,这个时候再次执行update.sh也可能同步不全。

这个时候,在 /CEF/chromium_git/chromium/src 目录下执行下面的命令同步Chromium的源码:

gclient sync

4.5 编译总是失败

编译的时候可能会报一些异常,这些异常大部分是因为源码不全导致的,使用下面的命令重置下代码:

git reset --hard

然后删除 /CEF/chromium_git 目录和 /CEF/chromium_git/chromium/src 目录下的cef目录,然后重新执行update.sh脚本即可。

4.6 编译过程中提示:No such file or directory: 'gcc'

提示缺什么库,通过下面的命令安装什么就可以了:

sudo apt install gcc

4.7 编译过程中提示:提示 gtk/gtk.h file not found

同4.6,缺什么安装什么就可以了:

sudo apt-get install libgtk-3-0

sudo apt install libgtk-3-dev

安装了上面的gtk库,有可能还是提示找不到,配置下环境变量:

export CPATH=$CPATH:/usr/include/gtk-3.0
export CPATH=$CPATH:/usr/include/gtk-3.0/gtk
export CPATH=$CPATH:/usr/include/gtk-3.0/gdk
export CPATH=$CPATH:/usr/include/gtk-3.0/unix-print

4.8 不要尝试修改源码解决编译问题

编译中遇到的99%的问题都是因为源码不全或者缺少相关库导致的,不要试图修改源码解决问题,不然会发送连锁的错误反应浪费时间。

如果遇到编译无论如何都过不了的问题,相信我,不要做别的操作了,删除所有源码,重新按照步骤再来一遍。

5.写在最后

下载和编译的过程中,可能会遇到各种各样奇怪的问题,奇怪到各个搜素引擎都搜不到答案,ChatGPT也给不出切实的解决方案,不断的查搜索引擎、查文档、查StackOverFlow,不断的换提问的方式,查到头脑发昏心情不好,这个时候千万不要放弃,问题离解决只差一步了,当看到编译成功的提示时,一切都是值得的,守得云开见月明。

到这里,Chromium CEF源码的编译就完成了,有问题可以给我留言评论,谢谢。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 155,457评论 4 357
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 65,943评论 1 285
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 105,327评论 0 236
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,307评论 0 201
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,630评论 3 283
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,114评论 1 202
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,514评论 2 305
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,227评论 0 193
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,859评论 1 234
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,186评论 2 238
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,741评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,087评论 2 248
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,614评论 3 228
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,926评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,630评论 0 190
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,117评论 2 261
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,076评论 2 257

推荐阅读更多精彩内容