资讯专栏INFORMATION COLUMN

使用 EventKit 向系统日历中添加事件

yck / 2078人阅读

摘要:使用向系统日历中添加事件本文主要内容是如何一步一步使用在设备中添加日历,并在日历中添加事件和提醒事项。每一个拥有独一无二的标识,是每个事件的,这个字符串是应用自己分配的,保证了每个应用可以在添加了事件以后,针对性的进行事件修改。

使用 EventKit 向系统日历中添加事件

本文主要内容是如何一步一步使用EventKit在iOS设备中添加日历,并在日历中添加事件和提醒事项。

源代码Github

类和属性 EKAlarm 提醒操作类

EKAlarm类用于提供操作系统日历通知的相关接口,通知时间既可以是绝对时间,也可以是相对时间。

实例化方法

//绝对时间
+ (EKAlarm *)alarmWithAbsoluteDate:(NSDate *)date;
//相对时间
+ (EKAlarm *)alarmWithRelativeOffset:(NSTimeInterval)offset;

属性相关类

EKStructuredLocation 通知的位置属性,包括标题title,地理位置geoLocation和半径radius

EKAlarmProximity 是一个标记为进入或者离开的枚举类型

typedef NS_ENUM(NSInteger, EKAlarmProximity) {
    EKAlarmProximityNone,
    EKAlarmProximityEnter, //进入
    EKAlarmProximityLeave  //离开
};

EKAlarmType 记录通知类型的枚举属性

typedef NS_ENUM(NSInteger, EKAlarmType) {
    EKAlarmTypeDisplay,     //展示信息
    EKAlarmTypeAudio,       //播放声音
    EKAlarmTypeProcedure,   //打开网址
    EKAlarmTypeEmail        //发邮件
};
EKEventStore 事件管理类

首先,通过``可以进行系统授权,使用下面的方法

//申请权限
- (void)requestAccessToEntityType:(EKEntityType)entityType completion:(EKEventStoreRequestAccessCompletionHandler)completion NS_AVAILABLE(10_9, 6_0);

//获取当前权限
+ (EKAuthorizationStatus)authorizationStatusForEntityType:(EKEntityType)entityType NS_AVAILABLE(10_9, 6_0);

枚举量包括 实例类型EKEntityType 和 实例蒙版EKEntityMask

EKCalendar 日历操作类

EKCalendarEKEventStore 的关系可以理解为,一个EKEventStore可以包含多个EKCalendar

这个类的类型枚举变量是

typedef NS_ENUM(NSInteger, EKCalendarType) {
   EKCalendarTypeLocal,
   EKCalendarTypeCalDAV,
   EKCalendarTypeExchange,
   EKCalendarTypeSubscription,
   EKCalendarTypeBirthday
};

其中,EKCalendarTypeCalDAVEKCalendarTypeExchange 是两种邮箱账户的事件同步类型,EKCalendarTypeBirthday是一个内置的生日日历,EKCalendarTypeLocal和设备同步,EKCalendarTypeSubscription则是用于本地的同步类型。

EKEvent 事件操作类 与 EKReminder 提醒操作类

EKEventEKReminder一样继承于EKCalendarItem

业务代码

上面对于头文件的分析,有助于我们实际编写代码。

系统授权

要点一 添加授权描述

首先需要在项目的plist文件中,加入申请系统日历使用的描述,否则无法发起授权请求。键为NSCalendarsUsageDescription,值为提交请求的描述。

然后判断当前的授权状态

+ (BOOL)accessForEventKit:(EKEntityType)type
{
    return [EKEventStore authorizationStatusForEntityType:type] == EKAuthorizationStatusAuthorized;
}

当然,可以增加额外的判断,比如当状态为EKAuthorizationStatusDenied的时候,可以提醒用户前往系统设置打开系统日历的授权,我们上面这段代码只是简单的判断是否拥有系统日历的操作权限,当拥有权限时,进行业务代码,如果还没有进行过授权,则用下满的方法吊起授权

+ (void)accessForEventKitType:(EKEntityType)type result:(void(^)(BOOL))result
{
    EKEventStore* store = [[EKEventStore alloc] init];
    [store requestAccessToEntityType:EKEntityTypeEvent completion:^(BOOL granted, NSError * _Nullable error) {
        if (!granted) {
            NSLog(@"%@",error);
        }
        if (result) {
            result(granted);
        }
    }];
}

