碎碎念
爲啥要寫這個庫呢?
- 嘗試自己寫一個庫調用,學習一下這個流程,爲以後做準備
- 日曆庫在網上的資料太少了,而這個功能卻又很實用
- 自己做的項目都會涉及到事件導出功能,不想重複寫代碼
這個庫目前可以支持日曆事件的直接導出、刪除,ics文件的生成
ics生成文件中支持重複規則
目前該庫還在完善中🔨
歡迎提供建議❤
使用方法
引入
在項目中引用即可
implementation 'com.paul.eventreminder:eventreminder:0.0.3'
使用教程
CalendarManager
不是特別方便的初始化方法:
你需要提供Activity(用來獲取權限)以及日曆賬戶配置名稱
首先聲明一個Manager:
CalendarManager calendarManager=new CalendarManager(this,"測試");
會自動請求日曆寫入權限,如果拒絕這一塊邏輯我沒有處理,你可以在自己的代碼中去實現該邏輯。
添加一個事件的時候你需要創建一個CalendarEvent 對象,或者您也可以選擇繼承自這個類
屬性如下:
//總結 String summary; //內容 String content; //地點 String loc; //周次 List<Integer> 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<CalendarEvent> 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
具體實例請看項目內的代碼。