目前有兩個比較活躍的開源 WebRTC 實現:
專案地址是:https://code.google.com/p/webrtc/
專案地址是:https://github.com/EricssonResearch/openwebrtc
為了讓學生在實戰專案中運用 WebRTC 視訊通話技術,我們選擇 Google 的 WebRTC 專案來建構 iOS App 的開發框架,因為目前 Chrome 與 Firefox 瀏覽器對 WebRTC 的支援都採用該專案。那麼問題來了:既然瀏覽器都支援 WebRTC,為何還要把它移植編譯到 iOS 平台,直接用 webview 不行嗎?答案是——目前還不行。Apple 在這方面已經落後,雖然它有強大的 Facetime 技術能隨時隨地視訊通話,但並未開源。因此我們還是得老老實實地移植 WebRTC。所幸 Google 的 Chromium 開發者已經為 WebRTC 實作了一套 Objective-C 的 API。
不過醜話說在前頭:要從零開始把 WebRTC 整合進我們的 App,簡直是一場噩夢。因為 WebRTC 專案與 Chromium 專案之間存在一定的依賴關係,而且都是跨平台的大型專案,採用 Google 自己的一套編譯系統,比我們日常的 IDE 複雜得多。若要得到一個 WebRTC 的庫或框架,就得暫時告別 Xcode IDE 與 Interface Builder,切換到終端環境用命令列來完成這一切。
前提條件:
我們建立一個目錄專門存放專案編譯工具與程式碼倉庫,確保該目錄所在磁碟至少有 8~10G 可用空間。打開系統的終端機進入 Shell:
wuqiong:~ apple$mkdir -p $HOME/opensource/webrtc_build/ 執行以下命令前,請確保已連上快速 VPN 完成 FQ,或已為 git 單獨配置有效的 socks FQ 代理:
wuqiong:~ apple$cd $HOME/opensource/webrtc_build/ wuqiong:webrtc_build apple$git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git 這是一套 Google 用來編譯 Chromium 或 WebRTC 的建置工具,後續編譯也會用到它。為了命令列使用方便,我們把這些工具的路徑加入系統環境變數 PATH:
wuqiong:webrtc_build apple$echo "export PATH=$PWD/depot_tools:$PATH" > $HOME/.bash_profile 接著關閉當前終端重新開啟一個,讓環境變數生效;或在當前終端執行以下命令載入:
wuqiong:webrtc_build apple$source $HOME/.bash_profile 在編譯工作目錄 webrtc_build 下建立一個 webrtc 子目錄存放程式碼:
wuqiong:webrtc_build apple$ mkdir webrtc wuqiong:webrtc_build apple$ cd webrtc 確認無誤後,開始把 WebRTC 專案的程式碼倉庫下載到本地。由於倉庫龐大,大約需要下載 6G+ 的內容,這一步非常需要耐心,也需要穩定無阻的網路。執行以下命令:
wuqiong:webrtc apple$ gclient config --name src https://webrtc.googlecode.com/svn/trunk wuqiong:webrtc apple$ echo "target_os = ['ios']" >> .gclient wuqiong:webrtc apple$ gclient sync --force 等待下載完成,若一切順利,就可以進入編譯階段。
到了這一步,原始碼應該已下載完成。這些原始碼可編譯為 OS X、Linux、Windows、Android、iOS 等多個平台,這裡我們只需編譯 iOS 平台並製作開發框架。由於這些專案根本不支援 Xcode,我們必須在終端命令列環境下完成。
首先建立一個一鍵編譯腳本,用以簡化命令的複雜度並提升使用便利性。先建立空檔並賦予執行權限:
wuqiong:webrtc apple$ touch build_webrtc.sh wuqiong:webrtc apple$ chmod +x build_webrtc.sh 接著用編輯器打開剛建立的腳本,貼入以下內容後儲存並關閉:
#!/bin/bash # Script to build WebRTC.framework for iOS # Copyright (C) 2015 戴維營教育 - All Rights Reserved # Last revised 28/1/2015 # function build_iossim_ia32() { echo "*** building WebRTC for the ia32 iOS simulator"; export GYP_GENERATORS="ninja"; export GYP_DEFINES="build_with_libjingle=1 build_with_chromium=0 libjingle_objc=1 OS=ios target_arch=ia32"; export GYP_GENERATOR_FLAGS="$GYP_GENERATOR_FLAGS output_dir=out_ios_ia32"; export GYP_CROSSCOMPILE=1; pushd src; gclient runhooks; ninja -C out_ios_ia32/Release-iphonesimulator iossim AppRTCDemo; echo "*** creating iOS ia32 libraries"; pushd out_ios_ia32/Release-iphonesimulator/; rm -f libapprtc_signaling.a; popd; mkdir -p out_ios_ia32/libs; libtool -static -o out_ios_ia32/libs/libWebRTC-ia32.a out_ios_ia32/Release-iphonesimulator/lib*.a; strip -S -x -o out_ios_ia32/libs/libWebRTC.a -r out_ios_ia32/libs/libWebRTC-ia32.a; rm -f out_ios_ia32/libs/libWebRTC-ia32.a; echo "*** result: $PWD/out_ios_ia32/libs/libWebRTC.a"; popd; } function build_iossim_x86_64() { echo "*** building WebRTC for the x86_64 iOS simulator"; export GYP_GENERATORS="ninja"; export GYP_DEFINES="build_with_libjingle=1 build_with_chromium=0 libjingle_objc=1 OS=ios target_arch=x64 target_subarch=arm64"; export GYP_GENERATOR_FLAGS="$GYP_GENERATOR_FLAGS output_dir=out_ios_x86_64"; export GYP_CROSSCOMPILE=1; pushd src; gclient runhooks; ninja -C out_ios_x86_64/Release-iphonesimulator iossim AppRTCDemo; echo "*** creating iOS x86_64 libraries"; pushd out_ios_x86_64/Release-iphonesimulator/; rm -f libapprtc_signaling.a; popd; mkdir -p out_ios_x86_64/libs; libtool -static -o out_ios_x86_64/libs/libWebRTC-x86_64.a out_ios_x86_64/Release-iphonesimulator/lib*.a; strip -S -x -o out_ios_x86_64/libs/libWebRTC.a -r out_ios_x86_64/libs/libWebRTC-x86_64.a; echo "*** result: $PWD/out_ios_x86_64/libs/libWebRTC.a"; popd; } function build_iosdevice_armv7() { echo "*** building WebRTC for armv7 iOS devices"; export GYP_GENERATORS="ninja"; export GYP_DEFINES="build_with_libjingle=1 build_with_chromium=0 libjingle_objc=1 OS=ios target_arch=armv7"; export GYP_GENERATOR_FLAGS="$GYP_GENERATOR_FLAGS output_dir=out_ios_armv7"; export GYP_CROSSCOMPILE=1; pushd src; gclient runhooks; ninja -C out_ios_armv7/Release-iphoneos AppRTCDemo; echo "*** creating iOS armv7 libraries"; pushd out_ios_armv7/Release-iphoneos/; rm -f libapprtc_signaling.a; popd; mkdir -p out_ios_armv7/libs; libtool -static -o out_ios_armv7/libs/libWebRTC-armv7.a out_ios_armv7/Release-iphoneos/lib*.a; strip -S -x -o out_ios_armv7/libs/libWebRTC.a -r out_ios_armv7/libs/libWebRTC-armv7.a; echo "*** result: $PWD/out_ios_armv7/libs/libWebRTC.a"; popd; } function build_iosdevice_arm64() { echo "*** building WebRTC for arm64 iOS devices"; export GYP_GENERATORS="ninja"; export GYP_DEFINES="build_with_libjingle=1 build_with_chromium=0 libjingle_objc=1 OS=ios target_arch=arm64 target_subarch=arm64"; export GYP_GENERATOR_FLAGS="$GYP_GENERATOR_FLAGS output_dir=out_ios_arm64"; export GYP_CROSSCOMPILE=1; pushd src; gclient runhooks; ninja -C out_ios_arm64/Release-iphoneos AppRTCDemo; echo "*** creating iOS arm64 libraries"; pushd out_ios_arm64/Release-iphoneos/; rm -f libapprtc_signaling.a; popd; mkdir -p out_ios_arm64/libs; libtool -static -o out_ios_arm64/libs/libWebRTC-arm64.a out_ios_arm64/Release-iphoneos/lib*.a; strip -S -x -o out_ios_arm64/libs/libWebRTC.a -r out_ios_arm64/libs/libWebRTC-arm64.a; echo "*** result: $PWD/out_ios_arm64/libs/libWebRTC.a"; popd; } function combine_libs() { echo "*** combining libraries"; lipo -create src/out_ios_ia32/libs/libWebRTC.a \ src/out_ios_x86_64/libs/libWebRTC.a \ src/out_ios_armv7/libs/libWebRTC.a \ src/out_ios_arm64/libs/libWebRTC.a \ -output libWebRTC.a; echo "The public headers are located in $PWD/src/talk/app/webrtc/objc/public/*.h"; } function create_framework() { echo "*** creating WebRTC.framework"; rm -rf WebRTC.framework; mkdir -p WebRTC.framework/Versions/A/Headers; cp ./src/talk/app/webrtc/objc/public/*.h WebRTC.framework/Versions/A/Headers; cp libWebRTC.a WebRTC.framework/Versions/A/WebRTC; pushd WebRTC.framework/Versions; ln -sfh A Current; popd; pushd WebRTC.framework; ln -sfh Versions/Current/Headers Headers; ln -sfh Versions/Current/WebRTC WebRTC; popd; } function clean() { echo "*** cleaning"; pushd src; rm -rf out_ios_arm64 out_ios_armv7 out_ios_ia32 out_ios_x86_64; popd; echo "*** all cleaned"; } function update() { gclient sync --force pushd src svn info | grep Revision > ../svn_rev.txt popd } function build_all() { build_iossim_ia32 && build_iossim_x86_64 && \ build_iosdevice_armv7 && build_iosdevice_arm64 && \ combine_libs && create_framework; } function run_simulator_ia32() { echo "*** running webrtc appdemo on ia32 iOS simulator"; src/out_ios_ia32/Release-iphonesimulator/iossim src/out_ios_ia32/Release-iphonesimulator/AppRTCDemo.app; } function run_simulator_x86_64() { echo "*** running webrtc appdemo on x86_64 iOS simulator"; src/out_ios_x86_64/Release-iphonesimulator/iossim -d 'iPhone 6' -s '8.1' src/out_ios_x86_64/Release-iphonesimulator/AppRTCDemo.app; } function run_on_device_armv7() { echo "*** launching on armv7 iOS device"; ideviceinstaller -i src/out_ios_armv7/Release-iphoneos/AppRTCDemo.app; echo "*** launch complete"; } function run_on_device_arm64() { echo "*** launching on arm64 iOS device"; ideviceinstaller -i src/out_ios_arm64/Release-iphoneos/AppRTCDemo.app; echo "*** launch complete"; } #運行命令行參數中第一個參數所指定的Shell函數 $@ 這個編譯腳本除了能編譯 WebRTC 專案自帶的 AppRTCDemo 應用外,還能編譯出 WebRTC.framework。執行以下命令編譯所需的全部內容:
wuqiong:webrtc apple$ ./build_webrtc.sh build_all 命令完成後,所需的 WebRTC 框架就在當前目錄下了,可用 ls 命令查看:
wuqiong:webrtc apple$ ls WebRTC.framework build_webrtc.sh libWebRTC.a src wuqiong:webrtc apple$ 第一個 WebRTC.framework 就是我們需要的框架!至此編譯任務便完成了。繁瑣的細節都已封裝進 shell 腳本中,有興趣可以深入研究這個腳本。
若專案使用了該框架,編譯時需在 Build Phases 中加入以下庫與框架:
目前 Google 官方程式碼在 ARMv7 平台上存在 VP8 視訊編碼的 stackoverflow 問題,會直接導致程式崩潰,如需了解詳情並取得補丁,請聯繫戴維營教育。