这里是否封装成方法都可以,我这里写成类方法是为了方便读者在任意位置粘贴代码和调用。

授权完成以后就可以进行业务代码的操作了。

添加日历

首先使用下面的代码获取系统日历中全部的日历

+ (NSArray*)calendarWithType:(EKEntityType)type
{
    EKEventStore* store = [[EKEventStore alloc] init];
    return [store calendarsForEntityType:type];
}

这里同样区分事件的种类,获得结果如下,每个苹果账号的日历内容不尽相同

"EKCalendar <0x1740a5580> {title = Birthdays; type = Birthday; allowsModify = NO; color = #8295AF;}",
"EKCalendar <0x1740a5dc0> {title = Calendar; type = CalDAV; allowsModify = YES; color = #1BADF8;}",
"EKCalendar <0x1740a56a0> {title = U65e5U5386; type = CalDAV; allowsModify = YES; color = #1BADF8;}",
"EKCalendar <0x1740a5640> {title = U5de5U4f5c; type = CalDAV; allowsModify = YES; color = #63DA38;}",
"EKCalendar <0x1740a55e0> {title = U5bb6U5ead; type = CalDAV; allowsModify = YES; color = #FFCC00;}"

EKCalendarEKCalendarItem 并不是双向的可读取关系,通过EKCalendarItem实例可以获取它的EKCalendar,但我们无法通过EKCalendar获取系统全部的EKCalendarItem,这样不同的应用之间是无法相互操作事件的。

每一个EKCalendarItem拥有独一无二的calendarItemIdentifier标识,是每个事件的id,这个字符串是应用自己分配的,保证了每个应用可以在添加了事件以后,针对性的进行事件修改。

大家注意到上面输出的EKCalendar中有一个日历是禁止应用修改的,就是Birthdays日历,因为这个日历是同步于通讯录中的联系人生日的特殊日历。

EKCalendar除了上面获取的系统已有日历,我们也可以添加自己定义的日历

要点二 日历的calendarIdentifier存储

应用需要自己存储自己添加的日历的唯一标识,就是calendarIdentifier,我们这里使用NSUserDefault来存储。

+ (void)createCalendar
{
    NSUserDefaults * def = [NSUserDefaults standardUserDefaults];
    NSString* calendarIdentifier = [def valueForKey:@"testCalendarIdentifier"];
    EKCalendar* birthday = [store calendarWithIdentifier:calendarIdentifier];
    //这里如果calendarIdentifier为nil,则EKCalendar也会为nil
    if (!birthday) {
            birthday = [EKCalendar calendarForEntityType:EKEntityTypeEvent eventStore:store];
            birthday.title = @"test日历";
            //注意calendarIdentifier自动生成的,这里要保存下来
            [def setObject:birthday.calendarIdentifier forKey:@"testCalendarIdentifier"]; 
            [def synchronize];
            NSError* error;
            [store saveCalendar:birthday coobjectivecit:YES error:&error];
            if (error) {
                NSLog(@"%@",error);
            }
   }
}

上面的代码执行将无法添加日历,需要越过两个坑

要点三 坑

坑一是EKCalendar需要设置EKSource才可以添加,所以会得到下面的错误

Error Domain=EKErrorDomain Code=14 "Calendar has no source" UserInfo={NSLocalizedDescription=Calendar has no source}

然而EKSource并不可以通过EventKit管理,也就是说,系统有哪些日历账户,就只能用哪些,获取的办法如下:

+ (EKSource*)sourceWithType:(EKSourceType)type
{
    EKEventStore* store = [[EKEventStore alloc] init];
    EKSource *localSource = nil;
    NSLog(@"%@",store.sources);
    for (EKSource *source in store.sources)
    {
        if (source.sourceType == type)
        {
            localSource = source;
            break;
        }
    }
    return localSource;
}

我们通过遍历所有的系统Source,来匹配我们需要的Source。

这里就引出坑二,当系统开启或关闭了iCloud日历功能的时候,Source会有不同,例如开启iCloud日历的时候,我的设备只有一个EKSourceTypeCalDAV类型的叫iCloud的Source和一个Other类型的Source(每个设备可能不尽相同),但在其他没有开启的设备上,才有EKSourceTypeLocal类型的Source,所以上面一段代码的Source匹配,可能要执行多次,或者按照先后顺序匹配,如果多带带只匹配一种类型,会有可能找不到可以使用的Source。

