一 、前言
WebRTC 名称源自网页即时通信(英语:Web Real-Time Communication)的缩写。谷歌收购并开源支持网页浏览器进行实时语音对话或视频对话的 API。它于2011年6月1日开源并在 Google、Mozilla、Opera 支持下被纳入万维网联盟的W3C推荐标准。
如果不修改 webrtc 相关源码,建议不要去折腾编译这个源码工程,光下载源码就够你头疼的。
可以直接引用已经编译好的中央库(Maven或者Gradle):
官方推荐:
compile 'org.webrtc:google-webrtc:1.0.+'
(+ 换成对应版本号,一定要去上面网址里面查询是否存在该版本,版本号查询地址: https://bintray.com/google/webrtc/google-webrtc )
官方地址:https://webrtc.org
二、环境准备
1、WebRTC 编译暂时支持 linux 平台,所以需要有一个 linux 系统或虚拟机
2、设置代理,这一步不做过多介绍,需要注意的是需要在终端设置代理,这一步也是比较坑的一步,大家可以搜一下怎么设置
3、下载 depot_tools:
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
4、配置 depot_tools 环境变量,最好是配置全局变量:
sudo gedit /etc/profile # 针对每个用户
# 在最后添加下面语句
export PATH=$PATH:/home/siven/siven/softSetup/depot_tools # depot_tools 路径
检查配置是否成功执行:
which gn # 如果正常打印出gn命令路径,说明成功
三、源码下载
1、指定一个位置存放 webrtc 源码,当前磁盘空间不能少于20G
mkdir webrtc
cd webrtc
2、代码同步
fetch --nohooks webrtc_android
gclient sync
源码文件大小在 15-20G,下载过程十分漫长不要慌,请耐心等待,也可能会出现其他问题 ...
3、执行环境配置脚本,会帮你检测并安装编译所需要的依赖库和工具
cd src
./build/install-build-deps.sh
四、源码编译
一、编译参数指定
gn gen out/build --args='target_os="android" target_cpu="arm" is_debug=false'
out/build : 编译生成文件的目录,随意指定
target_os : 编译目标平台 Android、iOS 等
target_cpu : cpu 架构平台armeabi、 armeabi-v7a、arm64-v8a、x86、x86_64等
is_debug : release 模式或者 debug 模式
二、执行编译
ninja -C out/build
由于是全量编译,所以时间稍微有点长,会有进度说明,耐心等待
生成Gradle项目文件
build/android/gradle/generate_gradle.py --output-directory $PWD/out/build \
--target "//examples:AppRTCMobile" --use-gradle-process-resources \
--split-projects --canary
执行完,可以在out/build/目录下会生成一个gradle的文件夹,使用 Android studio 该 gradle 目录即可运行 demo 工程。
五、版本选择
WebRTC 是持续在 master 分支开发的,我们二次开发 webrtc 最好基于稳定的 release 版本。查找库上的 release 版本:
git branch -r
然后 checkout 到对应的 release 版本
git checkout -b newbranch branch-heads/73 #切换到M73版本
gclient sync #同步对应版本的代码
(是之前编译的的工程,一直忙着没时间记录,今天是按照正常流程梳理了一遍。当时编译的时候遇到很多问题,感觉 webrtc android 编译实在太难了,现在回头一看又很简单,简单是因为 webrtc 所有编译工作已经全部都写在了脚本里了,只需要执行一个脚步命令全部搞定)