開始前,請先註冊環信帳號並建立應用,取得 AppKey。若需要離線推送,還需準備推送憑證;若只需單聊或群聊,可先略過推送設定。
從環信官網下載 iOS SDK,解壓後可看到 HyphenateSDK 資料夾。
將 HyphenateSDK 資料夾拖入 Xcode 專案。lib 資料夾中通常有兩個靜態庫,可依需求選擇是否包含語音功能。
若只需要基本即時通訊,可使用不含語音的版本;若需要完整功能,則使用 Full SDK。
在 Build Phases 的 Link Binary With Libraries 中加入 SDK 需要的系統函式庫,例如 AVFoundation、AudioToolbox、CoreMedia、MobileCoreServices、ImageIO、SystemConfiguration,以及必要的 lib 檔。
若不包含語音靜態庫,通常需保留 libHyphenateSDK.a,並在 Other Linker Flags 加入 -ObjC 與該靜態庫路徑。
若包含語音靜態庫,則保留 libHyphenateFullSDK.a,並在 Other Linker Flags 加入 -ObjC。
在 AppDelegate 中匯入 EaseMob.h,建立 EMOptions,設定 AppKey,並呼叫初始化方法。若要註冊與登入帳號,可呼叫 EMClient 的註冊與登入方法。
若編譯成功並能完成登入,代表 SDK 已正確整合。若失敗,優先檢查靜態庫是否完整,以及 Linker Flags 是否設定正確。