在前幾個(gè)月內(nèi)，我一直在做InboxKit的研究，它是關(guān)于Inbox平臺(tái)的IOS SDK。Inbox為和郵件數(shù)據(jù)的交互提供高層API，使得你可以忽略IMAP,Exchange,MIME的解析以及thread探測(cè)(當(dāng)然還有很多其他事情...)，并使你致力于完成富有創(chuàng)意的APP的創(chuàng)作上。我們的目標(biāo)很簡(jiǎn)單:盡可能地打造一個(gè)優(yōu)雅的，跨提供商的郵件應(yīng)用。畢竟，它很難。
在Objective-C中，InboxKit使得創(chuàng)建郵件體驗(yàn)變得很輕松，那么，Swift又如何呢？Swift在WWDC后已正式被IOS社區(qū)所采納，我認(rèn)為以后的SDK設(shè)計(jì)肯定會(huì)包括既有Objective-C又有Swift寫的樣例。
我們的第一個(gè)Swift例子，我想寫一個(gè)簡(jiǎn)單的app，它就像一個(gè)魔幻8球：
- 顯示Inbox中未讀thread
- 當(dāng)你搖動(dòng)手機(jī)，標(biāo)記thread為已讀并顯示新的thread
(譯者注：文中的thread并不是線程的意思，在論壇中的一個(gè)帖子叫thread，回復(fù)叫post.這里可理解為一封郵件)
在 Swift 中使用 Objective-C SDK
InboxKit有6000行Objective-C代碼，我們還不打算把他們都轉(zhuǎn)換成Swift。為了編譯我們的Swift郵件應(yīng)用，我更新了open-source SDK，包含了“Xcode 6 自定義框架“。自定義框架是Xcode6的新特色-支持第三方框架的創(chuàng)建和分發(fā)。當(dāng)DEFINES_MODULE標(biāo)志設(shè)置為可用時(shí)，自定義框架會(huì)自動(dòng)為Swift準(zhǔn)備Objective-C模塊的頭文件。在Swift編譯時(shí)，它會(huì)讀取這個(gè)模塊頭文件，把Objective-C的類和方法映射到Swift。
Cocoa Touch框架包含這個(gè)SDK之后，在Swift中使用很簡(jiǎn)單。比如我創(chuàng)建了一個(gè)新的Swift應(yīng)用，只需要把這個(gè)SDK拖入工程中，然后在root view controller中添加import InboxKit。
Xcode 6 自定義框架非常棒, 可是目前只有Xcode 6和iOS 8支持. 如果你正在開發(fā)一款應(yīng)用程序, 你仍然可以選擇pod InboxKit。
查看郵件
InboxKit 讓我們從Inbox同步引擎獲取郵件數(shù)據(jù)變得簡(jiǎn)單起來(lái)。我們實(shí)例化一個(gè) INThreadProvider ，以此展示來(lái)自我們郵箱賬號(hào)的線程，并且具象化需要的數(shù)據(jù)。供應(yīng)者模型 是InboxKit的一個(gè)核心概念： 他們被用于獲取線程，信息，聯(lián)系人和更多東西的集合 。供應(yīng)者有點(diǎn)類似于Core Data中的 NSManagedObjectContext 和 YapDatabase的視圖——他們把復(fù)雜的東西封裝在內(nèi)部，只是暴露出一個(gè)結(jié)果集，這個(gè)結(jié)果集是基于你提供的配置。 在InboxKit，供應(yīng)者從本地SQLite store拉取緩存數(shù)據(jù),同時(shí)，讓對(duì)于Inbox API 的詢問(wèn)變得透明。
我們的應(yīng)用將展示來(lái)自Inbox的未讀線程，每次一個(gè)，所以我們這樣定義線程供應(yīng)者：
provider.itemFilterPredicate = NSComparisonPredicate(format: "ANY tagIDs = %@", INTagIDInbox)
provider.itemSortDescriptors = [NSSortDescriptor(key: "lastMessageDate", ascending: false)]
provider.delegate = self
self.threadProvider = provider
由于我們已經(jīng)創(chuàng)建了一個(gè)線程供應(yīng)者,我們就可以使用它的條目數(shù)組來(lái)存放我們的視圖. 供應(yīng)者不會(huì)同步獲取結(jié)果集, 所以我們需要實(shí)現(xiàn)INModelProviderDelegate協(xié)議并監(jiān)聽更新. 當(dāng)新的線程通過(guò)以下方式被創(chuàng)建的時(shí)候,供應(yīng)者會(huì)調(diào)用-providerDataChanged 方法,這些創(chuàng)建新線程的方式包括:1.從緩存從獲取 2.通過(guò)API加載 3.(某個(gè)時(shí)間)通過(guò)網(wǎng)絡(luò)數(shù)據(jù)包被推送到應(yīng)用. 實(shí)現(xiàn)協(xié)議確保了我們的應(yīng)用總是顯示最新的數(shù)據(jù).
還有其他一些代理方法,比如 providerDataAltered:它讓基于UICollection或者
UITableView創(chuàng)建郵箱用戶界面變得更簡(jiǎn)單,同時(shí)可以使用各種插入刪除動(dòng)畫效果.但是目前,我們繼續(xù)看一些基礎(chǔ)的東西.
var items = self.threadProvider!.items
if items.count == 0 {
// display empty state
self.subjectLabel.text = "No unread threads!"
self.snippetLabel.text = ""
self.participantsLabel.text = ""
self.dateLabel.text = ""
}
if let thread = items[0] as? INThread {
// display the thread
self.subjectLabel.text = thread.subject
self.snippetLabel.text = thread.snippet
self.dateLabel.text = formatter.stringFromDate(thread.lastMessageDate);
....
}}func providerDataChanged(provider: INModelProvider!) {
self.refreshInterface()}func provider(provider: INModelProvider!, dataFetchFailed error: NSError!) {
self.displayError(error);}
標(biāo)記為已讀
在我們的 swift 示例程序中,我們要在用戶搖動(dòng)手機(jī)的時(shí)候，把當(dāng)前線程標(biāo)記為已讀,并且顯示一個(gè)新的線程。用InboxKit，標(biāo)記為已讀是非常簡(jiǎn)單的。
if (motion == UIEventSubtype.MotionShake) {
var items = self.threadProvider!.items
if let thread = items[0] as? INThread {
thread.markAsRead()
}
}}
在后臺(tái),-markAsReadqueues這個(gè)方法使新的API動(dòng)作進(jìn)入隊(duì)列，通過(guò)這種行為來(lái)從線程中移除未讀標(biāo)簽。 INThread對(duì)象和本地存儲(chǔ)的數(shù)據(jù)會(huì)被立刻更新,但是這個(gè)動(dòng)作將會(huì)在手機(jī)上排隊(duì)，直到可以建立
連接。如果服務(wù)器拒絕這次的動(dòng)作，那么本地的數(shù)據(jù)也會(huì)回滾。
我們不需要刷新我們的線程供應(yīng)者-我們的工作已經(jīng)完成！如果當(dāng)前線程被標(biāo)記為已讀，那么它就不再需要滿足我們線程供應(yīng)者結(jié)果集的標(biāo)準(zhǔn).供應(yīng)者會(huì)自動(dòng)
匹配它的內(nèi)容，并且調(diào)用providerDataChanged方法,我們實(shí)現(xiàn)的代理方法將會(huì)刷新我們顯示，來(lái)展現(xiàn)新集合中的第一個(gè)線程。
接下來(lái)的步驟
好了! 只用了幾十行代碼,我們就創(chuàng)建了一個(gè)示例程序,它可以從我們的收件箱一條條的獲取線程,并且讓我們標(biāo)記為已讀.現(xiàn)在它僅僅需要點(diǎn)動(dòng)畫和潤(rùn)色.你可以從這里查看demo的源碼:
: SwiftEightBall Sample App
我們僅僅接觸了InboxKit的一些淺顯的東西.在IOS SDK的上層創(chuàng)建我們的swift應(yīng)用,這意味著我們需要為模型獲取本地類的支持,比如線程和通訊錄,
以及因?yàn)橹С盅訒r(shí)線程和消息動(dòng)作的SQLite而變得更強(qiáng)大的離線緩存.
看看iOS SDK documentation 學(xué)習(xí)一下更多關(guān)于在郵件上層創(chuàng)建美觀大方應(yīng)用的知識(shí).
