在Windows上编译Chromium（CEF3）并加入mp3/mp4的支持

hhajhh

　　公司有一个基于谷歌浏览器内核加上公司自己做的浏览器皮肤，然后开发出具有公司特性的浏览器。随着谷歌浏览器不断的更新升级，为了能提升公司浏览器的用户体验，所以也需要定期的对公司的浏览器进行相应的更新与升级。去年（2015年）6月份自己基于公司现有的项目对公司浏览器升级为cef3.2171版本（对应于Chromium ver=39）。近一年来，谷歌浏览器升级很快，目前已经升级到53/54版本了，所以公司要求升级公司浏览器。
　　现在cef3的版本与之前差异很大，经过一番研究和实践终于升级到cef3.2785（Chromium ver=53. 备注：为什么不直接升级到54版本，原因是目前市场上最新的版本还是53版本，而54版本才刚分离出来没几天，基于稳定性考虑所以选择了53版本）。然而在测试过程中发现自己编译出来的浏览器不支持播放mp3（音频）和mp4（视频）格式的文件，这可是个大问题，因为业务需求就是需要能正常播放mp3和mp4。为了解决编译出来的浏览器能支持mp3和mp4，网上查找了很多资料，了解到为什么cef3不直接支持mp3/mp4等格式文件的原因。为方便自己以后升级公司浏览器及其他有需要的朋友，所以打算写该文档。（目的是为了解决让cef3支持mp3和mp4文件）
　　一、什么是CEF
　　CEF包括CEF1和CEF3两个版本，CEF1已停止更新，目前大家所用的都是CEF3。CEF即Chromium Embeded Framework，由谷歌的开源浏览器项目Chromium扩展而来，可方便地嵌入其它程序中以得到浏览器功能。
　　二、编译版本
　　cef版本号格式为X.YYYY.A.gHHHHHHH。X为主版本号，当前只有3；YYYY为chromium分支号；A为递增的svn提交版本号；HHHHHHH为7位git提交hash。我本人本次编译版本为：cef3.2785.1482.g16e49fb（Chromium version 53.0.2785.116）
　　三、编译条件
　　(1)快速稳定的VPN，下载chromium源码必需；
　　(2)60G磁盘空间；
　　(3)64位操作系统，Win 7+ ；
　　(4)vs2015 update2或update3；
　　(5)Windows 10.0.10586 SDK （已包含在vs2015中，安装注意选择）；
　　(6)MFC库（已包含在vs2015中，安装注意选择）。
　　其它各版本编译条件查看：https://bitbucket.org/chromiumembedded/cef/wiki/BranchesAndBuilding.md#markdown-header-current-release-branches-supported
　　备注：这个编译条件如果达不到，可能会跟我一样遇到以下问题。
　　(1)使用免费版本的vpn，结果下载过程中常出现中断导致下载不了。所以为这事，我特意购买了vpn，即使用购买的vpn我也下载了大概8个小时（下载的文件有近16G）。
　　(2)vs版本不对，导致编译过程老是出错，所以卸载了自己原来的vs2013 update5，改安装vs2015 update3
　　(3)磁盘空间不足，我腾出一个40G的磁盘来下载和编译该版本，结果出现磁盘空间不足导致编译失败，最后对电脑重新分区才腾出空间来编译该版本
　　四、准备工作
　　(1)设置系统区域为英语（美国）。（控制面板-区域-管理-更改系统区域设置-英语（美国）
　　(2)创建工作目录，路径不能包含空格及特殊字符。例如e:\cef
　　(3)下载编译工具包，解压至工作目录。
　　(4)下载编译脚本至工作目录。
　　(5)在工作目录下创建源码目录。例如e:\cef\source
　　(6)添加系统环境变量
　　　　·CEF_ARCHIVE_FORMAT=tar.bz2
　　　　·DEPOT_TOOLS_WIN_TOOLCHAIN=0
　　　　·GYP_DEFINES=buildtype=Official
　　　　·GYP_MSVS_VERSION=2015
　　　　·Path添加e:\cef\depot_tools，为避免与已安装的python或git冲突，建议写在path靠前位置



完整目录结构：
e:/
cef/
automate-git.py
depot_tools/
source/
　　五、下载与编译
　　(1)以管理员身份运行cmd，安装python、git、svn



e:
cd e:\cef\depot_tools
update_depot_tools.bat
　　(2)下载chromium源码



cd e:\cef
python automate-git.py --download-dir=e:\cef\source --depot-tools-dir=e:\cef\depot_tools --branch=2785 --checkout=16e49fb8af7aacfd8e32b232eaf1e736bb3269f1 --no-debug-build --force-build --no-update
// 以下为参数说明
--download-dir 源码下载目录
--depot-tools-dir 工具包目录
--branch 源码分支(默认trunk主分支
--checkout 指定patch版本（默认最近提交 如何确定checkout下文介绍
--no-build 下载完不自动开始编译（我们需要修改编译配置
--no-update 确定源码下载完毕仅重新编译时使用
--force-build 强制编译（发现在有成功编译的时候再编译不会执行，可以加上这个
--no-debug-build 只编译release版本
--no-release-build 只编译debug版本
　　由于下载完源码要先修改配置，所以设置为不编译。这个下载过程需要一定时间，我用购买的vpn也下载了大概8小时，下载了近16G的文件。
　　如何确认以上checkout的值，可以参考文档中的“五、如何确定--checkout值”
　　(3)修改编译配置文件
　　1> 打开e:\cef\source\chromium\src\cef\cef.gypi，variables节下添加如下即可支持mp3/mp4。



    'proprietary_codecs': 1,
'ffmpeg_branding': 'Chrome',
　　2> 同时可参考《让Chrome的HTML5 video/audio tag支持更多种音视频格式》加入更多格式支持。



从Chromium的源码third_party\ffmpeg\chromium\config\Chrome\win\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'
　　3> 修改其他错误



#解决错误：无法识别的符号_ff_w64_guid_data
#修改chromium/third_party/ffmpeg / ffmpeg_generated.gypi
#在行'libavformat/vorbiscomment.c',后加入
'libavformat/w64.c',


#解决egl语法错误
#修改h:\ws\source\chromium\src\third_party\swiftshader\include\egl\eglext.h
#在62行后加入
typedef EGLAttribKHR EGLAttrib;
　　(4)编译



python automate-git.py --download-dir=f:\cef\source --depot-tools-dir=f:\cef\depot_tools --branch=2785 --checkout=16e49fb8af7aacfd8e32b232eaf1e736bb3269f1 --no-debug-build --force-build --no-update
#最终生成输出路径
e:\cef\source\chromium\src\out\Release
e:\cef\source\chromium\src\cef\binary_distrib
　　六、测试结果
　　(1)版本号

　　(2) 对mp3/mp4的支持

　　七、封装后的浏览器

　　八、参考文档　
　　(1)https://cefbuilds.com/
　　(2)该链接竟然被和谐了
　　(3)https://github.com/cefsharp/cef-binary/wiki/Building-Cef-from-source
　　(4)http://www.cnblogs.com/honker/p/5616433.html
　　(5)https://bitbucket.org/chromiumembedded/cef