【Android】EventReminder使用教程(日历事件导出封装库)

【Android】EventReminder使用教程(日历事件导出封装库)

为啥要写这个库呢?

尝试自己写一个库调用,学习一下这个流程,为以后做准备
日历库在网上的资料太少了,而这个功能却又很实用
自己做的项目都会涉及到事件导出功能,不想重复写代码
这个库目前可以支持日历事件的直接导出、删除,ics文件的生成

ics生成文件中支持重复规则

目前该库还在完善中????

欢迎提供建议❤

2|0使用方法

2|1引入

在项目中引用即可

implementation 'com.paul.eventreminder:eventreminder:0.0.3'
2|2使用教程

CalendarManager
不是特别方便的初始化方法:

你需要提供Activity(用来获取权限)以及日历账户配置名称

首先声明一个Manager:

CalendarManager calendarManager=new CalendarManager(this,"测试");
会自动请求日历写入权限,如果拒绝这一块逻辑我没有处理,你可以在自己的代码中去实现该逻辑。

添加一个事件的时候你需要创建一个CalendarEvent 对象,或者您也可以选择继承自这个类

属性如下:

//总结 String summary; //内容 String content; //地点 String loc; //周次 List weekList; //周几 int dayOfWeek; //开始时间 String startTime; //结束时间 String endTime;
这里的weeklist至关重要,因为通过该集合来控制事件的重复

考虑到部分存在[1,2,3,4,8,10]这种不规则的形式,因此采用逐一导入的方法。

开始时间和结束时间的格式为 :“8:00”

创建好你的事件后调用addCalendarEvent方法即可,这里需要传入一个当前周次来告诉我当前所处时间位置。这个周次一定是在你提供的weekList中的。

public void addCalendarEvent(CalendarEvent mySubject, int curWeek,OnExportProgressListener listener)
当然你也可以选择不传curWeek这个参数,会自动默认添加从1月1号到当前时间过了几周

在添加事件事前,你也可以为其设置提醒

calendarManager.setAlarm(true);//开启提醒 calendarManager.setAlarmTime(15);//15分钟
删除事件也很简单,直接调用delete方法即可。

public void deleteCalendarEvent(Context context,OnExportProgressListener listener)
值得一提的是,删除判断的是事件内容末尾的@+ACCOUNT_NAME,所以请保持该名称在创建和删除时候要相同。

ICSManager
初始化:

ICSManager icsManager=new ICSManager(Context context,String userName);
同Calendar一样,你需要创建对应的CalendarEvent并传入

icsManager.OutPutIcsFile(String filename,boolean useRule,List calendarEvents,int curWeek,OutPutListener listener)

这里有一个参数为useRule,为bool类型

true代表开启重复规则,false代表关闭

开启重复规则后,根据你提供的weeklist来进行判断

形如 [1,2,3,4,5,6]或者[2,4,6,8,10]或者[1,3,5,7,9]都可以支持规则导出 但如果是这种[1,2,3,4,6,8]不规则的,会自动按照重复逐一导出
开启提醒的方式:

icsManager.setAlarm_seconds(15); icsManager.setFalg_alarm(true);
在回调函数中,onSuccess方法会传回来一个生成文件路径,由于该文件是保存在包名下的私有目录,因此不需要任何读写权限。

你也可以直接调用File来处理他。

项目github地址:https://github.com/paul623/EventReminder

具体实例请看项目内的代码。

EOF

本文作者:巴塞罗那的余晖
本文链接:https://www.cnblogs.com/robotpaul/p/12726609.html

上一篇:iOS开发-UIRefreshControl下拉刷新


下一篇:VS2010开发如何在c#中使用Ctrl、Alt、Tab等全局组合快捷键