【Android】EventReminder使用教程(日曆事件導出封裝庫)

碎碎念

爲啥要寫這個庫呢?

  • 嘗試自己寫一個庫調用,學習一下這個流程,爲以後做準備
  • 日曆庫在網上的資料太少了,而這個功能卻又很實用
  • 自己做的項目都會涉及到事件導出功能,不想重複寫代碼

這個庫目前可以支持日曆事件的直接導出、刪除,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

具體實例請看項目內的代碼。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章