chromium windows compile 浏览器编译 vs2017 win10

https://blog.csdn.net/longji/article/details/80967225

01 阅读官方文档

https://chromium.googlesource.com/chromium/src/+/master/docs/windows_build_instructions.md

一个中文翻译文档：https://blog.csdn.net/Vincent95/article/details/78469807

02 安装python2.7.*

depot_tools需要使用python2.7。

https://www.python.org/ftp/python/2.7.15/python-2.7.15.amd64.msi

03 配置 depot_tools

下载depot_tools,加压到d:\git\chromium\depot_tools,并把d:\git\chromium\depot_tools加入环境变量。

https://storage.googleapis.com/chrome-infra/depot_tools.zip

把depot_tools的路径加到 PATH 环境变量的最前面，至少要加到python环境变量的前面

04 配置必要的信息

设置git全局配置信息

# user.name 和 user.email 需要使用自己的。

git config --global user.name "5455945"

git config --global user.email "[email protected]"

git config --global core.autocrlf false

git config --global core.filemode false

git config --global branch.autosetuprebase always

# 这个可以在系统环境变量里面设置，也可以在命令行窗口设置

set GYP_MSVS_VERSION=2017

set DEPOT_TOOLS_WIN_TOOLCHAIN=0

set GYP_MSVS_OVERRIDE_PATH="D:\install\Microsoft Visual Studio\2017\Community"

05 下载代码

参考:https://chromium.googlesource.com/chromium/src/+/master/docs/windows_build_instructions.md#Using-the-Visual-Studio-IDE

fetch chromium

# 不下载历史版本信息，速度较快，后续切换分支时略慢

fetch chromium --no-history

# 如果下载失败

gclient sync --nohooks --with_branch_heads --with_tags --output-json="log.json"

gclient runhooks # 或者 gclient runhooks --force

# 上面成功后，

cd src

git fetch --all

git fetch --tags

git pull

# 到此为止，是master的最新代码

06 切换到相对稳定分支

参考：

https://omahaproxy.appspot.com/

http://www.chromium.org/developers/how-tos/get-the-code/working-with-release-branches

cd src # 在src目录

# 创建新的分支b3440

git checkout -b b3440 branch-heads/3440

# 也可以考虑直接使用tag。比如:git checkout -b b3440 68.0.3440.54

cd .. # zai src的上一级目录(chromium目录)

gclient sync --with_branch_heads --with_tags

07 build时的设置参数

target_cpu=“x86”：指明生成的针对X86架构的CPU。

is_debug=false：指明生成的是Release版本可执行程序。

is_official_build=true：指明使用Chrome官方的编译优化建议。

proprietary_codecs：指明支持H264编码，编译时，自动H264相关组件，打包PE文件中。

enable_nacl=false：指明关闭支持NACL，这是一种Chrome插件，因为安全性，稳定性存在问题，已经很少使用了。

remove_webcore_debug_symbols=true：指明删除内核层支持调试的符号文件，这样，有助于减少文件体积，提高运行速度。

查看gn args 所有可用参数

gn 说明 https://www.chromium.org/developers/gn-build-configuration

:: 很重要的参考资料

gn args --list out\Debug

::去掉显示头文件的包含树

::修改src\build\toolchain\win\BUILD.gn，将/showIncludes删除掉

使用 --filters=//chrome , 会过滤掉一些工程，比如：setup，mini_installer 两个工程，在设置 --filters=//chrome 支持ninja编译，不会生成vs2017的工程。

所以是否使用 --filters=chrome，还需要根据自己的实际需要斟酌。

gn gen out/Debug --ide=vs2017 --filters=//chrome --args="target_os=\"win\" target_cpu=\"x86\" is_component_build=true is_debug=true is_official_build=false google_api_key=false google_default_client_id=false google_default_client_secret=false proprietary_codecs=true media_use_ffmpeg=true ffmpeg_branding=\"Chrome\" remove_webcore_debug_symbols=true enable_nacl=false enable_hevc_demuxing=true enable_dolby_vision_demuxing=true enable_mse_mpeg2ts_stream_parser=true enable_hls_sample_aes=true enable_ac3_eac3_audio_demuxing=true"

ninja -C out\Debug chrome setup mini_installer

:: 35025文件

gn gen out/Release --ide=vs2017 --filters=//chrome --args="target_os=\"win\" target_cpu=\"x86\" is_component_build=false is_debug=false is_official_build=true google_api_key=false google_default_client_id=false google_default_client_secret=false proprietary_codecs=true media_use_ffmpeg=true ffmpeg_branding=\"Chrome\" remove_webcore_debug_symbols=true enable_nacl=false enable_hevc_demuxing=true enable_dolby_vision_demuxing=true enable_mse_mpeg2ts_stream_parser=true enable_hls_sample_aes=true enable_ac3_eac3_audio_demuxing=true"

