-- Ubuntu 下编译 WebRTC

Ubuntu 下编译 WebRTC

一、Ubuntu 系统环境准备

1、安装双系统 Windows 10 / Ubuntu 16.04

最近几年一直在使用 ThinkPad 笔记本（自己之前自己买的 ThinkPad X230），现在公司给配的 ThinkPad X1，已经好久不安装双系统了（Windows & Ubuntu，一直以 VMware 虚拟机代替），目前根据公司任务，有时需要从事 Windows 开发，有时也要从事 Android 底层 native 的开发，同事们都是使用 MAC 进行 Android 进行开发，唯独我自己使用 Windows 系统，经常出现协同开发时遇到一些系统级的坑，如 Android.mk 文件中源码文件路径过长， 编译脚本下载到 Windows 下自动转换为 Windows 格式，导致脚本不能执行，git 过滤文件格式 .ignore 不生效等问题；让我慢慢下定决心转到 Ubuntu 下进行发开发 Android。最近公司决定基于 webrtc 进行二次开发，为了方便快速的将 webrtc 源码进行下载和编译，决定首先在 Ubuntu 下进行编译。
公司配的 X1 磁盘空间剩余不多，决定使用 X230 分配出200个 G 进行安装 Windows 10 / Ubuntu 双系统，安装过程中也遇到了一些新的问题（主要是由于 X230 双磁盘，固态硬盘 & 机械硬盘，安装成功后总是不能引导 Ubuntu 启动），最终搞了将近 3 个小时才搞明白，其实安装很简单，步骤如下： a、Windows 下使用 UltraISO 刻录 Ubuntu 系统镜像 ubuntu 建议下载 64bit 的，目前电脑内存都是大于 4G 的，如果装了 32 bit，那么大的内存就太浪费了； b、安装 Ubuntu 时 系统引导盘选择整个的 机械硬盘，即 Ubuntu 系统安装所在磁盘 本人 Windows 10 安装在了 SSD 固态硬盘上，而 Ubuntu 安装在了 500G 的机械硬盘上，如果需要启动 Ubuntu 系统，需要在电脑启动时，按 F12 选择系统引导磁盘，默认还是固态硬盘，如要启动 Ubuntu，就选择机械硬盘，既可（也可以在 bois 表中，配置 BOOT 启动项顺序，调整此次启动磁盘）。 c、准备 Ubuntu 的环境

• 搞定 VPN，可翻墙快速访问 Google 服务器（搞不定，就结束吧）
• 安装 gcc、g++
• 安装 git
• 安装完整版的 vim，Ubuntu 默认是阉割版的 VI ，安装完成后，执行 alias vi=vim
• 安装 ssh （可选，方便远程连接，如果不想不断的操作两个电脑的话）
• 安装 nethogs，可用于按照进行查看网络流量信息（可选）
• 安装 iptraf，可用于按照 连接/端口查看网络流量信息（用起来相对 nethogs 复杂些，可选）
• 最好安装中文输入法（系统使用 English，但如果打算长期使用 Ubuntu 开发的话，中文输入法还是必不可少的。

以上选项网上搜索均可搞定；

二、下载 WebRTC 源码及依赖工具

1、下载 depot_tools 并配置

Google 使用 depot_tools 工具（脚本组合）进行代码的同步、下载管理等，这个脚本包中包含了 gclient、gcl、git-cl，repo 等； 在 Linux 下需首先确认 git 和 Python 已经安装，并且 git version >= 2.2.1， Python version = 2.7（版本过高会报错）；
选择一个目录，如 ~/OpenSource 通过 git 获取 depot_tools ，执行如下命令既可： git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git 最后将 depot_tools 目录添加到环境变量 PATH 中，建议添加到 ~/.bashrc 中，或者 /etc/profile 文件中，可以一劳永逸，打开以上中的任意一个文件，如 sudo vi ~/.bashrc 在最后添加一行： export PATH=~/OpenSource/depot_tools:"$PATH" 执行命令，使环境变量生效： source ~/.bashrc 可通过 echo $PATH 确认配置成功: /home/gobert/OpenSource/depot_tools:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin 执行以下命令，安装并配置 depot_tools 依赖： gclient sync 需要等待一段时间，具体看你的 VPN 网速如何了。

三、下载并编译 WebRTC

1、下载 WebRTC 源码

• 选择一个下载目录，依次执行以下命令：

