Win10 编译ChromeDriver源码

本文主要参考Google官方文档，打不开的话请翻墙。

一、安装VS

1.1 官方要求的VS是2017或以上，最好是VS2019，我装的2019

1.2 有些组件是必须安装的，比如“MFC/ATL support”， “Windows 10 SDK” 10.0.19041或以上版本 

1.3 SDK Debugging Tools必须安装，否则后面执行命令会报错。

      如果你的Windows 10 SDK 是通过Visual Studio installer 安装的，那你可以通过下面方法安装：

Apps&features → 找到 “Windows Software Development Kit” → Modify→ Change → 选中 “Debugging Tools For Windows” → Change.

或者你可以下载SDK installer来安装SDK Debugging Tools.

二、安装depot_tools

2.1 下载

2.2 将下载的zip文件解压到一个目录，比如D:\software\Depot-tool\depot_tools\，将其加到系统变量Path

      注意将其放到Path的最前面，因为有要求这个工具要在Python和Git的安装路径前面。

2.3 增加系统变量DEPOT_TOOLS_WIN_TOOLCHAIN，设置值为0

2.4 增加系统变量vs2019_install，值如C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional

2.5 打开Command Prompt，运行命令glient, 会安装一些需要的软件，比如 msysgit和python

     注意不要用PowerShell等其他命令行，因为可能会有一些软件安装不成功。

2.6 检查python，运行命令where python，确保 python.bat 出现在python.exe的路径前面。

三、获取代码

3.1 配置git如下，在命令行里执行

$ git config --global user.name "My Name"
$ git config --global user.email "my-name@chromium.org"
$ git config --global core.autocrlf false
$ git config --global core.filemode false
$ git config --global branch.autosetuprebase always

3.2 在你想要的位置创建一个目录来存放代码，比如chromium

$ mkdir chromium && cd chromium 
$ fetch chromium
如果不需要所有历史代码可以fetch的时候加参数--no-history。
下载需要比较长的时间，请耐心等待。
最终下载完成后，可以看到有个.gclient文件和src文件夹。
切进src目录, 后续命令都在这个目录执行
$ cd src

四、编译代码

4.1 在src目录执行下面命令生成Default目录，gn命令的参数可以参考链接

   $ gn gen out/Default

      默认为debug, release请加参数 --args="is_debug = false"。

4.2 编译，可能需要几个小时，有5w多文件，最终Default目录生成chrome.exe

  $ autoninja -C out\Default chrome

4.3 文中提到了设置一些变量来提高编译速度，不知道有什么影响，没有试

五、安装 VS拓展工具 VsChromium

5.1 下载最新版本

5.2 双击VSIX，安装，选中VS2019的插件

5.3 安装完成后，打开VS2019，菜单Extensions->Manage Extensions->Installed里可以找到VsChromium

六、VS2019创建工程

6.1 用VS2019当作个项目打开目录Default里的 chrome.exe，关闭VS，生成chrome.sln

6.2 在Default目录创建vs-chromium-project.txt，将下面的内容copy进去，保存

[SearchableFiles.include]
*

6.3 再次打开chrome.sln，VS2019会把所有相关文件load进项目工程

注意每次load会比较慢，必要时可将VsChromium disable.