要在 iOS 專案裡接入 XMPP,最主流的選擇是 robbiehanson 維護的 XMPPFramework。它採用模組化設計,核心之外的功能都做成擴展,開發者只需引入自己用得到的部分。以下是從下載到編譯通過的完整步驟。
專案網址:
https://github.com/robbiehanson/XMPPFramework
參考官方說明:
https://github.com/robbiehanson/XMPPFramework/wiki/GettingStarted_iOS

其中 Extension 目錄下的模組可以自行取捨,只加入當前專案真正需要的部分。由於擴展通常會依賴額外的第三方套件,記得一起加進來,否則編譯時會出現找不到符號的錯誤。
這裡我選擇加入以下模組:


依序選擇 Target → Build Phases → Link Binary With Libraries,點擊加號加入相依庫。具體需要哪些庫會隨你選擇的模組而異。

把 XMPPFramework 的原始碼根目錄加入搜索路徑,好讓編譯器找得到標頭檔。

//This file is designed to be customized by YOU. //As you pick and choose which parts of the framework you need for your //application, add them to this header file
這個檔案可以在下載的 XMPPFramework-master 中找到,複製進專案後改名即可。

這個框架年代較久,部分屬性宣告沒有明確的記憶體管理修飾詞,在 ARC 下會報錯。我的解法是在相應屬性定義處補上 strong 修飾符。


完成以上步驟,專案應該就能順利編譯。接下來只要建立 xmppStream、設定 delegate、走 CONNECT 與認證流程,就能開始收发訊息了。