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

你可能感兴趣的:(WebRTC本地C++开发基础)