您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

用 JSQMessagesViewController 打造 iOS 聊天 App(一):專案建立與聊天介面實作

編輯:iOS 開發綜合

這個系列會用 Swift 加上 Syncano 後端,一步步做出一個可用的 iOS 聊天 App。路線是這樣的:

第一部分建立專案、整合 JSQMessagesViewController,先把介面跑起來;第二部分把訊息存進伺服器並做到即時同步;第三部分加上註冊、登入與訊息可視化。

前端我們用 JSQMessagesViewController,後端用 Syncano 及其 iOS 庫,兩者都透過 CocoaPods 安裝。

建立專案

開啟 Xcode,選擇 Single View Application,專案名稱取為 SyncanoChat,語言選 Swift。

安裝 CocoaPods

如果還沒裝過:

sudo gem install cocoapods

輸入密碼後等待安裝完成。

導入相依庫

在終端機進入專案目錄並初始化:

cd ~/path/to/my/project/SyncanoChat
pod init
open Podfile

把 Podfile 內容換成:

# Uncomment this line to define a global platform for your project
# platform :ios, '8.0'
# Uncomment this line if you're using Swift
use_frameworks!

target 'SyncanoChat' do
  pod 'syncano-ios'
  pod 'JSQMessagesViewController'
end

target 'SyncanoChatTests' do
end

target 'SyncanoChatUITests' do
end

存檔關閉,然後:

pod install
open SyncanoChat.xcworkspace

之後一律開 .xcworkspace,不要再用 .xcodeproj。執行一次確認沒問題。

(視情況)加入 Objective-C 橋接標頭

如果你保留了 use_frameworks!,這一步可以跳過。但若是因為某些原因必須使用靜態庫,就得手動建立橋接標頭。

做法是 File → New → File,選 Objective-C Class,隨便取個名字(例如 Test),語言選 Objective-C。當 Xcode 詢問是否建立 Objective-C Bridging Header 時選 Yes,接著就可以把這個暫時的類刪掉。

Xcode 會自動產生 SyncanoChat-Bridging-Header.h,打開它並加入:

#import <Syncano.h>
#import <JSQMessagesViewController/JSQMessages.h>

存檔編譯,確認通過後就能在 Swift 中使用這兩個庫了。

子類化 JSQMessagesViewController

打開 ViewController.swift,把父類從 UIViewController 換成 JSQMessagesViewController:

import UIKit

class ViewController: JSQMessagesViewController {
    // ...
}

如果沒用橋接標頭,記得補上 import:

import UIKit
import JSQMessagesViewController
import syncano_ios

編譯一次,確認 Xcode 認得 JSQMessagesViewController。

宣告屬性

需要三個屬性:messages 存放所有訊息(會不斷變動,所以是 var);incomingBubble 與 outgoingBubble 分別定義收到與送出的氣泡樣式(設定後不再變,用 let)。

let incomingBubble = JSQMessagesBubbleImageFactory()
    .incomingMessagesBubbleImageWithColor(
        UIColor(red: 10/255, green: 180/255, blue: 230/255, alpha: 1.0))

let outgoingBubble = JSQMessagesBubbleImageFactory()
    .outgoingMessagesBubbleImageWithColor(UIColor.lightGrayColor())

var messages = [JSQMessage]()

加入測試訊息

先塞一些假資料,確認介面正常。加一個刷新方法:

func reloadMessagesView() {
    self.collectionView?.reloadData()
}

再加一個 Setup 擴充:

// MARK: - Setup

extension ViewController {

    func addDemoMessages() {
        for i in 1...10 {
            let sender = (i % 2 == 0) ? "Server" : self.senderId
            let content = "Message nr. \(i)"
            let message = JSQMessage(senderId: sender, displayName: sender, text: content)
            self.messages += [message]
        }
        self.reloadMessagesView()
    }

    func setup() {
        self.senderId = UIDevice.currentDevice().identifierForVendor?.UUIDString
        self.senderDisplayName = UIDevice.currentDevice().identifierForVendor?.UUIDString
    }
}

setup 把裝置的 identifierForVendor 同時指派給 senderId 與 senderDisplayName。JSQMessagesViewController 需要這兩個值才能判斷「誰說的」與「說給誰聽」。這裡先用裝置識別,第三部分會改成使用者帳號。

在 viewDidLoad 中呼叫:

override func viewDidLoad() {
    super.viewDidLoad()
    self.setup()
    self.addDemoMessages()
}

此時執行 App,畫面還是空的——因為我們還沒實作資料來源協定。

實作 JSQMessagesViewController 協定

新增一個資料來源擴充:

// MARK: - Data Source

extension ViewController {

    override func collectionView(collectionView: UICollectionView,
                        numberOfItemsInSection section: Int) -> Int {
        return self.messages.count
    }

    override func collectionView(collectionView: JSQMessagesCollectionView!,
              messageDataForItemAtIndexPath indexPath: NSIndexPath!) -> JSQMessageData! {
        return self.messages[indexPath.row]
    }

    override func collectionView(collectionView: JSQMessagesCollectionView!,
                 didDeleteMessageAtIndexPath indexPath: NSIndexPath!) {
        self.messages.removeAtIndex(indexPath.row)
    }

    override func collectionView(collectionView: JSQMessagesCollectionView!,
        messageBubbleImageDataForItemAtIndexPath indexPath: NSIndexPath!) -> JSQMessageBubbleImageDataSource! {
        let data = messages[indexPath.row]
        switch data.senderId {
        case self.senderId: return self.outgoingBubble
        default:            return self.incomingBubble
        }
    }

    override func collectionView(collectionView: JSQMessagesCollectionView!,
              avatarImageDataForItemAtIndexPath indexPath: NSIndexPath!) -> JSQMessageAvatarImageDataSource! {
        return nil
    }
}

這幾個方法分別回答了:總共幾則訊息、每一列顯示哪一則、刪除時怎麼處理資料、每則要用哪種氣泡(自己發的靠右、用 outgoingBubble,其餘靠左),以及頭像顯示什麼(回傳 nil 代表不顯示)。

再執行一次,十則測試訊息就出來了。

處理工具列按鈕

如果現在點擊發送鈕,App 會直接崩潰——因為我們還沒實作對應的事件方法。

// MARK: - Toolbar

extension ViewController {

    override func didPressSendButton(button: UIButton!,
                                withMessageText text: String!,
                                       senderId: String!,
                              senderDisplayName: String!,
                                       date: NSDate!) {
        let message = JSQMessage(senderId: senderId,
                                 senderDisplayName: senderDisplayName,
                                 date: date,
                                 text: text)
        self.messages += [message]
        self.finishSendingMessage()
    }

    override func didPressAccessoryButton(sender: UIButton!) {
        // 左側的附件鈕暫時不做任何事,留空即可避免崩潰
    }
}

didPressSendButton 把輸入內容包成 JSQMessage 加入陣列,再呼叫 finishSendingMessage 讓 UI 完成捲動等收尾。didPressAccessoryButton 留空是為了讓 App 不崩潰,附件功能留待日後擴充。

小結

到這裡,聊天介面已經完成:可以輸入、發送,也能看到別人(測試資料)發來的訊息,左右氣泡與配色都到位了。但重新啟動 App 資料就會消失,而且沒有帳號概念——這些都是下一篇要解的題目。

本部分程式碼可在 GitHub 下載。有任何問題歡迎推特聯絡。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved