【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

本文作者：巴塞罗那的余晖