ninja -C out\Release chrome

ninja -C out\Release mini_installer

gn gen out/DebugX64 --ide=vs2017 --filters=//chrome --args="target_os=\"win\" target_cpu=\"x64\" is_component_build=true is_debug=true is_official_build=false google_api_key=false google_default_client_id=false google_default_client_secret=false proprietary_codecs=true media_use_ffmpeg=true ffmpeg_branding=\"Chrome\" remove_webcore_debug_symbols=true enable_nacl=false enable_hevc_demuxing=true enable_dolby_vision_demuxing=true enable_mse_mpeg2ts_stream_parser=true enable_hls_sample_aes=true enable_ac3_eac3_audio_demuxing=true"

ninja -C out\DebugX64 chrome

:: is_component_build=false 和 is_official_build=true 不能同时为true

gn gen out/ReleaseX64 --ide=vs2017 --filters=//chrome --args="target_os=\"win\" target_cpu=\"x64\" is_component_build=false is_debug=false is_official_build=true google_api_key=false google_default_client_id=false google_default_client_secret=false proprietary_codecs=true media_use_ffmpeg=true ffmpeg_branding=\"Chrome\" remove_webcore_debug_symbols=true enable_nacl=false enable_hevc_demuxing=true enable_dolby_vision_demuxing=true enable_mse_mpeg2ts_stream_parser=true enable_hls_sample_aes=true enable_ac3_eac3_audio_demuxing=true"

ninja -C out\ReleaseX64 chrome

:: 生成安装包

ninja -C out\ReleaseX64 mini_installer

ninja -C out\ReleaseX64 setup

:: 34416文件

:: 关掉clang选项 is_clang=false，需要停用掉vs的头文件警告，修改src\build\toolchain\win\BUILD.gn，将/showIncludes删除掉

:: 指定winsdk版本。如果本机按照多个版本的sdk，可以明确指定使用sdk的版本，目前官网说明使用10.0.17134

:: 注意，winsdk版本号不要加引号

gn gen out/DebugX64 --ide=vs2017 --filters=//chrome --args="target_os=\"win\" target_cpu=\"x64\" --winsdk=10.0.17134.12 is_component_build=true is_debug=true is_official_build=false google_api_key=false google_default_client_id=false google_default_client_secret=false proprietary_codecs=true media_use_ffmpeg=true ffmpeg_branding=\"Chrome\" remove_webcore_debug_symbols=true enable_nacl=false enable_hevc_demuxing=true enable_dolby_vision_demuxing=true enable_mse_mpeg2ts_stream_parser=true enable_hls_sample_aes=true enable_ac3_eac3_audio_demuxing=true"

:: 使用eclipse调试，指定ide=eclipse，使用 Eclipse IDE for C/C++ Developers x64版本

:: https://www.eclipse.org/downloads/packages/

:: https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2018-09/R/eclipse-cpp-2018-09-win32-x86_64.zip

gn gen out/eclipse --ide=eclipse --winsdk=10.0.17134.12 --filters=//chrome --args="target_os=\"win\" target_cpu=\"x64\" is_component_build=true is_debug=true is_official_build=false google_api_key=\"zdx-client-oauth-id\" google_default_client_id=\"761449048278-g5uovi72654mi09043umi634r03ms6h7.apps.googleusercontent.com\" google_default_client_secret=\"MPf1fXdwyTp9218HABi1fzyx\" proprietary_codecs=true media_use_ffmpeg=true ffmpeg_branding=\"Chrome\" remove_webcore_debug_symbols=true enable_nacl=false enable_hevc_demuxing=true enable_dolby_vision_demuxing=true enable_mse_mpeg2ts_stream_parser=true enable_hls_sample_aes=true enable_ac3_eac3_audio_demuxing=true"

chromium能够支持的html5选项，可以参考： http://html5test.com/

*在gclient sync的时候遇到了错误，根据提示手动修改了 .py文件。

后来编译的时候又出现错误。卸载了windows wdk，编译正常通过

Chrome浏览器内置功能指令

https://wiki.deepin.io/mediawiki/index.php?title=Chrome浏览器内置功能指令

08 设置远程分支与本地分支对应关系

建立对应远程分支的本地分支,比如：建立对应68的正式发布版本的本地分支，68.0.3440.54，分支为b3440。

git checkout -b b3440 remotes/branch-heads/3440

