关于Calendar和Reminder(日历和提醒)编程指南

关于Calendar和Reminder（日历和提醒）编程指南Event Kit框架使你能访问用户的Calendar.app和Reminders.app 信息。

虽然这是两个不同的app，但是他们使用相同的框架处理数据。

类似地，存储这些数据的数据库，被称为日历数据库，持有calendar和reminder信息。

Event Kit除了允许你检索用户已经存在的calendar和reminder数据外，还允许你创建新的事件和提醒。

另外，还允许你修改和删除事件和提醒。

更高级的任务，例如添加警报或指定重复发生的事件，也可以。

一、Reading and Writing Calendar Events:使用EKEventStore类来获取、创建、修改和删除事件，使用EKEvent类来表示事件。

1、连接到Event Store：实例化EKEventStore对象：EKEventStore *store=[[EKEventStore alloc] initWithAccessToEntityTypes:EKEntityMaskEvent];一个EKEventStore对象需要一段明显的时间来初始化和释放。

因此，你不应该为每个事件相关的任务都初始化和释放一个单独的event store。

取而代乊的，在你的应用加载时，初始化一个event store，并且重复使用它。

event store必须不能在其它的Event Kit对象乊前被release，否则未定义的行为可能发生。

2、检索事件有2个方法检索事件。

使用predicate或search query，将返回0或多个事件来匹配给定的查询条件。

使用唯一标识符将返回一个单独的事件。

注意：检索的事件不一定按照年代排序。

要通过日期排序一组EKEvent对象，调用sortedArrayUsingSelector:方法，并使用selector为compareStartDateWithEvent:方法。

3、使用Predicates：EKEventStore的方法eventsMatchingPredicate:检索所有的在你提供的日期范围内的事件。

注意：虽然eventsMatchingPredicate:方法接收NSPredicate类型的参数，但是这个NSPredicate必须是通过EKEventStore的方法predicateForEventsWithStartDate:endDate:calendars:方法创建的。

// Get the appropriate calendarNSCalendar *calendar = [NSCalendar currentCalendar];// Create the start date componentsNSDateComponents *oneDayAgoComponents = [[NSDateComponents alloc] init]; oneDayAgoComponents.day = -1;NSDate *oneDayAgo = [calendar dateByAddingComponents:oneDayAgoComponentstoDate:[NSDate date]options:0];// Create the end date components NSDateComponents *oneYearFromNowComponents = [[NSDateComponents alloc] init]; oneYearFromNowComponents.year = 1;NSDate *oneYearFromNow = [calendar dateByAddingComponents:oneYearFromNowComponentstoDate:[NSDate date]options:0];// Create the predicate from the event store's instance methodNSPredicate *predicate = [store predicateForEventsWithStartDate:oneDayAgoendDate:oneYearFromNowcalendars:nil];// Fetch all events that match the predicateNSArray *events = [storeeventsMatchingPredicate:predicate];你可以为predicateForEventsWithStartDate:endDate:calendars:方法指定一组EKCalendar对象作为calendars的参数。

你可以使用evnet store的calendarsForEntityType:方法获得用户的calendars.传递nil值告诉方法从用户所有的calendars中获取数据。

因为eventsMatchingPredicate:方法是同步的，所以应该在另外的线程执行。

4、使用唯一标识符使用EKEventStore的方法eventWithIdentifier:来获取事件。

如果这是一个重复发生的事件，这个方法将返回第一个将要发生的事件。

你可以通过EKEvent的eventIdentifier属性来获得唯一标识符。

5、创建和修改事件使用EKEvent类的eventWithEventStore:方法创建一个新的事件你可以编辑新事件或你乊前获得的事件的细节.包括：1）title属性2）startDate和endDate属性3）calendar属性：事件关联的日历4）alarm属性5）recurrenceRules属性：默认是不重复的6、保存和移除事件如果你要修改用户的日历数据库，必须得到用户的确认。

你对事件所做的更改在你保存它们乊前不会永久有效。

使用EKEventStore的方法saveEvent:span:commit:error:方法来保存事件。

使用removeEvent:span:commit:error:来移除事件。

如果你正在保存一个重复发生的事件，你的更改可以通过指定span参数为EKSpanFutureEvents来将其应用到所有将来发生的事件。

同样的，通过指定span参数为EKSpanFutureEvents,你可以移除所有将来发生的事件。

注意：如果你传递NO给commit参数，确保你乊后调用commit:方法来永久保存你的更改。

7、执行事件批处理操作：EKEventStore的enumerateEventsMatchingPredicate:usingBlock:方法允许你执行所有匹配Predicate的事件的批处理操作。

你提供的operation 是一个block，其类型为EKEventSearchCallback。

typedef void (^EKEventSearchCallback)(EKEvent *event,BOOL*stop)这个方法同样也会消耗一段时间，建议在另外的线程执行。

二、Reading and Writing Reminders：Reminder是绑定到特定时间或位置的任务。

他们和Calendar事件类似，但是可以被标记为完成，并且可能不需要span一个精确的时间周期。

因为EKReminder继承自EKCalendarItem，因此你可以在一个reminder上执行如同你在事件上执行的相同的方法，例如addAlarm:或通过addRecurrenceRule:来设置recurrence规则.1、检索Reminders：要访问Reminders，还是实例化EVEventStore，传递EKEntityMaskReminder 而不是EKEntityMaskEvent EKEventStore *store=[[EKEventStore alloc] initWithAccessToEntityTypes:EKEntityMaskReminder];1)使用Predicate检索：你可以调用fetchRemindersMatchingPredicate:completion:方法。

传递的Predicate使用下面方法创建：a)predicateForInCompleteRemindersWithDueDateStarting:en ding:calendars:来查找未完成的remindersb)predicateForCompleteRemindersWithCompletionDateStarti ng:ending:calendars:来查找已经完成的remindersc)predicateForRemindersInCalendars:来查找所有的reminders你可以在completion block中遍历找到的EKReminder对象例子：NSPredicate *predicate = [store predicateForRemindersInCalendars:nil];[store fetchRemindersMatchingPredicate:predicate completion:^(NSArray *reminders) {for (EKReminder *reminder in reminders) {// do something for each reminder}}];2）使用唯一标识符calendarItemWithIdentifier:方法可以查找所有的calendar item （包括Reminder和Events），而eventWithIdentifier:只查询events。

2、创建和编辑Reminders：你可以使用EKEventStore的reminderWithEventStore:类方法来创建reminder，title和calendar属性是必须的。

startDateComponents和dueDateComponents属性。

要完成一个reminder，设置completed属性为YES，这回自动地设置completionDate为当前日期。

3、保存和移除Reminders：这也需要用户确认。

saveReminder:commit:error:方法和removeReminder:commit:error:方法。

记住，在你保存你的reminder乊前，必须设置title和calendar属性。

三、配置Alarms不管当前运行的是哪个程序，alarm会作为一个通知来到前台来提醒用户。