找到Source以后,将其赋值给Calendar,注意EKCalendar的这个属性虽然不是Readonly,但只能在初始化日历的时候进行设置,不能再更改。

birthday.source = [[self class] sourceWithType:EKSourceTypeCalDAV];
if (!birthday.source) {
    birthday.source = [[self class] sourceWithType:EKSourceTypeLocal];
}

如此则可顺利添加自定义的日历。

添加事件

最后一步添加事件则很简单

+ (void)addEvent
{
         EKEvent* event = [EKEvent eventWithEventStore:store];
        event.calendar = birthday;
        event.title = @"我的生日";
        NSDateFormatter* formatter = [[NSDateFormatter alloc] init];
        [formatter setDateFormat:@"yyyy-objectivec-dd-HH-objectivec"];
        event.startDate = [formatter dateFromString:@"2017-11-12-00-00"];
        event.endDate = [formatter dateFromString:@"2017-11-12-23-59"];
        NSError* error;
        [store saveEvent:event span:EKSpanThisEvent error:&error];
        if (error) {
            NSLog(@"%@",error);
        }
        NSLog(@"%@",event.eventIdentifier);
} 

event设置标题、日历和起始日期即可,保存步骤中用到的EKSpanThisEvent枚举表示只应用于当前事件,这个枚举的另一个值EKSpanFutureEvents表示应用到所有此事件,包括重复事件的未来的事件。

最后保存成功的话,得到的eventIdentifier,应用可以根据需要保存在本地。

以上就是EventKit的基础教程。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/16772.html

相关文章

  • UIView初识

    摘要:从运行时的角度来看,即使用一个对象来控制这片区域里面内容的渲染和交互的事件。事件处理每一个都是响应者,它可以处理定义的所有事件。在系的继承层次中可以看出,继承自,这也赋予了它事件处理能力。 UIView,也即User Interface View,就是用户界面的意思。毫无疑问,这是与用户关系最密切的一层,也是产品狗们真正关心的地方,所以,对UIView的掌握在很大程度上决定着一个程序...

    Maxiye 评论0 收藏0
  • 一款基于移动端的日历控件iantooDate

    摘要:已被移除过时的提醒时间的颜色。默认当日历控件滑动的时候是否实时更新日历控件的位置主要是对部分低端机型做性能处理。返回当前的时间调用该方法关闭日历控件。年月日时分秒星期 原文链接 使用 引入文件: ./build/css/iantooDate.css ./build/js/iantooDate.js 并在页面上调用: iantoo.date() 详细使用方法见page/iantooDat...

    liangzai_cool 评论0 收藏0
  • 带你开发一个日历控件

    摘要:直接使用事件代理机制,将事件绑定在整个日历的上即可,这样事件只用在创建时初始化一次即可,简单高效省内存。 首发我的博客 - https://blog.cdswyda.com/post/2017121010 日历控件多的不胜枚举,为什么我们还要再造一个轮子呢? 因为大多数日历控件都是用于选择日期的,有种需求是要在日历上展示各种各样的内容,这样的日历控件较少,而且试用下来并不满意。 因此就...

    shiina 评论0 收藏0
  • 怎样实现一个datePicker(日期选择)组件

    摘要:百度前端技术学院上有一个任务,要实现一个日期选择组件,本文由此而来看看需求组件默认一直呈显示状态通过某种方式选择年月,选择了年月后,日期列表做相应切换通过单击某个具体的日期进行日期选择组件初始化时,可配置可选日期的上下限。 百度前端技术学院上有一个任务,要实现一个日期选择组件,本文由此而来~ 看看需求 组件默认一直呈显示状态 通过某种方式选择年、月,选择了年月后,日期列表做相应切换 ...

    layman 评论0 收藏0
  • 怎样实现一个datePicker(日期选择)组件

    摘要:百度前端技术学院上有一个任务,要实现一个日期选择组件,本文由此而来看看需求组件默认一直呈显示状态通过某种方式选择年月,选择了年月后,日期列表做相应切换通过单击某个具体的日期进行日期选择组件初始化时,可配置可选日期的上下限。 百度前端技术学院上有一个任务,要实现一个日期选择组件,本文由此而来~ 看看需求 组件默认一直呈显示状态 通过某种方式选择年、月,选择了年月后,日期列表做相应切换 ...

    beanlam 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<