EventKit 是 iOS 存取系統日曆與提醒事項的官方框架。操作提醒(EKReminder)比操作事件(Event)單純一些,但同樣要先取得授權。以下分三段說明新增、修改與刪除。
流程是:輸入提醒內容 → 選時間 → 按「儲存」,資料就會寫進系統的「提醒事項」。
這裡有個小技巧:把日期輸入框的 inputView 換成 UIDatePicker,點一下文字框底部就會自動彈出日期選擇器,不必另外做彈窗。
幾個重點:
EKEventStore,它是所有操作的入口。requestAccessToEntityType(.Reminder) 取得授權,回呼裡的 granted 決定後續能不能繼續。EKReminder 後設定 title、dueDateComponents 與 calendar,最後 saveReminder(commit: true)。NSDateComponents,所以要把 UIDatePicker 給的 NSDate 轉成年月日時分。import UIKit
import EventKit
class ViewController: UIViewController {
var eventStore: EKEventStore!
//提醒信息文本框
@IBOutlet weak var reminderTextField: UITextField!
//提醒時間文本框
@IBOutlet weak var dateTextField: UITextField!
//提醒日期選擇器
var datePicker: UIDatePicker!
override func viewDidLoad() {
super.viewDidLoad()
self.eventStore = EKEventStore()
//設置提醒時間文本框使用的日期選擇器
datePicker = UIDatePicker()
datePicker.addTarget(self, action: #selector(ViewController.addDate),
forControlEvents: .ValueChanged)
datePicker.datePickerMode = UIDatePickerMode.DateAndTime
dateTextField.inputView = datePicker
}
//日期選擇器響應方法
func addDate(){
//日期樣式
let formatter = NSDateFormatter()
formatter.dateFormat = "yyyy年MM月dd日 HH:mm"
//更新提醒時間文本框
self.dateTextField.text = formatter.stringFromDate(datePicker.date)
}
//保存按鈕響應辦法
@IBAction func addReminder(sender: AnyObject) {
//獲取"提醒"的訪問授權
self.eventStore.requestAccessToEntityType(EKEntityType.Reminder) {
(granted: Bool, error: NSError?) -> Void in
//創建提醒條目
let reminder = EKReminder(eventStore: self.eventStore)
reminder.title = (self.reminderTextField.text)!
let dueDateComponents = self.dateComponentFromNSDate(self.datePicker.date)
reminder.dueDateComponents = dueDateComponents
reminder.calendar = self.eventStore.defaultCalendarForNewReminders()
//保存提醒事項
do {
try self.eventStore.saveReminder(reminder, commit: true)
print("保存成功!")
}catch{
print("創建提醒失敗: \(error)")
}
}
}
//根據NSDate獲取對應的NSDateComponents對象
func dateComponentFromNSDate(date: NSDate)-> NSDateComponents{
let calendarUnit: NSCalendarUnit = [.Minute, .Hour, .Day, .Month, .Year]
let dateComponents = NSCalendar.currentCalendar().components(calendarUnit,
fromDate: date)
return dateComponents
}
}
修改的邏輯跟新增幾乎一樣,只是多了「先找出要改的那筆」這個步驟。用 predicateForRemindersInCalendars(nil) 搭配 fetchRemindersMatchingPredicate 就能拿到全部提醒,遍歷後改標題或時間,再呼叫 saveReminder 存回。
下面範例把系統裡所有提醒的標題都改成本站的宣傳文字:
//獲取"提醒"的訪問授權
self.eventStore.requestAccessToEntityType(EKEntityType.Reminder) {
(granted: Bool, error: NSError?) -> Void in
if granted{
// 獲取授權後,我們可以得到所有的提醒事項
let predicate = self.eventStore.predicateForRemindersInCalendars(nil)
self.eventStore.fetchRemindersMatchingPredicate(predicate, completion: {
(reminders: [EKReminder]?) -> Void in
//遍歷所有提醒並修改
for reminder in reminders! {
reminder.title = "歡迎訪問hangge.com"
reminder.calendar = self.eventStore.defaultCalendarForNewReminders()
//保存提醒事項
do {
try self.eventStore.saveReminder(reminder, commit: true)
print("保存成功!")
}catch{
print("保存失敗: \(error)")
}
}
})
}else{
print("獲取提醒失敗!需要授權允許對提醒事項的訪問。")
}
}
同樣先取得 Reminder 物件,改用 removeReminder(commit: true) 即可。以下範例會清空系統裡的所有提醒,實機測試時請留意這是破壞性操作。
//獲取"提醒"的訪問授權
self.eventStore.requestAccessToEntityType(EKEntityType.Reminder) {
(granted: Bool, error: NSError?) -> Void in
if granted{
let predicate = self.eventStore.predicateForRemindersInCalendars(nil)
self.eventStore.fetchRemindersMatchingPredicate(predicate, completion: {
(reminders: [EKReminder]?) -> Void in
//遍歷所有提醒並刪除
for reminder in reminders! {
do {
try self.eventStore.removeReminder(reminder, commit: true)
print("刪除成功!")
}catch{
print("刪除失敗: \(error)")
}
}
})
}else{
print("獲取提醒失敗!需要授權允許對提醒事項的訪問。")
}
}