mkdir webrtc-checkout cd webrtc-checkout fetch --nohooks webrtc gclient sync 经过漫长的等待， webrtc 全部下载到本地的话，大约会占用 6.4 G 的磁盘空间；

• 可选项：指定如何跟踪处理新的分支 git config branch.autosetupmerge always git config branch.autosetuprebase always git config branch.autosetupmerge always 表示 自动从远程分支合并提交到本地分支，如果不做此设置，你需要手动 merge； git config branch.autosetuprebase always 设置在执行 git pull 命令时做 rebase 而不是是 merge；可选的值还有 never：不自动 rebase， local 跟踪本地分支进行 rebase， remote 跟踪远程分支进行 rebase， always 所有跟踪的分支都自动进行 rebase； ​
• 可选项：创建一个新的本地分支 cd src git checkout master git new-branch your-branch-name 建议创建下新的本地开发分支，如： git new-branch dev ​
• 编译前更新下最新代码 git pull 注：如果在上一步中，没有创建新的分支，则使用 git fetch 命令代替，以获取最新代码。 ​

注：由于WebRTC 目前还在频繁的更新中，建议定期的去下载更新下编译工具链及其依赖，通过执行
gclient sync 既可!

2、编译

WebRTC 目前使用 GN 来生成构建脚本，Ninja 进行构建，所以系统平台均是。

• 生成 Ninja 工程文件 Ninja 工程文件由 GN 生成，为其选择一个放置的目录中，如 out/Debug 或者 out/Release，这里官方建议选择 out/Default 这样可以放置 debug 和 release，在 src 目录下还行一下命令，默认生成 debug 版本的构建文件： gn gen out/Default 如果 提示 gn 命令 not found，需检查 depot_tools 环境变量设置是否生效。 执行以下命令生成 Ninja 工程文件 gn gen out/Default 如果需要生成 release 工程文件，需在后面加上关闭 debug 的参数 --args=is_debug= false 如果需要清理 Ninja 工程文件，但保持 GN 环境配置不变的话，可以执行以下命令： gn clean out/Default
• Ninja 编译 ninja -C out/Default 总共有 3600 多个文件需要一一编译，编译成功后，会在 out/Default 目录下生成大量的可执行测试程序： activity_metric g722_test neteq_opus_quality_test rtc_event_log2rtp_dump toolchain.ninja args.gn gen neteq_pcmu_quality_test rtc_media_unittests tools_unittests audio_codec_speed_tests genmacro neteq_rtpplay rtc_pc_unittests transient_suppression_test audio_decoder_unittests genmodule neteq_speed_test rtc_stats_unittests turnserver audio_device_tests genperf nonlinear_beamformer_test rtc_unittests unpack_aecdump audioproc_f genstring obj rtp_analyze video_capture_tests build.ninja genversion ortc_unittests rtp_analyzer.py video_engine_tests build.ninja.d ilbc_test pb_parse.py rtp_analyzer.sh video_loopback bwe_simulations_tests insert_packet_with_timing peerconnection_client rtpcat voe_auto_test click_annotate isac_api_test peerconnection_server RTPchange voice_engine_unittests common_audio_unittests isac_fix_test peerconnection_unittests RTPencode webrtc_nonparallel_tests common_video_unittests isac_switch_samprate_test plot_videoprocessor_integrationtest RTPjitter webrtc_opus_fec_test conversational_speech_generator isac_test protoc RTPtimeshift webrtc_perf_tests delay_test low_bandwidth_audio_test psnr_ssim_analyzer screenshare_loopback webrtc_tests event_log_visualizer misc.py pyproto stun_prober yasm force_mic_volume_max modules_tests py_quality_assessment stunserver frame_analyzer modules_unittests re2c system_wrappers_unittests frame_editor neteq_ilbc_quality_test relayserver test_packet_masks_metrics g711_test neteq_isac_quality_test rgba_to_i420_converter test_support_unittests

四、问题记录

1、gn: command not found 或者 gclient command not found 是因为 depot_tools 环境变量配置有误，没有正确找到 depot_tools 目录下的 gn 或 gclient 工具，确认 ~/.bashrc 文件配置是否正确：

export PATH=~/OpenSource/depot_tools:"$PATH"

2、执行 gn gen out/Default 命令报错：

gn.py: Could not find gn executable at: XXX/gn 需要执行命令： gclient runhooks 需要耐心等待一段时间，由其自动下载安装一些工具包，完成后，再次执行 gn gen out/Default 命令，提示成功： Done. Made 467 targets from 126 files in 383ms