Windows上从源码编译Chromium (CEF3)
一、什么是CEF
CEF即Chromium Embeded Framework，由谷歌的开源浏览器项目Chromium扩展而来，可方便地嵌入其它程序中以得到浏览器功能。
CEF包括CEF1和CEF3两个版本，CEF1已停止更新。由于CEF只支持C、C++，所以出现了很多第三方项目来提供其它语言的支持。
.NET 的包装类库有chromiumfx、cefglue、cefsharp，其它语言参看https://bitbucket.org/chromiumembedded/cef#markdown-header-external-projects 。
CEF版本号说明：3.2357.1281.gd660177 -> CEF版本号.Branch.Patch.Hash
二、为何要编译CEF
在使用chromiumfx+cef过程中发现不支持主流的mp3、mp4格式，经过搜索发现因为这些格式不是开放格式，出于版权的考虑在chromium编译配置中去掉了对这些格式的支持。要添加支持必须修改编译的配置参数。网上流传的通过复制chrome目录下ffmpeg.dll替换的方式经过实践并没有成功，于是决定动手编译。
三、编译先决条件
1.快速稳定的VPN (不但要fq而且要稳定。下载webkit时候单个文件4G+，一旦失败则需要重新下载
2.64位操作系统，win7+
3.硬盘空间40G+，内存4G+
4.大量的时间 （下载五六个小时，编译两三个小时
5.vs2013 update4、win8.1 SDK (Express不行，update5+未测试
四、编译过程
1.升级vs13至update4，安装Microsoft Foundation Classes for C++（MFC库，可运行vs安装包安装），安装win8.1 SDK。
2.设置系统区域为英语（美国）。（控制面板-区域-管理-更改系统区域设置-英语（美国）
3.添加环境变量
DEPOT_TOOLS_WIN_TOOLCHAIN=0
GYP_GENERATORS=ninja,msvs-ninja
GYP_MSVS_VERSION=2013
4.创建工作目录，尽量简单，不带空格特殊字符。例：e:\ws
5.下载解压工具包解压至工作目录，并添加到系统环境变量Path末尾。例：e:\ws\depot_tools
下载：depot_tools （原页面
6.下载编译脚本至工作目录
7.工作目录下建立源码目录。例：e:\ws\source
8.以管理员身份运行cmd，切换至工作目录，运行gclient
1 e:2 cd e:\ws3 gclient
等待安装python和git，大约五六分钟。
9.继续执行
python automate-git.py
根据提示选择合适配置参数
--download-dir 源码下载目录
--depot-tools-dir 工具包目录
--branch 源码分支(默认trunk主分支
--checkout 指定patch版本（默认最近提交 如何确定checkout下文介绍
--no-build 下载完不自动开始编译（我们需要修改编译配置
--no-update 确定源码下载完毕仅重新编译时使用
--force-build 强制编译（发现在有成功编译的时候再编译不会执行，可以加上这个
--no-debug-build 只编译release版本
--no-release-build 只编译debug版本
python automate-git.py --download-dir=e:\ws\source --depot-tools-dir=e:\ws\depot_tools --branch=2357 --checkout=d66017718b0f0d44da42b706c3c2aa5c0c103852 --no-build
10.等待下载完成。睡上一觉，或盯着屏幕六小时。
五、如何确定--checkout值
如果确定需要分支下的最新版本，请略过此节。
1.从http://cefbuilds.com/检查目标版本的hash值。例：3.2357.1281.gd660177中的gd660177
2.从https://bitbucket.org/chromiumembedded/cef/branches/进入目标分支。例：2357
3.在Commits中检索目标hash，注意版本号中hash为8位，commits中为7位，可以忽略第一位搜索。例：gd660177->d660177
4.点击相应commit，即可在地址栏中得到checkout值。例：d66017718b0f0d44da42b706c3c2aa5c0c103852
六、修改编译配置
1.打开e:\ws\source\chromium\src\cef\cef.gypi，variables节下添加如下即可支持mp3。
'proprietary_codecs': 1, 'ffmpeg_branding': 'Chrome',
同时可参考http://blog.csdn.net/chromium_webkit/article/details/8575629加入更多格式支持。
从Chromium的源码third_party\ffmpeg\chromium\config\Chrome\linux\ia32\config.h可以得知Chrome采用的FFmpeg的配置选项，在原有的配置选项后面添加如下选项：
--enable-decoder='rv10,rv20,rv30,rv40,cook,h263,h263i,mpeg4,msmpeg4v1,msmpeg4v2,msmpeg4v3,amrnb,amrwb,ac3,flv' --enable-demuxer='rm,mpegvideo,avi,avisynth,h263,aac,amr,ac3,flv,mpegts,mpegtsraw' --enable-parser='mpegvideo,rv30,rv40,h263,mpeg4video,ac3'
2.打开相同目录下cef.gyp，根据以下内容替换（--为待替换，++为替换后，其实这是一个patch文件，不知道如何用只好手动替换一下 新版本可能已包含了此patch）
@@ -7,7 +7,7 @@ 'pkg-config': 'pkg-config', 'chromium_code': 1, 'grit_out_dir': '<(SHARED_INTERMEDIATE_DIR)/cef',- 'about_credits_file': '<(SHARED_INTERMEDIATE_DIR)/about_credits.html',+ 'cef_about_credits_file': '<(SHARED_INTERMEDIATE_DIR)/cef_about_credits.html', 'framework_name': 'Chromium Embedded Framework', 'revision': '<!(python tools/revision.py)', 'chrome_version': '<!(python ../build/util/version.py -f ../chrome/VERSION -t "@MAJOR@.@MINOR@.@BUILD@.@PATCH@")',
@@ -659,26 +659,26 @@
],
},
{- 'target_name': 'about_credits',+ 'target_name': 'cef_about_credits', 'type': 'none', 'actions': [
{ 'variables': { 'generator_path': '../tools/licenses.py',
},- 'action_name': 'generate_about_credits',+ 'action_name': 'cef_generate_about_credits', 'inputs': [
# TODO(phajdan.jr): make licenses.py print inputs too. '<(generator_path)',
], 'outputs': [- '<(about_credits_file)',+ '<(cef_about_credits_file)',
], 'hard_dependency': 1, 'action': ['python', '<(generator_path)', 'credits',- '<(about_credits_file)',+ '<(cef_about_credits_file)',
], 'message': 'Generating about:credits.',
},
@@ -689,7 +689,7 @@ 'target_name': 'cef_resources', 'type': 'none', 'dependencies': [- 'about_credits',+ 'cef_about_credits',
], 'actions': [
{
@@ -697,7 +697,7 @@ 'variables': { 'grit_grd_file': 'libcef/resources/cef_resources.grd', 'grit_additional_defines': [- '-E', 'about_credits_file=<(about_credits_file)',+ '-E', 'about_credits_file=<(cef_about_credits_file)',
],
}, 'includes': [ '../build/grit_action.gypi' ],七、开始编译生成
python automate-git.py --download-dir=e:\ws\source --depot-tools-dir=e:\ws\depot_tools --branch=2357 --checkout=d66017718b0f0d44da42b706c3c2aa5c0c103852 --no-debug-build --force-build
等待两三个小时即可编译完成，偶然出错退出则加入--no-update重新执行，会继续上次的生成。
八、参考资料
https://bitbucket.org/chromiumfx/chromiumfx/overview
https://bitbucket.org/chromiumembedded/cef/wiki/BranchesAndBuilding.md#markdown-header-automated-method
https://github.com/cefsharp/cef-binary/wiki/Building-Cef-from-source
http://cefbuilds.com/
http://blog.csdn.net/chromium_webkit/article/details/8575629
