用 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 ，熟悉一下这个新来的小伙伴^_^

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