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_tools

git 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>',
}