Local Notification

大家都知道Push Notification，这个东西需要联网才可以用。iOS4起，苹果引入了一种可以在设备内部引发的notification。不需要复杂的服务器编程，或其他复杂的配置。这个技术就是Local Notification。

Local notificaton可以在用户设定里定时触发。甚至，你可以设定重发。下面，我们就来研究下Local Notification，看看如何设定，查看和处理Local Notification。

1. 创建项目

总体来说是这么个效果：

一共分三层，最上面一层是DatePicker。用于选择出发Local Notification的时间。第二层是一个TextField，用于设定Notification的title。最后是设定过的Notification都放在一个TableView里。看看都有什么：

    UIDatePicker *datePicker = [[UIDatePicker alloc] initWithFrame:CGRectMake(0, 44, 320, 160)];
    [self.view addSubview:datePicker];

    UITextField *textField = [[UITextField alloc] initWithFrame:CGRectMake(0, 227, 150, 40)];
    [self.view addSubview:textField];
    textField.borderStyle = UITextBorderStyleRoundedRect;
    textField.placeholder = @"Input Text";
    self.textField = textField;

    UIButton *saveButton = [[UIButton alloc] initWithFrame:CGRectMake(155, 227, 160, 40)];
    [self.view addSubview:saveButton];
    saveButton.backgroundColor = [UIColor orangeColor];
    [saveButton setTitle:@" SAVE " forState:UIControlStateNormal];
    [saveButton addTarget:self action:@selector(saveAction:) forControlEvents:UIControlEventTouchUpInside];

    CGFloat height = [UIScreen mainScreen].bounds.size.height - 242;
    UITableView *notiTableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 268, 320, height)];
    [self.view addSubview:notiTableView];
    notiTableView.delegate = self;
    notiTableView.dataSource = self;

与UI元素对应的，我们这里有三层，四个界面元素。同事还有Button的一个action。同事需要注意的是，我们需要在Controller里实现UITableViewDelegate和UITableViewDataSource这两个protocol。要是用UITableView这两个protocol必须实现。

其他还要做一些必要的操作。比如创建一个空的设定notification的方法，等。

#pragma mark - Private methods

- (void)saveAction:(id)sender{
    DLog(@"");
    [self.textField resignFirstResponder];
}

#pragma mark - UITableViewDelegate & datasource

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
    return ;
}

- (UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier];
    }

    return cell;
}

在saveAction方法中，设定notification时退出textfield的编辑状态并隐藏键盘。所以，需要调用resignFirestResponder方法，[self.textField resignFirstResponder]。

后面的UITableView相关的protocol中，暂时指定返回的行数为1，并在返回Cell的方法中返回没有设定任何内容的行。这样，代码就可以正常运行。否则，会因为没有实现必要的protocol方法而crash。

这个时候，在运行app之后就会出现上面给出的效果图。（注意：这里用的是真机运行的app）

2. 设定notification

这里是全教程的核心所在了。折腾完全文也都是基于这里所讲的内容。

首先，在DatePicker里设定好时间。之后在设定notification的内容。最后把指定推送在指定的时间引发。

- (void)saveAction:(id)sender{
    DLog(@"");
    [self.textField resignFirstResponder];

    NSDate *pickerDate = [self.datePicker date];

    UILocalNotification *localNotification = [[UILocalNotification alloc] init];
    if (localNotification) {
        localNotification.fireDate = pickerDate;//fireDate;
        localNotification.timeZone = [NSTimeZone defaultTimeZone];
        localNotification.alertBody = self.textField.text;
        localNotification.alertAction = @"View";
        localNotification.soundName = UILocalNotificationDefaultSoundName;
        localNotification.applicationIconBadgeNumber = 1;
        localNotification.userInfo = @{@"userId": @"best user", @"userName": @"Jack"};
        [[UIApplication sharedApplication] scheduleLocalNotification:localNotification];

        [self.notificationTableView reloadData];
    }
}

就如前文所述，使用NSDate *pickerDate = [self.datePicker date]; 获取到DatePicker中设定的日期，之后在Local notification对象的fireDate属性里赋值。localNotification.alertBody = self.textField.text设定提示的文本。使用localNotification.userInfo = @{@"userId": @"best user", @"userName": @"Jack"}设定用户信息，就是你觉得有用的信息以字典的方式存放在notification对象中，在其他的时候可以获取这个字典。最后，最关键的就是使用[[UIApplication sharedApplication] scheduleLocalNotification:localNotification]设定notification在指定的时间触发。

到这里，就可以指定一个Local notification在给定的时间触发了。但是还有一种场景，在用户做了某个操作的时候，notification立刻触发。这时，再用schecule的方法就会很奇怪，schedule一秒可能赶不上，schedule的秒多了可能错过正确的提示时机。所以API里提供了另一个方法presentNow，提示立刻触发。正确的立刻触发的方法是：[[UIApplication sharedApplication] presentLocalNotificationNow:localNotification]。其他初始化和设定相关属性的方法都没有任何的变化。

3. 把设定过的notification都现实在TableView里

之前使用了一些dummy的方法，只是为了能让app正常的运行。这里补全所有必要的代码。

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
    return [[UIApplication sharedApplication] scheduledLocalNotifications].count;
}

- (UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier];
    }

    NSArray *notifications = [[UIApplication sharedApplication] scheduledLocalNotifications];
    UILocalNotification *n = notifications[indexPath.row];

    cell.textLabel.text = n.alertBody;
    cell.detailTextLabel.text = [n.fireDate description];

    return cell;
}

[[UIApplication sharedApplication] scheduledLocalNotifications]包含了全部的schedule过了的notification数组，count属性就是数量。在- (UITableViewCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath中从notification数组中取出对应元素，显示在UITableView的Cell中，分别是：cell.textLabel.text = n.alertBody, cell.detailTextLabel.text = [n.fireDate description]。

最后

似乎是一切都完美了。notification也有了，可以通过界面的DatePicker指定时间，可以立即触发，还可以指定提示的内容。而且，还会在“铛”的一声，然后在app的图标上显示一个badge number出来。但是，当你点击了提示之后，进入到app里再出来你会发现。。。。。。badge number还是华丽丽的在那里木有消失。是的本来应该点开了notification之后就消失的，这是为什么呢。处理badge number的代码也需要我们手动的写出来。最后我们来处理这一部分的功能。

这里需要注意到两种情况：1. 设定好了notification的出发时间以后，app退出了。这个退出是说双击home键以后，上滑了这个app，终止了app进程。2. app还在运行着，也许是在触发notification的时候app还在运行中，或者app的进程还在运行中。

第一种情况：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];

    BVRootViewController *rootViewController = [[BVRootViewController alloc] init];
    UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:rootViewController];
    self.window.rootViewController = nav;

    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];

    application.applicationIconBadgeNumber = 0;

    UILocalNotification *n = [launchOptions objectForKey:UIApplicationLaunchOptionsLocalNotificationKey];
    if (n) {
        DLog(@"Received notification %@", n);
    }

    return YES;
}

第二种情况：

- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{
    application.applicationIconBadgeNumber = 0;
    DLog(@"Received notification %@", notification);
}

哦了！