【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