下面我們來討論如何在 iOS 中創建日歷事件,主要涉及 EventKit 框架。
首先需要為工程添加框架。點擊工程查看屬性,在 Linked Frameworks and Libraries 中增加 EventKit 框架,並將其拖動到 Frameworks 文件夾:
下面是一個創建日歷事件的按鈕事件:
- (IBAction)addEvent:(id)sender {
// 創建一個新的事件
EKEvent *event = [EKEvent eventWithEventStore:store];
// 創建開始與結束日期
NSDate *startDate = [[NSDate alloc] init];
NSDate *endDate = [[NSDate alloc] init];
// 設置事件屬性
[event setTitle:@"an insert title"];
[event setStartDate:startDate];
[event setEndDate:endDate];
[event setAllDay:YES];
// 將新事件插入默認日歷
EKCalendar *calendar = [store defaultCalendarForNewEvents];
[event setCalendar:calendar];
// 創建 NSError 指針
NSError *err = nil;
// 保存事件
[store saveEvent:event span:EKSpanThisEvent error:&err];
if (err == nil) {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Congratulations" message:@"event create success." delegate:nil cancelButtonTitle:@"ok" otherButtonTitles:nil];
[alert show];
} else {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Failed" message:@"event create failed." delegate:nil cancelButtonTitle:@"ok" otherButtonTitles:nil];
[alert show];
}
}
在 iOS 6 以上版本中,我們需要對訪問權限進行授權。頭文件中:
#import <UIKit/UIKit.h>
#import <EventKit/EventKit.h>
@interface ViewController : UIViewController
- (IBAction)addEvent:(id)sender;
@property EKEventStore *store;
@property (strong, nonatomic) IBOutlet UIButton *myTestButton;
@end
.m 文件:
@implementation ViewController
@synthesize store;
@synthesize myTestButton;
- (void)viewDidLoad
{
[super viewDidLoad];
// 獲取 Event Store
store = [[EKEventStore alloc] init];
[self requestCalendarAccess];
}
// 用戶授予日歷權限後回調
-(void)accessGrantedForCalendar
{
// 更新 UI
[myTestButton setEnabled:YES];
}
// 提示用戶授予日歷訪問權限
-(void)requestCalendarAccess
{
[store requestAccessToEntityType:EKEntityTypeEvent completion:^(BOOL granted, NSError *error)
{
if (granted)
{
// 確保代碼在主線程隊列中執行
dispatch_async(dispatch_get_main_queue(), ^{
[self accessGrantedForCalendar];
});
}
}];
}
@end
下面我們看一個更復雜的例子。
@synthesize window;。MasterViewController 的核心代碼如下:
@implementation MasterViewController;
@synthesize store;
@synthesize eventArray;
@synthesize canDealWithEvent;
// 請求獲取日歷應用的部分權限
-(void)requestCalendarAccess {
[store requestAccessToEntityType:EKEntityTypeEvent completion:^(BOOL granted, NSError *error) {
if (granted) {
dispatch_sync(dispatch_get_main_queue(), ^{
NSLog(@"gain event access");
self.canDealWithEvent = YES;
});
} else {
dispatch_sync(dispatch_get_main_queue(), ^{
NSLog(@"we haven't got any event access, so we can do nothing except exit.");
self.canDealWithEvent = NO;
});
}
}];
}
// 刷新事件數組
-(void)refreshEventArray {
if (canDealWithEvent == YES) {
return ;
}
// 從現在開始
NSDate *startDate = [NSDate date];
// 從現在開始的一個月時間
NSDateComponents *tomorrowDateComponents = [[NSDateComponents alloc] init];
tomorrowDateComponents.month = 1;
NSDate *endDate = [[NSCalendar currentCalendar] dateByAddingComponents:tomorrowDateComponents
toDate:startDate options:0];
// 僅搜索默認日歷對象
NSArray *calendarArray = [NSArray arrayWithObject:self.store.defaultCalendarForNewEvents];
NSPredicate *predicate = [self.store predicateForEventsWithStartDate:startDate
endDate:endDate calendars:calendarArray];
// 搜索滿足斷言的事件
eventArray = [NSMutableArray arrayWithArray:[self.store eventsMatchingPredicate:predicate]];
}
- (void)viewDidLoad
{
[super viewDidLoad];
canDealWithEvent = NO;
store = [[EKEventStore alloc] init];
[self requestCalendarAccess];
[self refreshEventArray];
self.navigationItem.leftBarButtonItem = self.editButtonItem;
UIBarButtonItem *addButton = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemAdd target:self action:@selector(insertNewObject:)];
self.navigationItem.rightBarButtonItem = addButton;
}
插入新事件的 insertNewObject: 方法與簡單示例類似,只是保存成功後會更新 eventArray 並刷新 TableView。表格視圖的相關方法則根據 eventArray 的數量與內容展現事件標題。通過 prepareForSegue: 可在切換到詳情頁時把選中的事件傳遞過去。
Apple 的示例代碼可參考 SimpleEKDemo。