建立本地分支与远程分支的对应关系，远程分支变化，切换到本地分支时，能够直接观察的到，或者使用 git fetch --all时，能够拉到对应分支的变更内容

# git branch --set-upstream-to=远程分支名词本地分支名称

git branch --set-upstream-to=remotes/branch-heads/3440 b3440

09 查看分支对应关系

git branch -vv

10 取消远程分支对应关系

# git branch --set-unupstream-to=远程分支名词

git branch --set-unupstream-to=remotes/branch-heads/3440

11 编译生成安装包

ninja -C out/Release chrome setup mini_installer

out\Release\setup.exe --chrome --multi-install

12 几个有用的命令

# 查找当前目录下所有.gn文件是否包含 executable("chrome")

findstr /S "executable(\"chrome\")" *.gn

删除d:\path1目录及子目录下所有*.lock文件

forfiles /P "d:\path1" /S /M "*.lock" -C "cmd /c del @path"

# 清楚不用的文件

git clean -df # 注意，这个命令同时会清除git仓库下面的submodule内容，慎用!!

git reset --hard

git clean -xdf

:: 解决冲突

git rebase --continue

如果vs2017安装路径不是默认的，runhooks的时候提示的错误中含有 vs2017_install，需要自己在系统环境变量中添加一下vs2017_install环境变量。比如:我的vs2017安装在D:\install\Microsoft Visual Studio\2017\Community。需要这样设置:

set vs2017_install="D:\install\Microsoft Visual Studio\2017\Community"

13 关于google api key

如果需要使用google api key，可以在gn中指定 google api key 相关的参数。

获取密钥(ID)教程：

https://www.chromium.org/developers/how-tos/api-keys

获取密钥(ID)地址：

https://cloud.google.com/console

https://console.cloud.google.com/start

google_api_key

google_default_client_id

google_default_client_secret

也可以把这几个参数直接写在文件src\google_apis\BUILD.gn 中的

对于同一个分支的 gclient sync,我们自己修改代码前和修改代码后不会影响gclient sync的。

git checkout -b bb3578_1 branch-heads/3578

git merge b3578

gclient sync

git checkout -b bb3578_2 branch-heads/3578

14 关于branch-heads/3578问题

在编译branch-heads/3578后，debug x86版本。vs2017调试会出现崩溃现象，单独运行debug release版本都正常。只有调试的时候，出现崩溃。而且很频繁。使用vs2017的15.9.1版本不行，回退到15.8版本，也不行。一次删除扩展插件也没缓解。该问题为解决。

切换到 branch-heads/3538 稳定分支。70.0.3538.110，不修改任何代码，vs2017调试，依然崩溃。

vs2017 社区版本，15.8 14.15 toolset。

最初使用vs2017 老版本，68.0.3440.105调试时，偶尔有崩溃问题，频率不高。

后来，代码升级到branch-heads/3578，调试登陆问题，崩溃频率很高。于是升级vs2017到最新版本 15.9.1。崩溃频率更高。

于是各种更新vs2017版本。包括:更好sdk版本15.8 14.15 toolset；14.14 toolset；卸载扩展插件。

重新完整安装15.9.2版本。问题依然存在。

vs2017崩溃无提示。看vs2017报告显示内存不足，观察任务管理器或者ProcessHacker查看，调试是内存最高占用4BG左右。

调试的chromium是x86版本。

目前没找到解决办法。

15 chrome://net-internals

chrome://net-internals/#proxy

chrome://net-internals/#dns

16 插件商店下载相关的源码

显示安装窗口的部分

void DashboardPrivateShowPermissionPromptForDelegatedInstallFunction::

OnWebstoreParseSuccess

kDashboardInvalidManifestError

ExtensionInstallPrompt::GetLocalizedExtensionForDisplay

安装vs的环境要求

https://blog.csdn.net/LostSpeed/article/details/81405462

记得上次弄68版本的时候，一开始好像也遇到过上面博客说的情况。

如果发现vs编译或者调试chromium不行，那就完全卸载vs和sdk，然后用官网的安装工具安装。

————————————————

原文链接：https://blog.csdn.net/longji/article/details/80967225

chromium windows compile 浏览器编译 vs2017 win10

继续阅读

跨平台：GN实践详解（ninja, 编译, windows/mac/android实战）强烈推荐

depot_tools_tutorial(7) 下载安装

2. chromium开发工具--gclient 2. chromium开发工具--gclient

交叉编译 chromium windows linux

离线编译chromium 59.0.3071.104，方法适合任意版本

离线编译chromium 59.0.3071.104，方法适合任意版本

Chromium GN构建工具的使用 Chromium GN构建工具的使用

GN Quick Start guide