1. 准备起步
-
操作系统：windows 10
-
安装 vs2019/vs2022
-
安装 win10 sdk 19041 一定勾选 Debugging Tools for Windows
-
科学上网准备代理工具
-
磁盘剩余空间至少 30G
推荐用一台干净的机器或者虚拟机来编译WebRTC，安装过python的会出现一些非常棘手的问题，安装depot_tools会安装python，把原来机子上的python删掉最好。
1.1 安装Visual Studio 2022
-
VS2022可以从这里下载
-
其对应的Win 10 SDK版本为10.0.20348.0，你可以从这里下载
安装visual studio社区版即可，安装VS2012时选择自定义安装，必须勾选如下几项：
-
Desktop development with C++组件中10.0.22621.0或以上的Win11 SDK（如果没看到该版本，去左侧Individual components那里勾选）
-
Desktop development with C++组件中MFC以及ATL这两项
使用下面指令启动下载器：
vs_Community.exe --add Microsoft.VisualStudio.Workload.NativeDesktop --add Microsoft.VisualStudio.Component.VC.ATLMFC --includeRecommendedVS配置如下图
注意：ATL和MFC一定要安装，否则后面使用ninja编译的时候，就会报错。
4. 安装VS2022以后，把VS的安装路径设置到环境变量PATH里面
set vs2022_install=C:\Program Files\Microsoft Visual Studio\2022\Professional1.2 安装配置Win10 SDK
webrtc最新代码要求适用于 Windows 11版本22H2的Windows SDK (10.0.22621)
1.2.1 通过vs2022安装
在控制面板-程序-程序和功能-单个组件，找到 Windows SDK (10.0.22621)
通过vs2022安装的win10 SDK, 还需要安装 安装SDK调试工具，
打开控制面板->程序与功能，找到刚才安装的最新Windows Software Development Kit，鼠标右键->change
勾选Debugging Tools For Windows，然后点击change
1.2.2 通过win10 SDK下载器安装
可以在下面链接选择Windows SDK的安装程序，进行下载安装：https://developer.microsoft.com/zh-cn/windows/downloads/sdk-archive/
比如我这里安装到了D:\Windows Kits\10
然后设置 WINDOWSSDKDIR环境变量
set WINDOWSSDKDIR=D:\Windows Kits\101.3 配置GIT代理和系统代理
需要搭建梯子进行科学上网，
下面配置脚本中的7890端口，是某机场进行科学上网的代理端口.
#1.设置Git的代理 git bash里执行：全局方法
git config --global http.proxy 127.0.0.1:7890
git config --global https.proxy 127.0.0.1:7890
git config --global core.gitproxy 127.0.0.1:7890# 设置系统代理 cmd命令行执行：如果是VPN，就不用这样设置了
set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890 //（不是 https）是关键!!!# 添加系统环境变量 DEPOT_TOOLS_WIN_TOOLCHAIN=0
set DEPOT_TOOLS_WIN_TOOLCHAIN = 0
设置当前cmd窗口代理上网，如果cmd窗口关闭了重开得重新设置。
编译完webrtc之后，记得要取消git的代理
1.4 安装deppot_tools
1.4.1 下载Depot Tools
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git1.4.2 配置depot_tools 环境变量
C:\webrtc\depot_tools #一定放到第一行将depot_tools目录添加到环境变量，并且配置DEPOTTOOLSWIN_TOOLCHAIN为0，
这个变量配置后gclient sync会下载buildtools。
配置完成最好重启一下电脑，让环境变量生效。
1.4.3 安装Windows下所需的工具
管理员权限打开cmd，cd到depot_tools目录，然后输入gclien 运行gclient命令， 在第一次运行时，gclient 将安装编译所需的所有windows 特定工具，包括 msysgit 和 python等。
如果中间由于网络原因失败的话，多试几次，如果出现：
WARNING: Your metrics.cfg file was invalid or nonexistent. A new one will be created.
这时候就表示ok了
2. 源码编译
2.1 获取webrtc源码
在2020-01-15的时候，也就是从webrtc M80版本开始，webrtc代码中的分支名称从M80改成了分支号(80是Chromium版本, 分支号是一个单调递增的Chromium分支号码，例如M80对应3987)
最新版本号与代码分支对应关系：
https://chromiumdash.appspot.com/branches
120 m120 WebRTC 6099
webrtc / src.git / refs/branch-heads/6099
2.2 指定VS版本
有时我们需要使用老版本的VS 编译旧版本的WebRTC源码，此时除了需要在Windows上安装老版本VS外，还需要设置如下环境变量，这样WebRTC才会使用老的VS版本。
set GYP_MSVS_VERSION=2017set GYP_MSVS_OVERRIDE_PATH=D:\Program Files\Microsoft Visual Studio\2017\Community
webrtc代码 下载完成之后，可以通过查看vs_toolchain.py文件, 看是否支持新版本msvc。
E:\webrtc\checkout\src\build\vs_toolchain.py
MSVS_VERSIONS = collections.OrderedDict([('2022', '17.0'), # Default and packaged version of Visual Studio.('2019', '16.0'),('2017', '15.0'),
])
若支持，直接配置GYP_MSVS_VERSION系统变量就好。
完成以上步骤之后，我们开始拉取代码。先创建一个文件夹，再执行fetch命令：
mkdir checkout
cd checkout
fetch --nohooks webrtc 下载.gclient的源码下载配置文件， gclient是webrtc的源码管理工具
gclient sync # 主要是根据DEPS文件下载第三方库
gclient sync -f如果因为网络等原因中断了，再次执行gclient sync
2.3 生成VS工程
WebRTC默认使用Ninja作为编译系统，Ninja工程文件通过GN生成，由于我们需要使用VS进行代码编辑调试等，所以使用GN生成Ninja工程时需要配置--ide=vs生成VS的工程文件。通过如下命令生成工程文件（Debug编译，工程文件位于out\Default目录下）：
编译之前再次检查一下相关环境变量：
//我的环境配置
set GYP_MSVS_VERSION=2022
set DEPOT_TOOLS_UPDATE=0
set DEPOT_TOOLS_WIN_TOOLCHAIN=0
set vs2022_install=D:\Program Files\Microsoft Visual Studio\2022\Community
set GYP_MSVS_OVERRIDE_PATH=D:\Program Files\Microsoft Visual Studio\2022\Community
set GYP_GENERATORS=msvs-ninja,ninja 进入src目录
cd d:\webrtc\src
生成32位debug
gn gen output/Debug --ide=vs2022 --sln=mywebrtc --args="use_lld=false is_debug=true rtc_use_h264=true is_component_build=true target_cpu=\"x86\" enable_nacl=false" >>build.log
生成64位debug
gn gen output/Debug --ide=vs2022 --sln=mywebrtc --args="use_lld=false is_debug=true rtc_use_h264=true target_cpu=\"x64\"">> build.log
我们可以在src\out\Debug目录下得到 VS2022的mywebrtc.sln解决方案文件。
如果要生成release的 设置is_debug=false
上述 gn 中的几个参数含义如下（可以查看源码中的gn文件了解细节）：
-
–target，顾名思义，生成x64版本的WebRTC库
-
–ide，生成VS工程文件
-
–args，编译时的一些配置参数
-
-
is_debug，为true编译出Debug版本；为false编译出Release版本
-
rtc_enable_protobuf，是否使用protobuf，使用可将其设置为true
-
use_custom_libcxx，WebRTC默认使用的是libc++库，而我们在Windows上使用的是libstdc++库，所以需要将其设置为false
-
symbol_level，编译出的WebRTC库是否带符号表，这个数据量很大，会影响运行速度，所以一般设置为0，表示编译出的WebRTC不带符号表
-
rtc_include_tests，编译WebRTC时是否编译测试用例，如果为false则不编译，这样可以大大加快WebRTC的编译速度
-
执行上面的命令时，会花一些时间，因此我们需要让子弹飞一会儿……
2.4 编译
生成工程文件后，就可以在src目录下执行编译命令：
ninja -C output/Debug -j 8就生成webrtc的库文件。
然后进入 out\Debug 目录，打开 mywebrtc.sln 就是可以调试的vs2022 webrtc 工程。
VS中引入并使用WebRTC库 : https://blog.avdancedu.com/fcd68433/
3 清理及善后
取消G代理
# 还原代理
git config --global --unset http.proxy
git config --global --unset https.proxy
git config --global --unset core.gitproxy# 系统还原
set HTTP_PROXY=
set HTTPS_PROXY=以上是windows系统上使用vs2022编译webrtc源码的全部内容。
本系列下一章节，我们将使用本节生成的vs2022工程，来断点调试webrtc源码，解决相关bug, 并跑通example/peerconnection相关demo。
参考资料
[1] https://blog.jianchihu.net/windows-webrtc-build.html
[2] https://blog.avdancedu.com/2bafd6cf/
点击下方并微信扫描二维码关注【音视频开发训练营】
