用 Swift 开发一个 TODO 应用

背景

相信不少 iOS 程序员对于 Swift 依旧持以观望的态度，一来是这小家伙刚出来没几天，本身还处于完善的阶段；二来是学习的成本较高，看完官方文档怎么也要个几天的时间；三来是反正最近几年很难在工程项目里推广使用，工作又用不到，那我学个锤子呐。

是的，我一开始也是这么想的。直到有一天，我遇到了它：Swift Tutorial - To Do List App。这是 YouTube 上的一个很好地视屏教程，手把手教你如何完成一个 TODO 的应用，功能很简单，就是添加任务和浏览任务。将视屏内容整理了一下。虽然没有什么高深的内容，但是作为一个入门的小程序还是挺适合的。

适用人群：有一定 Objective-C 的开发基础但是还没怎么接触 Swift 不过装有 Xcode6 想感受一下的 iOS 开发者。

客官，都看到这里了，何不打开 Xcode6 耍两把？玩一玩噻！来吧。来嘛！

需求

我们想做一个很简单的小东西，和官网的 Demo 一样，是一个 TODO 列表 (TODO：待办事项) ，具有以下功能：

有一个列表显示 TODO
有一个页面添加 TODO
点击添加按钮，在列表显示新的 TODO 列表

揍是这么简单，让我们开始吧！

新建项目

新建一个项目，选择 Tabbed Application 模板，项目名称为：MyTodoList。记得选中 Swift 作为开发语言。Xcode 会创建一个 Swift 的项目：

添加管理类

我们需要的第一个类是一个 TodoList 的管理器，用来存储 TODO 列表的数据，进行一些增删改查的基本操作。我们将其命名为 TodoManager 。

在左侧文件夹上右击，选择 New File，选择 Cocoa Class ，类名为 TodoManager ，继承自 NSObject ， Xcode 会自动为我们添加一个 TodoManager.swift 文件。

我们在 Swift 里定义的变量和函数都是全局属性的，这样我们可以在类的外面定义一个 TodoManager 的对象todoManager，简单的实现了单例模式：

import UIKit

var todoManager : TodoManager = TodoManager ()

class TodoManager: NSObject {

}

接下来定义一个结构体 (struct) 来表示一个 TODO 项，它有两个属性，一个是任务名称，一个是任务描述：

struct todo {

    var name = "Un-Named"

    var desc = "Un-Described"

}

在 TodoManager 里面添加一个 todos 数组，用来存储所有的任务：

class TodoManager: NSObject {

    var todos = [todo]()

}

最后定义一个方法 addTask ，用来添加任务：

class TodoManager: NSObject {

    var todos = [todo]()

    func addTask(name: String, desc: String) {

        todos.append(todo(name: name, desc: desc))

    }

}

OK，这样 TodoManager 就算基本完成了。

开发界面

回到 StoryBoard ，我们把页面上系统自动生成的内容 (几个Label) 删除：

然后加个 UITableView 到 FirstViewController 上：

选中 Tab Bar ，可以编辑 Tab Bar 的显示名称和图片：

接下来看下 Second View 。把第二个 Tab Bar 的 Title 改成 Add ：

这样基本的页面就算是搞定了。

数据显示

First View Controller

在第一个 Tab 下，将鼠标移到 UITableView 上，按住鼠标右键拖动到 View Controller 上，选择 DataSource 和 Delegate ：

回到代码里，打开 FirstViewController.swift 文件，添加 UITableViewDelegate 和 UITableViewDataSource 这两个协议。按住 Command 键点击协议名称可以查看协议的声明，从而知道需要实现那些方法。方法名称和 OC 中的完全相同，只需要转换成 Swift的语法即可。完成之后的 FirstViewController 是这个样子：

class FirstViewController: UIViewController, UITableViewDelegate, UITableViewDataSource

{

    override func viewDidLoad() {

        super.viewDidLoad()

        // Do any additional setup after loading the view, typically from a nib.

    }

    override func didReceiveMemoryWarning() {

        super.didReceiveMemoryWarning()

        // Dispose of any resources that can be recreated.

    }

    // UITableView DataSource

    func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {

        return todoManager.todos.count;

    }

    func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {

        let cell: UITableViewCell = UITableViewCell(style: UITableViewCellStyle.Subtitle, reuseIdentifier: "Default")

        cell.textLabel?.text = todoManager.todos[indexPath.row].name

        cell.detailTextLabel?.text = todoManager.todos[indexPath.row].desc

        return cell

    }

}

Second View Controller

拖拽一些控件搭建下基本的框架，一个 Label 作为标题，两个 TextField 分别填写 TODO 的名称和描述，然后再加上添加按钮，基本的框架时候是这个样子的：

然后我们把这两个 TextField 的 Delegate 都指向 View Controller ，因为我们希望在我们输入完成点击 Return 之后，键盘会自动弹回去。在 SecondViewController.swift 里面添加 UITextFieldDelegate 并实现 textFieldShouldReturn 委托方法，在方法里，通过 resignFirstResponder 把键盘弹回去：

// UITextField Delegate

func textFieldShouldReturn(textField: UITextField) -> Bool {

    textField.resignFirstResponder()

    return true

}

我们希望用户在点击背景图片的时候就可以把键盘收回来，我们可以重写 touchsBegan 方法，在里面加上 endEditing方法：

override func touchesBegan(touches: NSSet, withEvent event: UIEvent) {

    self.view.endEditing(true)

}

定义两个属性来获取文本框中的值，切换到 Assistant 视图，通过鼠标右键拖拽新建两个变量：

然后我们再新建一个 IBAction ，用来处理 Add 按钮的点击事件：

在点击事件里，我们希望完成以下任务：

在 todoManager 里面添加一个 TODO 项
把键盘收起
清空 TextField 中的内容
TabBar 切换到 TODO 那个标签下，即时查看结果

OK完成之后的 addBtnClick 方法如下：

@IBAction func addBtnClick(sender: AnyObject) {

    todoManager.addTask(todoText.text, desc: descText.text)

    self.view.endEditing(true)

    todoText.text = ""

    descText.text = ""

    self.tabBarController?.selectedIndex = 0

}

这样，添加 TODO 的任务就完成了。

删除数据

删除数据和 Objective-C 版本的接口是完全一样的，通过 commitEditingStyle 方法实现。打开 FirstViewController.swift 文件，先在代码中添加一个 TableView 的属性，方便我们刷新数据：

删除其实也就是删除掉 todoManager 的 todos 数组里面的对应数据而已，我们可以用 removeAtIndex 实现，记得reloadData 刷新 TableView：

func tableView(tableView: UITableView, commitEditingStyle editingStyle: UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {

    if(editingStyle == UITableViewCellEditingStyle.Delete) {

        todoManager.todos.removeAtIndex(indexPath.row)

    }

    todoTableView.reloadData()

}

测试

基本的开发工作到此就结束啦，我们可以运行应用跑跑看。

首先添加一个 TODO：

点击 Add 之后可以看到 TableView 里已经有了添加的 TODO 项：

滑动可以看到删除按钮：

点击删除，删除成功：

小结

不知道各位看到这里感觉如何，反正我感觉：水爆了！也没什么深奥的技术点，也没什么创新的东西，就是一个中规中矩的小应用而已。

是的，确实这样。不过希望通过这样一个简单的例子可以和大家一起熟悉一下 Swift ，熟悉一下这个新来的小伙伴^_^

完整的项目源码可以点击这里下载。玩的开心。

巴特西