用Swift构建一个简单的iOS邮件应用的方法
在前几个月内,我一直在做InboxKit的研究,它是关于Inbox平台的IOSSDK。Inbox为和邮件数据的交互提供高层API,使得你可以忽略IMAP,Exchange,MIME的解析以及thread探测(当然还有很多其他事情...),并使你致力于完成富有创意的APP的创作上。我们的目标很简单:尽可能地打造一个优雅的,跨提供商的邮件应用。毕竟,它很难。
在Objective-C中,InboxKit使得创建邮件体验变得很轻松,那么,Swift又如何呢?Swift在WWDC后已正式被IOS社区所采纳,我认为以后的SDK设计肯定会包括既有Objective-C又有Swift写的样例。
我们的第一个Swift例子,我想写一个简单的app,它就像一个魔幻8球:
- 显示Inbox中未读thread
- 当你摇动手机,标记thread为已读并显示新的thread
(译者注:文中的thread并不是线程的意思,在论坛中的一个帖子叫thread,回复叫post.这里可理解为一封邮件)
在Swift中使用Objective-CSDK
InboxKit有6000行Objective-C代码,我们还不打算把他们都转换成Swift。为了编译我们的Swift邮件应用,我更新了open-sourceSDK,包含了“Xcode6自定义框架“。自定义框架是Xcode6的新特色-支持第三方框架的创建和分发。当DEFINES_MODULE标志设置为可用时,自定义框架会自动为Swift准备Objective-C模块的头文件。在Swift编译时,它会读取这个模块头文件,把Objective-C的类和方法映射到Swift。
CocoaTouch框架包含这个SDK之后,在Swift中使用很简单。比如我创建了一个新的Swift应用,只需要把这个SDK拖入工程中,然后在rootviewcontroller中添加importInboxKit。
Xcode6自定义框架非常棒,可是目前只有Xcode6和iOS8支持.如果你正在开发一款应用程序,你仍然可以选择podInboxKit。
查看邮件
InboxKit让我们从Inbox同步引擎获取邮件数据变得简单起来。我们实例化一个INThreadProvider,以此展示来自我们邮箱账号的线程,并且具象化需要的数据。供应者模型是InboxKit的一个核心概念:他们被用于获取线程,信息,联系人和更多东西的集合。供应者有点类似于CoreData中的NSManagedObjectContext和YapDatabase的视图——他们把复杂的东西封装在内部,只是暴露出一个结果集,这个结果集是基于你提供的配置。在InboxKit,供应者从本地SQLitestore拉取缓存数据,同时,让对于InboxAPI的询问变得透明。
我们的应用将展示来自Inbox的未读线程,每次一个,所以我们这样定义线程供应者:
varprovider:INThreadProvider!=namespace?.newThreadProvider(); provider.itemFilterPredicate=NSComparisonPredicate(format:"ANYtagIDs=%@",INTagIDInbox) provider.itemSortDescriptors=[NSSortDescriptor(key:"lastMessageDate",ascending:false)] provider.delegate=self self.threadProvider=provider
由于我们已经创建了一个线程供应者,我们就可以使用它的条目数组来存放我们的视图.供应者不会同步获取结果集,所以我们需要实现INModelProviderDelegate协议并监听更新.当新的线程通过以下方式被创建的时候,供应者会调用-providerDataChanged方法,这些创建新线程的方式包括:1.从缓存从获取2.通过API加载3.(某个时间)通过网络数据包被推送到应用.实现协议确保了我们的应用总是显示最新的数据.
还有其他一些代理方法,比如providerDataAltered:它让基于UICollection或者
UITableView创建邮箱用户界面变得更简单,同时可以使用各种插入删除动画效果.但是目前,我们继续看一些基础的东西.
funcrefreshInterface(){ varitems=self.threadProvider!.items ifitems.count==0{ //displayemptystate self.subjectLabel.text="Nounreadthreads!" self.snippetLabel.text="" self.participantsLabel.text="" self.dateLabel.text="" } ifletthread=items[0]as?INThread{ //displaythethread self.subjectLabel.text=thread.subject self.snippetLabel.text=thread.snippet self.dateLabel.text=formatter.stringFromDate(thread.lastMessageDate); .... }}funcproviderDataChanged(provider:INModelProvider!){ self.refreshInterface()}funcprovider(provider:INModelProvider!,dataFetchFailederror:NSError!) { self.displayError(error);}
标记为已读
在我们的swift示例程序中,我们要在用户摇动手机的时候,把当前线程标记为已读,并且显示一个新的线程。用InboxKit,标记为已读是非常简单的。
overridefuncmotionEnded(motion:UIEventSubtype,withEventevent:UIEvent!){ if(motion==UIEventSubtype.MotionShake){ varitems=self.threadProvider!.items ifletthread=items[0]as?INThread{ thread.markAsRead() } }}
在后台,-markAsReadqueues这个方法使新的API动作进入队列,通过这种行为来从线程中移除未读标签。INThread对象和本地存储的数据会被立刻更新,但是这个动作将会在手机上排队,直到可以建立
连接。如果服务器拒绝这次的动作,那么本地的数据也会回滚。
我们不需要刷新我们的线程供应者-我们的工作已经完成!如果当前线程被标记为已读,那么它就不再需要满足我们线程供应者结果集的标准.供应者会自动
匹配它的内容,并且调用providerDataChanged方法,我们实现的代理方法将会刷新我们显示,来展现新集合中的第一个线程。
接下来的步骤
好了!只用了几十行代码,我们就创建了一个示例程序,它可以从我们的收件箱一条条的获取线程,并且让我们标记为已读.现在它仅仅需要点动画和润色.你可以从这里查看demo的源码:
:SwiftEightBallSampleApp
我们仅仅接触了InboxKit的一些浅显的东西.在IOSSDK的上层创建我们的swift应用,这意味着我们需要为模型获取本地类的支持,比如线程和通讯录,
以及因为支持延时线程和消息动作的SQLite而变得更强大的离线缓存.
看看iOSSDKdocumentation学习一下更多关于在邮件上层创建美观大方应用的知识.