本文以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