Webrtc 研究: Android编译

前言

webrtc是谷歌收购并开源的一个支持实时音视频对话的技术。
官网是:https://webrtc.org
OK,介绍就这么多。

准备工作

如果不打算修改webrtc相关源码,建议不要去折腾编译这个源码工程。
直接引用已经编译好的中央库(Maven或者Gradle):

认准官方渠道:(只示例Gradle方式的)

compile 'org.webrtc:google-webrtc:1.0.+'   // + 可以换成对应版本号

相关版本可以在 https://bintray.com/google/webrtc/google-webrtc 这里查询,这个应该会持续更新。
PS:+替换的版本号一定要去上面网址里面查询是否存在该版本。

有历史的民间渠道:

compile 'io.pristine:libjingle:11139@aar'

相关版本可以在 http://mvnrepository.com/artifact/io.pristine/libjingle 进行查询,当初更新挺频繁,最近两三年没更新了,权当个缅怀吧。

源码下载

如果想修改源码,恭喜你,你需要自己编译源码。
webrtc编译说起来,编译既困难又简单;困难在源码规模太大,国内同步代码频繁出问题,简单在于谷歌已经将繁杂的编译过程整合成简单明了的编译脚本命令。
强调一点:下面的编译操作是基于Linux环境。

一、安装编译依赖环境
webrtc的编译环境依赖于谷歌的编译环境,也就是 depot_tools。
很简单,就一个clone源码到本地

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

这里需要设置环境变量

export PATH=$PATH:/path/depot_tools  #在当前环境变量追加路径

注意:path是你depot_tools文件夹所在的地址,需要替换为正确的路径。

测试环境变量是否配置成功:

which gn 或者 which gclient  #which指令会在环境变量设置的目录里查找执行文件

如果输出了前面配置的depot_tools文件夹地址,则是配置成功!

官网参考:http://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up

二、下载项目源码

1、准备工作
指定一个位置存放webrtc源码,特别需要注意的是当前硬盘存储空间需要不少于20GB。

mkdir webrtc
cd webrtc

2、代码同步

fetch --nohooks webrtc_android
gclient sync

这个大概会15-20GB的文件需要下载(版本持续迭代),同步速度取决于你的VPN给不给力。
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架构平台 arm arm64 x86 x64等
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工程。

Release版本

由于webrtc是持续在master分支开发的,所以我们二次开发webrtc最好基于稳定的release版本。
查找库上的release版本

git branch -r

然后checkout到对应的release版本

git checkout -b my_branch branch-heads/66  #切换到M66版本
gclient sync  #同步对应版本的代码

问题1:
如果查找不到对应的release版本,那可能是本地源码历史太久远了(2015-3-24以前的版本)
需要执行

gclient sync --with_branch_heads
git fetch origin

然后查看 .git/config

fetch = +refs/branch-heads/*:refs/remotes/branch-heads/*

则解决问题。

问题2:
如果checkout了比较早的版本,例如branch-heads/5* 版本
执行 gclient sync 会报同步错误
是因为 depot_tools 的源码太新,导致与webrtc源码不匹配,可以将 depot_tools 工程恢复到与 webrtc目标release版本相近日期的工程源码来进行同步编译。

项目结构

由于生成的gradle工程的源码并不是放在一个位置,而且分散在webrtc各个文件夹中,可以将各个对应文件夹下的源码文件整合到一起。
java源码目录如下:

#android端demo工程源码
examples/androidapp/src  
#lib源码
modules/audio_device/android/java/src  
base/android/java/src  
rtc_base/java/src  
sdk/android/api 
sdk/android/src/java 
#so库,位于编译目录下
libjingle_peerconnection_so.so

PS:可以自己通过gradle文件的依赖分析查看源码文件夹的引用路径。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,723评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,003评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,512评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,825评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,874评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,841评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,812评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,582评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,033评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,309评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,450评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,158评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,789评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,409评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,609评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,440评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,357评论 2 352

推荐阅读更多精彩内容

  • 网上的对于WebRTC的下载和编译的文章其实已经很多,但是有些比较久远,里面很多方法都无法再使用,所以写一篇文章来...
    Multa阅读 6,377评论 15 53
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,039评论 25 707
  • 说明 本文主要介绍和Gradle关系密切、相对不容易理解的配置,偏重概念介绍。部分内容是Android特有的(例如...
    jzj1993阅读 15,621评论 1 62
  • 你缺什么?缺钱?还是缺女朋友?或者两个都缺?是的,我也缺,都缺,但是我最缺的不是这两个,我缺觉... 这节课不打算...
    田二二阅读 519评论 0 0
  • 又到北风扫雪痕, 飞飘数点近黄昏。 离愁陌上梨花飞, 寂寞人家闭竹门。 长雁排空声去远, 短箫吹信意犹存。 空杯对...
    浅唱低语阅读 243评论 0 0