Webrtc的iOS框架編譯

1.WebRTC的iOS框架的選擇

目前兩個比較活躍的開源WebRTC實現.

• Google WebRTC:

項目地址是: https://code.google.com/p/webrtc/

• Ericsson Research OpenWebRTC:

項目地址是: 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這些高科技,我們要切換到終端環境下用命令行下的黑科技來征服這一切.

2.開始WebRTC×××

前提條件:

• 我現在用的Macbook,8G內存,運行OS X 10.9.5.

• 安裝最新的git和subversions并確保其可正常工作.

• Xcode 6.1.1 和 Command Line Tools.

• 中國大陸用戶額外要求,快速的×××,或者快速的shadowsocks服務.(×××和給git和svn以及curl設置代理等).

2.1 創建一個編譯目錄

我們創建一個目錄專門來存放項目編譯工具和項目代碼倉庫等.確保該目錄所在磁盤可用空間至少有8~10G.打開系統的終端工具進入到Shell:

wuqiong:~ apple$mkdir -p $HOME/opensource/webrtc_build/

2.2 下載Chromium的depot工具

在執行下面命令之前,請確保你已經連上快速×××已經×××了,或者你已經給git單獨配置了有效的socks×××代理,如果你這些都不是問題,就當我沒說.

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

2.3 下載WebRTC的源碼

在我們的編譯工作目錄webrtc_build下創建一個webtrtc子目錄來存放代碼,請執行下面命令:

wuqiong:webrtc_build apple$ mkdir webrtc
wuqiong:webrtc_build apple$ cd webrtc

在上面的檢查工作沒錯之后,我們就需要開始把WebRTC項目的代碼倉庫下載一份到本地來.由于其倉庫之大,大約一共需要下載6G+的東西.所以這一步非常需要有耐心.而且需要有穩定無障礙的互聯網. 執行如下命令然后吧:

wuqiong:webrtc apple$ gclient config --name src http://webrtc.googlecode.com/svn/trunk
wuqiong:webrtc apple$ echo "target_os = ['ios']" >> .gclient
wuqiong:webrtc apple$ gclient sync --force

×××快的去喝咖啡,慢的去約妹子吧.辦完事情之后回來如果上面的命令都一切順利,我們就可以往下走去開始編譯了. (為了方便大家,我已經把webrtc_build目錄打包備份,這樣大家可以省去大量的代碼下載時間.打包文件有5G,正在尋找網盤存放,隨后公布.)

2.4 編譯WebRTC.framework

到了這一步,源碼應該已經下載好了.這些源碼可以編譯為好幾個平臺,OS X, Linux, Windows, Android, iOS等.這里我們只需要編譯iOS平臺的WebRTC,并制作成一個iOS的開發框架.這里我們不能用Xcode工具,因為這些項目壓根就不支持 XCode.我們需要在終端命令行環境下去搞定這一切!

首先,為了我們裝逼玩黑武器,我們需要在webrtc的項目代碼目錄下創建一個腳本, 這個腳本就是我為了簡化命令的復雜度和提高使用的方便性專門編寫的一個一鍵框架編譯腳本,這個腳本就是今天的核心黑科技了.先創建一個空文件,然后賦予執行權限:

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腳本里頭去了.如果有興趣可以去研究一下這個腳本.

2.5 WebRTC.framework的依賴.

如果項目使用了該框架,那么編譯的時候需要在項目的Build Phases中添加如下庫和框架:

• libstdc++.6.dylib

• libsqlite3.dylib

• libc++.dylib

• libicucore.dylib

• Security.framework

• CFNetwork.framework

• GLKit.framework

• AudioToolbox.framework

• AVFoundation.framework

• CoreAudio.framework

• CoreMedia.framework

• CoreVideo.framework

• CoreGraphics.framework

• OpenGLES.framework

• QuartzCore.framework

重要提示

目前Google官方代碼中在ARMv7平臺有VP8視頻編碼的stackoverflow問題，會直接導致程序崩潰，如需了解詳情并獲取補丁，請聯系戴維營教育，或者等幾天官方就會修復了。

本文檔由長沙戴維營教育整理。