好久沒寫部落格了,這算是進入新工作後的第一篇技術筆記。有趣的是,我是以 C# 工程師的身分面試入職,如今卻是全職的 iOS 開發。從 C# 轉到 Objective-C 有它的成本,加上今年又出現了 Swift,要學的路還很長。不過對我而言,語言切換早已是常態——學會一個語言並不難,真正掌握它才是難事,有點像去摸清一個陌生人的脾氣。
專案需要用到 VOIP。比較過各種方案後,以 SIP 實作的代價相對最小。Android 因為系統內建了 SIP 支援而佔了便宜,iOS 沒這麼幸運,於是找到了 PJSIP——一個純 C 寫成、結構相當漂亮、可跨平台的協議 stack。
網路上找了很久,始終沒有適合入門者的完整教學。以下是我摸索出來的流程,希望讓你少走一些彎路。
到官網下載原始碼,建議選 .tar.bz2 格式。解壓:
$ tar -jxvf pjproject-2.2.1.tar.bz2
先在 pjlib/include/pj/ 目錄下建立 config_site.h:
$ cd pjlib/include/pj/ $ vi config_site.h
依官方說明,內容定義如下:
#define PJ_CONFIG_IPHONE 1 #include <pj/config_site_sample.h>
存檔後切回主目錄(含 pjlib、pjmedia、pjnath 的那層)。前提是你要先裝好 Xcode 的 Command Line Tools(Xcode → Preferences → Downloads)。
第一支要編的是模擬器版本。注意每換一個平台架構,都要重開一個新的終端機視窗。
$ export DEVPATH=/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer $ ARCH="-arch i386" \ CFLAGS="-O2 -m32 -mios-simulator-version-min=5.0" \ LDFLAGS="-O2 -m32 -mios-simulator-version-min=5.0" \ ./configure-iphone $ make dep && make clean && make
順利的話,靜態庫會出現在這幾個位置:pjlib/lib、pjlib-util/lib、pjmedia/lib、pjnath/lib、pjsip/lib、third_party/lib。這些都是後續 SIP 開發必備的庫。此時它只支援模擬器(可用 lipo -info 確認只有 i386),因此需要複製出來備用。
#!/bin/bash
PJLIB_PATH="./lib/$1/pjlib"
PJLIB_UTIL_PATH="./lib/$1/pjlib-util"
PJMEDIA_PATH="./lib/$1/pjmedia"
PJNATH_PATH="./lib/$1/pjnath"
PJSIP_PATH="./lib/$1/pjsip"
THIRD_PARTY="./lib/$1/third_party"
echo "start coping to $1"
for p in $PJLIB_PATH $PJLIB_UTIL_PATH $PJMEDIA_PATH $PJNATH_PATH $PJSIP_PATH $THIRD_PARTY; do
rm -rf $p
mkdir -p $p
done
cp -r ./pjlib/lib/ $PJLIB_PATH
cp -r ./pjlib-util/lib/ $PJLIB_UTIL_PATH
cp -r ./pjmedia/lib/ $PJMEDIA_PATH
cp -r ./pjnath/lib/ $PJNATH_PATH
cp -r ./pjsip/lib/ $PJSIP_PATH
cp -r ./third_party/lib/ $THIRD_PARTY
echo "copy done"
存成 copylibs.sh 放在主目錄,執行 ./copylibs.sh i386。若權限不足,用 chmod 777 copylibs.sh 放開。
關掉剛才的視窗,重新開一個,到主目錄執行:
$ ARCH='-arch armv7' ./configure-iphone $ make dep && make clean && make $ ./copylibs.sh armv7
接著是 armv7s,這次不必再換視窗:
$ ARCH='-arch armv7s' ./configure-iphone $ make dep && make clean && make $ ./copylibs.sh armv7s
過程中可能出現錯誤訊息,但那些都是範例專案編譯失敗,與靜態庫本身無關。
$ ARCH='-arch arm64' ./configure-iphone $ make dep && make clean && make $ ./copylibs.sh arm64
四種架構都備齊後,用 lipo 把它們合成單一檔案,這樣 App 才能在模擬器與各代真機上通用。
#!/bin/bash
OUPUT_PATH="./mixed/"
XLIPO="/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/lipo"
for dir in armv7/*; do
LIB_NAME=${dir##*/}
LIB_OUTPUT=${OUPUT_PATH}$LIB_NAME
rm -rf $LIB_OUTPUT
mkdir -p $LIB_OUTPUT
for subdir in ${dir}/*; do
AFILE=${subdir##*/}
echo "start mixing file: $AFILE"
${XLIPO} \
-arch armv7 "./armv7/$LIB_NAME/$AFILE" \
-arch armv7s "./armv7s/$LIB_NAME/$AFILE" \
-arch arm64 "./arm64/$LIB_NAME/$AFILE" \
-arch i386 "./i386/$LIB_NAME/$AFILE" \
-create -output ${LIB_OUTPUT}/$AFILE
done
done
echo "all mixed done"
存成 mix.sh 放在 lib 目錄下,切進該目錄執行 ./mix.sh,mixed 資料夾裡就是可以直接拖進 Xcode 專案的通用靜態庫。
每換一次架構就重開終端機,是因為 configure 的結果會被快取,同一個視窗裡連續執行會沿用上一次的設定,這是類似的編譯任務最常踩的坑。
把庫拖進專案後,別忘了在 Build Settings 的 Library Search Paths 與 Header Search Paths 中補上 PJSIP 的 lib 與 include 路徑。PJSIP 依賴的系統庫(如 CoreAudio、AudioToolbox、VideoToolbox)也需要一併連結,否則會出現大量 undefined symbols。