本文詳細記錄Mac下使用PD虛擬機器安裝ubuntu18.4桌面版，編譯Android Native WebRTC的過程。 注意如果僅僅是使用WebRTC沒必要手動編譯原始碼，直接用官方提供的預編譯包即可： The easiest way to get started is using the official prebuilt libraries available at JCenter. These libraries are compiled from the tip-of-tree and are meant for development purposes only. On Android Studio 3 add to your dependencies: ``` implementation 'org.webrtc:google-webrtc:1.0.+' ``` On Android Studio 2 add to your dependencies: ``` compile 'org.webrtc:google-webrtc:1.0.+' ``` The version of the library is 1.0.. The hash of the commit can be found in the .pom-file. The third party licenses can be found in the THIRD_PARTY_LICENSES.md file next to the .aar-file. 只有需要研究和修改原始碼時才有必要下載程式碼並自己編譯。 按照官網的教程WebRTC原始碼編譯看似簡單，但坑很多，尤其是為了能連上谷歌配置代理就要折騰很久，而且虛擬機器本身也不省心。 為此新建立了一個虛擬機器從頭開始配置，因為之前折騰的東西可能沒有全部記住，當時也沒有記錄，從頭開始保證一個命令都不差地記錄下來。當然，這裡使用的每一個環節的軟體和系統發生變化都會導致不一致的配置過程，僅供參考。 **安裝配置Ubuntu虛擬機器** Ubuntu下載地址： http://releases.ubuntu.com/18.04/ubuntu-18.04-desktop-amd64.iso 詳細安裝步驟： 1.安裝選擇映象方式，不要選擇下面的下載Ubuntu，很慢  2.進入這個頁面後點擊“手動選擇”  3.選擇下載好的iso檔案  4.選擇後識別出Ubuntu，繼續  5.設定使用者名稱密碼  6.設定在mac系統內虛擬機器檔案的檔名和位置  7.建立中，這裡等了大概一個小時  **安裝Parallels Tools** 1.從選單中選擇安裝Parallels Tools   2.會自動 mount 一個 CDROM 很不幸，直接雙擊 install-gui 無法安裝，命令列執行 install 也無法安裝。網上查了很久，最終發現了一篇文章，可以完美解決這個問題： https://gist.github.com/rudolfratusinski/a4d9e3caff11a4d9d81d2e84abc9afbf 這裡是按照上面步驟修改好的安裝檔案：百度網盤 (adsh)，沒試過直接用行不行。  3.安裝完成後直接重啟 重啟後分辨率自動調到最大，可以與mac共享剪貼簿了。此時虛擬機器檔案僅僅7G左右。我又建立了個快照變成8G了。。。 **下載WebRTC程式碼** **修改 Ubuntu 源** 推薦使用清華大學開源軟體映象站 https://mirror.tuna.tsinghua.edu.cn/help/ubuntu/ - 備份原生source.list sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup - 修改替換為清華映象版本，推薦使用gedit：sudo gedit /etc/apt/sources.list - 執行 sudo apt update **配置代理** 這裡使用環境變數配置 http proxy 的方法。後面還有個坑，需要結合程式碼下載步驟說明。 使用主機sockes提供的http代理。虛擬機器網路模式使用預設的共享網路。在PD的偏好設定裡可以找到網路設定，可以檢視共享網路地址段：10.211.55.1~254，主機是第一個節點因此IP是10.211.55.2。  檢視地址段 設定mac上的SS的http代理監聽地址為0.0.0.0才能允許任意IP使用：  設定ss的http代理地址 最後設定ubuntu的環境變數。 ``` # 可以寫入 .bashrc 檔案中 export ALL_PROXY=http://10.211.55.2:1087 export HTTP_PROXY=http://10.211.55.2:1087 export HTTPS_PROXY=http://10.211.55.2:1087 ``` 下載程式碼之前安裝了一些常用軟體 sudo apt install curl vim net-tools **下載程式碼** **命令清單** 官方文件：https://webrtc.org/native-code/android/ 總結一下，執行以下步驟和命令： ``` # 1.安裝必要的軟體 sudo apt install git python # 2.切換到 home cd /home/webrtc # 3.安裝和設定程式碼下載工具 git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git export PATH=$PATH:/home/webrtc/depot_tools # 可以寫在 .bashrc 裡 # 4.建立工作目錄並進入 mkdir webrtc_android cd webrtc_android # 注意接下來執行命令始終在這個目錄下 # 5.下載第一步：fetch fetch --nohooks webrtc_android # 6.設定 gclient 代理，原因是 gclient 無法使用 $HTTP_PROXY 設定代理， # 而要使用 .boto 檔案來設定。這就是上文提到的坑:) export NO_AUTH_BOTO_CONFIG=/home/webrtc/.boto # 可以寫在 .bashrc 裡 echo -e "[Boto]\nproxy = 10.211.55.2\nproxy_port = 1087" > /home/webrtc/.boto # 7.下載第二步：gclient，官網是一個步驟 "gclient sync"，這裡可以拆成兩個 gclient sync --nohooks # 同步程式碼用時較短 gclient runhooks # 執行一些 hooks，會下載一些檔案，其實這個步驟才需要 .boto 設定代理 ``` **下載第一步：fetch** fetch的步驟會下載16G的程式碼和開發環境，會持續很長時間取決於網速。好在每十秒鐘會有一次列印，提醒你仍在下載不是卡死了。  每十秒一次列印 fetch過程中git clone失敗會自動重試。但如果整個指令碼退出了，那就跪了。直接在原來的位置再次執行fetch是不行的，可以試試下一個命令gclient sync，保險起見可以重來。。。網速不行的總掉線的，可以洗洗睡了。 總之需要穩定的網路環境，還不能太慢，寫這篇文章時的下載跪了一次，第二天重來，連的網線，網速稍快且很穩定，大概800k/s左右，6個小時。  fetch完成的畫面 **設定 gclient 代理** gclient sync 的步驟需要另一種代理設定： 參考這篇文章 WebRTC在iOS端的實現/WebRTC在iOS端的實現 主要是設定一個.boto檔案，總結為上面清單裡的兩條命令： ``` export NO_AUTH_BOTO_CONFIG=/home/webrtc/.boto echo -e "[Boto]\nproxy = 10.211.55.2\nproxy_port = 1087" > /home/webrtc/.boto # 這裡就是建立一個 .boto 檔案按照固定的語法寫上代理配置，檔案內容如下： [Boto] proxy = 10.211.55.2 proxy_port = 1087 ``` 經過實際應用，並不需要unset掉環境變數，反而執行gclient runhooks時仍然需要環境變數，只要設定好NO_AUTH_BOTO_CONFIG就可以了。 **下載第二步：gclient** 這個步驟相比第一步很快就會完成，主要耗時在一些檔案下載上。之後更新程式碼執行 gclient sync 即可。 **編譯打包** **安裝必要的軟體和包** 參考官網：Prerequisite Software >> Install additional build dependencies ``` # 進入到src目錄中 cd src # 執行完後，當前目錄應為 /home/webrtc/webrtc_android/src # 下載 java相關命令和包，以及其他一些必要的軟體和包 build/install-build-deps-android.sh # 執行過程中要輸入 sudo 密碼 ``` **工具** WebRTC專案使用了大量的第三方開源專案，程式碼龐大複雜，整個構建系統採用了gn gn官方文件 和ninja ninja官方文件。 **GN** gn命令處理的是名稱為 BUILD.gn 的檔案，BUILD.gn 檔案中可以定義若干引數，這些引數使 gn 命令執行時可以通過不同的引數值建立不同的編譯配置。例如WebRTC的目標系統是在android上還是ios上。 gn使用檔案目錄層次來組織不同的編譯目標，這是非常自然合理的。檢視 WebRTC 的目錄結構可以發現每個資料夾下面都對應著一個 BUILD.gn 的檔案，含有 BUILD.gn 檔案表示這個目錄下是有編譯目標的，這些編譯目標可以依賴子目錄的編譯目標從而組成一套複雜而有序的構建圖。 **NINJA** gn的輸出就是副檔名為 .ninja 的檔案，這些檔案儲存在編譯目錄中，可以被 ninja 命令直接使用，ninja檔案中的指令都是簡單和明確的，不需要任何額外的邏輯判斷和計算，這使得ninja具有小而快的特點，也是ninja本身的設計初衷。 **編譯所有目標** 官網上的編譯打包命令： ``` cd webrtc_android/src gn gen out/Debug --args='target_os="android" target_cpu="arm"' ninja -C out/Debug ``` 總共會有八千多個構建目標，大約會執行一個小時以上。 **編譯 example app** ``` cd webrtc_android/src gn gen out/Debug --args='target_os="android" target_cpu="arm"' ninja -C out/Debug AppRTCMobile ``` 最後生成的apk位於out/Debug/apks/AppRTCMobile.apk 參考官方文件：https://webrtc.googlesource.com/src/+/master/examples/androidapp/README **打包 aar 檔案** WebRTC提供了一個指令碼工具可以直接構建一個安卓 aar 的檔案，我們直接用這個就可以了。 ``` cd webrtc_android/src tools_webrtc/android/build_aar.py --build-dir out --arch "armeabi-v7a" "arm64-v8a" ``` --build-dir out指定輸出目錄，如果不指定會在系統臨時目錄下建立 --arch "armeabi-v7a" "arm64-v8a" 指定兩種cpu架構，相當於gn命令中的target_cpu="arm"和target_cpu="arm64"。對每一種cpu架構會建立一個編譯目錄，依次執行gn和ninja命令。 最後將生成的jar和so打包成了aar檔案，aar檔案位於webrtc_android/src/libwebrtc.aar 編好了 aar 檔案後，可以拷貝到 mac 下使用了，在 Android Studio 中可以替換預編譯的 dependency implementation 'org.webrtc:google-webrtc:1.0.+' 如何替換可以參考安卓官方文件：https://developer.android.com/studio/projects/android-library#AddDependency **Android Studio** **不推薦使用官網提供的方法**  按照這個方法是無法編譯成功的，缺少一些步驟，需要手動調整，而且使用generate_gradle.py生成的 gradle 專案比較詭異。 **推薦方法** 直接將 src/examples/androidapp/ 目錄下的程式碼匯入到 Android Studio 中，匯入後生成的gradle檔案也不太完整，可以參考 src/examples/aarproject 中的 gradle 檔案來補全。 注意 src/examples/androidapp/third_part/autobanh/lib/autobanh.jar 檔案需要拷貝到 libs 目錄下。 以下是 build.gradle 檔案內容，供參考 ``` apply plugin: 'com.android.application' android { compileSdkVersion 27 buildToolsVersion "27.0.3" defaultConfig { applicationId "org.appspot.apprtc" minSdkVersion 16 targetSdkVersion 21 versionCode 1 versionName "1.0" testApplicationId "org.appspot.apprtc.test" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt' } } compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } } dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) implementation 'com.android.support:appcompat-v7:27.1.1' implementation 'com.google.code.findbugs:jsr305:3.0.2' implementation 'org.webrtc:google-webrtc:1.0.+' testImplementation 'junit:junit:4.12' androidTestImplementation 'com.android.support.test:runner:1.0.2' androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2' } ``` 原創作者：無貓皆籠，原文連結：https://www.jianshu.com/p/e0239bb43f48  歡迎關注我的微信公眾號「碼農突圍」，分享Python、Java、大資料、機器學習、人工智慧等技術，關注碼農技術提升•職場突圍•思維躍遷，20萬+碼農成長充電第一站，陪有夢想的你一起