注1:本文檔適用于webrtc和webrtc-android源碼的下載和編譯;
注2:下載編譯所使用的操作系統為Ubuntu 14.04.3 LTS;
Chromium和Chromium OS統一使用一個叫做depot_tools的工具的對其源碼進行checkout的管理(這有點類似于Android使用repo工具對其源碼進行管理一樣),作為Chromium其中一個子模塊的webrtc而言,也是使用這個工具對其代碼進行checkout。這個depot_rools包里面包含了gclient、gcl、git-cl、repo等工具。
下載depot_tools工具包并放到標準路徑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//代碼下載過程中如果發生中斷,使用gclient sync同步就可以了
cd src/
./build/install-build-deps.sh(只需要在第一次gclient sync以后執行一次)
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//代碼下載過程中如果發生中斷,使用gclient sync同步就可以了
cd src/
./build/install-build-deps.sh(只需要在第一次gclient sync以后執行一次)
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目錄下):
? ?當前代碼在某個分支下進行維護,使用git pull可以拉取遠程倉庫的最新更新;
? ?當前代碼不在分支下,使用git fetch取下來最新的git倉庫更新;
? ?需要定期更新依賴或者其他第三方庫,使用gclient sync命令;
附錄:
1.webrtc-android版本下載及編譯過程中存在play_services不存在的問題
問題描述:
下載完成后執行:gn gen out/Debug --args='target_os="android" target_cpu="arm"'命令出現以下打印錯誤:
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",
? ? ?^-----------------------------------------
解決辦法:
通過對該問題進行跟蹤和查詢,應該是在下載play services框架的時候有一個license需要yes才可以,執行以下命令重新啟動play services的下載并在下載的過程中許可license:
./src/build/android/play_services/update.py download
2.webrtc-android版本編譯出現的jni問題
問題描述:
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
解決辦法:
出現以上問題是由于當前系統中缺少一些編譯webrtc-android的組件,需要調用以下兩個腳本在當前系統中安裝必要的組件即可:
./build/install-build-deps.sh
./build/install-build-deps-android.sh