因在開發公司專案有即時通訊模組,經商量之後選擇了第三方即時通訊sdk環信,由於3.0文件還不是非常全面,且本人之前沒有過開發即時通訊的經驗,查閱了很多資料,磕磕絆絆幾天終於完成了對該模組的開發,故此記錄所遇到的問題及解決辦法,方便以後自己或朋友的查閱:  

  首先,對於第一次接觸的朋友需要初步瞭解下環信,官方文件非常詳盡的介紹了,在此就不贅述.附上官方文件連結:http://docs.easemob.com/doku.php?id=im:start

1.先直接根據官方文件整合SDK,在整合之前如果是第一次接觸環信,建議備份工程.

注:官方下載的包裡會有兩個靜態庫,一個是包含實時語音的庫,另一個則不包含,根據業務需求,記得刪除掉一個庫,直接move to trash就可以.切記要刪除!否則在後邊的步驟會報重複引用連結錯誤.

2.根據官方文件匯入依賴庫的時候,dylib字尾沒有的直接用tbd就可以(Xcode 7之後改為tbd).

加入系統SDK依賴庫：

        CoreMedia.framework

        AudioToolbox.framework

        AVFoundation.framework

        MobileCoreServices.framework

        ImageIO.framework

        SystemConfiguration.framework

        libc++.a

        libresolv.dylib

        libz.dylib

        libstdc++.6.0.9.dylib

        libsqlite3.dylib

        libHyphenateSDK.a

如果報錯："_iconv", referenced from: _avcodec_decode_subtitle2 in libHyphenateFullSDK.a(utils.o)，則另外要加入libiconv.tbd依賴庫.

官方依賴庫匯入之後編譯,此處編譯會遇到的坑: 

1).報重複引用靜態庫錯誤(沒刪官方兩個靜態庫中的一個) 

2).報與-all_load 衝突錯誤 根據文件改為-ObjC即可  如果改為-ObjC還有錯 可按照文件改為 -force_load

注:專案如果用了友盟分享,改為-force_load之後 會與友盟有衝突,具體原因也不清楚,專案直接crash在分享新浪微博,此處求解惑.  改為-ObjC即可

到此步驟直到編譯沒錯的時候就說明匯入SDK 配環境成功.

3.環信官方提供了easeUI這個快速整合單聊介面,在整合easeUI之前建議不要用cocoapods來整合,因為會報一些莫名的錯誤. 

整合easeUI:

1).將EaseUI工程下載下來之後,直接拖入EaseUI資料夾,EaseUIResource裡面的Resource資料夾,export資料夾裡的resource資料夾下的EaseUIResource.bundle 包,到工程中.

2).新建一個pch檔案,設定好路徑之後,在pch檔案中新增引用:EaseUI-Prefix.pch 、ChatDemo-UI3.0-Prefix.pch 這兩個pch中的程式碼. 

此時編譯會報一個 NSObject + EaseMob類別錯誤 (該類別是2.0demo中的,根本沒有用) 可以選擇註釋,或者直接刪除該類別.將該類別註釋掉之後,如果報更多的錯誤,錯誤定在NSString或其他系統類上,在你新建的pch檔案裡,你所包含的標頭檔案開始加上: #ifdef __OBJC__   結尾處加上: #endif 如下圖:

此時編譯如果還報錯並且錯誤定在NSLocalizedString, 在你的pch檔案裡添上如下巨集:

#define NSEaseLocalizedString(key, comment) [[NSBundle bundleWithURL:[[NSBundle mainBundle] URLForResource:@"EaseUIResource"withExtension:@"bundle"]] localizedStringForKey:(key) value:@"" table:nil]

3).下載官方提供的ChatDemo-3.0 拖入demo中3rdparty資料夾,因EaseUI本身集成了幾個常用三方庫,因此會與工程中你所用的重複,此時編譯會報錯.本身所包含的常用三方如下:MBProgressHUD、VoiceConvert、MJRefresh、SDWebImage. 如果有衝突,切記刪除ChatDemo中的三方庫,然後改掉相關報錯的程式碼.

此時編譯如果還報錯,錯誤為Setting資料夾下的BackUp類,直接刪除掉或註釋即可,該類用處不大.

至此,編譯成功則EaseUI的整合也完畢了.

環信的EaseUI其實只是做到一個展示的作用,包括一些控制元件的佈局,排版都沒有處理,因此我們可以直接用ChatDemo3.0中的ChatViewController這個介面,附上整合視訊地址:http://v.youku.com/v_show/id_XMTQxOTgyNjU1Mg==.html?from=y1.2-1-87.3.6-2.1-1-1-5-0

好了,到此當你把ChatViewController也整合完畢,一個初步成型的單聊介面就出來了.ps:環信支援非好友之間的聊天,你只要知道對方的環信id即可.

那麼你會疑問了,頭像和暱稱還沒有搞定.因為環信伺服器不儲存使用者的頭像和暱稱,因此需要你與自己app的伺服器互動,聊天介面的頭像和暱稱在如下方法中修改:

- (id<IMessageModel>)messageViewController:(EaseMessageViewController *)viewController
                           modelForMessage:(EMMessage *)message

如果因業務需求用到會話列表,官方並沒有非常完善的文件,可以參考demo中的ConversationListViewController.