注1:本文檔適用于webrtc和webrtc-android源碼的下載和編譯;
注2:下載編譯所使用的操作系統(tǒng)為Ubuntu 14.04.3 LTS;
Chromium和Chromium OS統(tǒng)一使用一個(gè)叫做depot_tools的工具的對(duì)其源碼進(jìn)行checkout的管理(這有點(diǎn)類(lèi)似于Android使用repo工具對(duì)其源碼進(jìn)行管理一樣),作為Chromium其中一個(gè)子模塊的webrtc而言,也是使用這個(gè)工具對(duì)其代碼進(jìn)行checkout。這個(gè)depot_rools包里面包含了gclient、gcl、git-cl、repo等工具。
下載depot_tools工具包并放到標(biāo)準(zhǔn)路徑PATH上:
?首先確保Linux上安裝了Git 2.2.1以上版本,以及Python 2.7以上版本;
? ?git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
? ?修改HOME目錄中的.bashrc文件,在最后增加:PATH="~/bin/depot_tools:$PATH",注意一定要把depot_tools的位置放在PATH的最前面;
參考:https://dev.chromium.org/developers/how-tos/install-depot-tools
下載webrtc-native代碼及編譯流程(首先要先按照以上步驟下載depot_tools):
mkdir webrtc-checkout
cd webrtc-checkout
fetch --nohooks webrtc
gclient sync//代碼下載過(guò)程中如果發(fā)生中斷,使用gclient sync同步就可以了
cd src/
./build/install-build-deps.sh(只需要在第一次gclient sync以后執(zhí)行一次)
gn gen out/Default
ninja -C out/Default
gn clean out/Default
下載webrtc-android代碼及編譯流程(首先要先按照以上步驟下載depot_tools ):
mkdir webrtc-android
cd webrtc-android
fetch --nohooks webrtc_android
gclient sync//代碼下載過(guò)程中如果發(fā)生中斷,使用gclient sync同步就可以了
cd src/
./build/install-build-deps.sh(只需要在第一次gclient sync以后執(zhí)行一次)
gn gen out/Debug --args='target_os="android" target_cpu="arm"'
ninja -C out/Debug
gn clean out/Debug
編譯和安裝AppRTCMobile :
ninja -C out/Default AppRTCMobile
adb install -r out/Default/apks/AppRTCMobile.apk
WebRTC代碼后期更新的三種方式(在src目錄下):
? ?當(dāng)前代碼在某個(gè)分支下進(jìn)行維護(hù),使用git pull可以拉取遠(yuǎn)程倉(cāng)庫(kù)的最新更新;
? ?當(dāng)前代碼不在分支下,使用git fetch取下來(lái)最新的git倉(cāng)庫(kù)更新;
? ?需要定期更新依賴或者其他第三方庫(kù),使用gclient sync命令;
附錄:
1.webrtc-android版本下載及編譯過(guò)程中存在play_services不存在的問(wèn)題
問(wèn)題描述:
下載完成后執(zhí)行:gn gen out/Debug --args='target_os="android" target_cpu="arm"'命令出現(xiàn)以下打印錯(cuò)誤:
pavel@ubuntu-han:~/webrtc-android/src$ gn gen out/Debug --args='target_os="android" target_cpu="arm"'
ERROR at //build/config/android/rules.gni:2739:9: Script returned non-zero exit code. ? ? ? exec_script("http://build/android/gyp/aar.py",
? ? ? ?^----------
Current dir: /home/pavel/webrtc-android/src/out/Debug/
Command: python -- /home/pavel/webrtc-android/src/build/android/gyp/aar.py --input-file ../../third_party/android_tools/sdk/extras/google/m2repository/com/google/android/gms/play-services-basement/10.2.0/play-services-basement-10.2.0.aar --list
Returned 1.
stderr:
Traceback (most recent call last):
?File "/home/pavel/webrtc-android/src/build/android/gyp/aar.py", line 114, in <module>
? ?sys.exit(main())
?File "/home/pavel/webrtc-android/src/build/android/gyp/aar.py", line 81, in main
? ?with zipfile.ZipFile(aar_file) as z:
?File "/usr/lib/python2.7/zipfile.py", line 701, in __init__
? ?self.fp = open(file, modeDict[mode])
IOError: [Errno 2] No such file or directory: '../../third_party/android_tools/sdk/extras/google/m2repository/com/google/android/gms/play-services-basement/10.2.0/play-services-basement-10.2.0.aar'
See //third_party/android_tools/BUILD.gn:191:1: whence it was called.
android_aar_prebuilt("google_play_services_basement_java") {
^-----------------------------------------------------------
See //webrtc/system_wrappers/BUILD.gn:155:7: which caused the file to be included. ? "http://third_party/android_tools:cpu_features",
? ? ?^-----------------------------------------
解決辦法:
通過(guò)對(duì)該問(wèn)題進(jìn)行跟蹤和查詢,應(yīng)該是在下載play services框架的時(shí)候有一個(gè)license需要yes才可以,執(zhí)行以下命令重新啟動(dòng)play services的下載并在下載的過(guò)程中許可license:
./src/build/android/play_services/update.py download
2.webrtc-android版本編譯出現(xiàn)的jni問(wèn)題
問(wèn)題描述:
pavel@ubuntu-han:~/webrtc-android/src$ ninja -C out/Debug/
ninja: Entering directory `out/Debug/'
[3/7329] ACTION //base:android_runtime_jni_headers__jni_Runtime(//build/toolchain/android:android_arm)
FAILED: gen/android_runtime_jni_headers/base/jni/Runtime_jni.h
python ../../base/android/jni_generator/jni_generator.py --depfile gen/base/android_runtime_jni_headers__jni_Runtime.d --jar_file ../../third_party/android_tools/sdk/platforms/android-24/android.jar --input_file java/lang/Runtime.class --optimize_generation=1 --ptr_type=long --output_dir gen/android_runtime_jni_headers/base/jni --includes ../../../../../../base/android/jni_generator/jni_generator_helper.h --native_exports_optional
Traceback (most recent call last):
?File "../../base/android/jni_generator/jni_generator.py", line 1418, in <module>
? ?sys.exit(main(sys.argv))
?File "../../base/android/jni_generator/jni_generator.py", line 1411, in main
? ?GenerateJNIHeader(input_file, output_file, options)
?File "../../base/android/jni_generator/jni_generator.py", line 1314, in GenerateJNIHeader
? ?jni_from_javap = JNIFromJavaP.CreateFromClass(input_file, options)
?File "../../base/android/jni_generator/jni_generator.py", line 663, in CreateFromClass
? ?stderr=subprocess.PIPE)
?File "/usr/lib/python2.7/subprocess.py", line 679, in __init__
? ?errread, errwrite)
?File "/usr/lib/python2.7/subprocess.py", line 1249, in _execute_child
? ?raise child_exception
OSError: [Errno 2] No such file or directory
[4/7329] CXX obj/base/base_paths/base_paths_android.o
解決辦法:
出現(xiàn)以上問(wèn)題是由于當(dāng)前系統(tǒng)中缺少一些編譯webrtc-android的組件,需要調(diào)用以下兩個(gè)腳本在當(dāng)前系統(tǒng)中安裝必要的組件即可:
./build/install-build-deps.sh
./build/install-build-deps-android.sh