WebRTC（十四）：WebRTC源码编译与管理
编译环境
ubuntu20.04
安装编译依赖
sudo apt-get update
sudo apt-get install -y git python2.7 python3 pkg-config g++ libnss3-dev libnspr4-dev libssl-dev libasound2-dev
depot_tools
Git 工具链封装器：统一管理源码拉取、分支切换、依赖同步。
包含核心命令：
fetch：拉取项目（WebRTC、Chromium 等）gclient：管理项目依赖（通过.gclient文件）gn：生成构建文件（构建系统生成器）ninja：编译器（Google 优化版 Make 替代）- 还有：
git-cl,git-cache,roll-dep,presubmit, 等
cd /home/webrtc/depot_toolsgit clone https://chromium.googlesource.com/chromium/tools/depot_tools.git# 配置depot_tools路径至环境变量
vim ~/.bashrc# 最后一行添加,保存wq!
export PATH="$PATH:/home/webrtc/depot_tools/depot_tools"# 执行
source ~/.bashrc
WebRTC源码下载
cd /home/webrtc/mkdir src
cd src# 拉取代码
fetch --nohooks webrtc# 同步依赖（包括第三方依赖、build 工具、工具链等）
gclient sync
配置构建选项
cd src./build/install-build-deps.sh
gn gen out/Default
源码编译
ninja -C out/Default
编译成功后，进入out/Default目录，即可查看编译结果。
编译参数总结
| 参数名 | 说明 | 示例值 |
|---|---|---|
is_debug | 是否为 Debug 构建 | true / false |
rtc_include_tests | 是否编译测试代码 | false（生产时建议关闭） |
rtc_use_h264 | 启用 H264 支持 | true（需额外引入 openh264/ffmpeg） |
rtc_enable_protobuf | 启用 protobuf 支持（部分 API 需要） | true |
is_component_build | 是否使用组件构建（生成多个动态库） | false（一般推荐 false） |
use_rtti | 启用 RTTI（运行时类型识别） | true（如你需要 C++ RTTI） |
use_custom_libcxx | 使用自定义 libc++（通常用于 macOS/iOS） | false |
target_cpu | 架构目标 | "x64"、"arm"、"arm64" |
target_os | 目标操作系统 | "linux"、"win"、"android"、"ios" |
rtc_include_builtin_audio_codecs | 是否包含内置音频编解码器 | true（如需 Opus） |
rtc_include_builtin_video_codecs | 是否包含内置视频编解码器 | true（如需 VP8/VP9） |
rtc_build_examples | 是否编译 examples（如 peerconnection_client） | false |
rtc_build_tools | 是否构建调试工具 | false |
rtc_build_libevent | 使用 libevent（少见） | false |
示例
gn gen out/Default --args='
is_debug=false
rtc_include_tests=false
rtc_use_h264=true
rtc_include_builtin_audio_codecs=true
rtc_include_builtin_video_codecs=true
rtc_build_examples=false
target_cpu="x64"
target_os="linux"
use_rtti=true
'
WebRTC源码管理
选择特定版本（稳定/旧版本）
WebRTC 的源码不使用传统 tag，而是依赖 branch-heads 或 commit。
查看分支：
git ls-remote origin refs/branch-heads/*
切换到指定分支（例如 M114）：
git checkout branch-heads/5912
gclient sync
同步代码（已有代码更新/拉取）
在 src/ 目录执行：
gclient sync
可加速或精细控制：
gclient sync --nohooks --no-history --shallow
参数说明：
--nohooks: 不执行钩子脚本（如下载工具链）--shallow: 浅拉取，提高速度--no-history: 不拉 commit 历史，节省空间
更新源码至最新版本
cd src
git checkout main
git pull
gclient sync
如果使用的是某个分支（非 main），先确认当前分支是否有更新。
重新运行 hooks（必要时）
如果 DEPS 文件有改动，或者构建工具（如 Clang）需要重新安装：
gclient runhooks
.gclient 文件说明（位于 webrtc-checkout/）
这是 depot_tools 管理的依赖列表，类似 mono-repo 的 manifest：
solutions = [{"managed": False,"name": "src","url": "https://webrtc.googlesource.com/src.git","deps_file": "DEPS","custom_deps": {},"custom_vars": {},},
]
使用 Python3（推荐）
目前 WebRTC 的 gclient 支持 Python3：
sudo apt install python3 python3-pip
export DEPOT_TOOLS_UPDATE=0
确保 depot_tools 使用的是系统的 Python3。
依赖 DEPS 管理机制简述
WebRTC 使用 DEPS 文件定义 Git 子模块依赖：
- 所有依赖以 Git commit pin 定
- 更新某个依赖需修改
DEPS文件中的 hash - 可以本地替换模块（用于 patch）
例如：
vars = {'chromium_git': 'https://chromium.googlesource.com',
}deps = {'src/third_party/libvpx': Var('chromium_git') + '/webm/libvpx.git@<commit_hash>',
}