WebRTC本地C++开发基础

本文以Linux/Mac平台为例，简单归纳总结WebRTC本地C++开发的基本步骤。

1. 先决条件

Google使用一个脚本工具集depot_tools进行代码检出、下载管理、代码审查、代码提交等日常开发工作[1]。该工具集中的常用工具包括gclient，gcl，git-cl，repo等等。在Linux/Mac平台上安装depot_tools工具集非常简单[2]：下载源代码并添加到PATH中即可：

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH=`pwd`/depot_tools:"$PATH"

需要注意的是，我们要把depot_tools放在PATH的最前端，否则gcl命令会指向GNU Common Lisp编译器。另外，export这一句最好添加到.bashrc中，这样就不必每次都设置。

对于Ubuntu/Debian系统，除安装depot_tools工具集，还有另外一项先决条件：在获取WebRTC源代码后，需要运行源代码中的install-build-deps.sh脚本安装一系列依赖软件：

./build/install-build-deps.sh

对于Mac，只需要xcode版本大于5即可，推荐使用最新的xcode。

2. 获取WebRTC源代码

2.1 下载WebRTC源码

mkdir webrtc-checkout
cd webrtc-checkout
fetch --nohooks webrtc
gclient sync

WebRTC源码的代码量很大(PC平台大概6.4GB)，因为需要使用Chromium的编译工具链和第三方依赖库。整个下载过程尤其是gclient sync需要耐心等待。

2.2 配置及创建分支

假设我们在master分支上进行开发。首先我们需要针对分支作一些配置，包括如何合并远程分支，是否需要自动rebase，等等[3]：

git config branch.autosetupmerge always      // 自动合并远程分支到本地分支。
git config branch.autosetuprebase always     // git pull时自动rebase。

并创建本地master分支：

cd src
git checkout –b master origin/master

2.3 更新代码

更新当前分支：

git pull origin master

更新编译工具链和第三方依赖库：

gclient sync

3. 编译WebRTC

Ninja是WebRTC的默认跨平台编译系统[4]，其构建文件通过GN生成[5]。Ninja构建文件默认生成在out/Release、out/Debug目录下，当然这个目录是可以指定的。在src目录下执行如下命令，可生成Debug版构建文件:

gn gen out/Default

生成Release版构建文件：

gn gen out/Release --args=”is_debug=false”

清理Ninja构建文件：

gn clean out/Default
gn clean out/Release

编译WebRTC源代码：

ninja –C out/Default

共3500多个源文件，编译时长视机器的性能而定，从几分钟到几十分钟不等。gn也支持使用其他IDE构建系统，例如在Mac上用xcode生成工程文件：

gn gen out/Default --ide=xcode

就会在out/Default下生成all.xcworkspace工程文件，用xcode打开即可进行编译。

4. 在Release分支开发

查看当前已发布的所有Release分支：

gclient sync --with_branch_heads
git fetch origin
git branch –r

检出branch 60分支进行开发：

git checkout –b branch_60 refs/remotes/branch-heads/60
gclient sync

5. 总结

本文对WebRTC的本地C++开发进行总结，是一个操作手册。

参考文献

[1] Using depot_tools:
http://dev.chromium.org/developers/how-tos/depottools
[2] Install depot_tools:
http://dev.chromium.org/developers/how-tos/install-depot-tools
[3] WebRTC Development: https://webrtc.org/native-code/development/
[4] Ninja: https://ninja-build.org/
[5] What is GN?
https://chromium.googlesource.com/chromium/src/+/master/tools/gn/README.md