摘要：在制作一款打卡的時候有這么一個需求創建提醒到系統日歷中，也就是利用系統日歷來做事件的提醒，這么做的好處很明顯，無需處理提醒的細節，也無需后臺。

在制作一款打卡App的時候有這么一個需求 -- 創建提醒到系統日歷中，也就是利用系統日歷來做事件的提醒，這么做的好處很明顯，App無需處理提醒的細節，也無需后臺。這個App是基于Cordova開發的，并沒有訪問系統日歷的接口，我們只能通過插件來完成，這是一個有趣的挑戰。

請看下圖，App允許創建事項時，可以設置重復，開始，結束和提醒時間四個選項：

這四個選項對創建到日歷的事件都有影響：

重復 可以設置一周中的任意幾天，比如選擇周一到周五表示只要工作日。

開始 從哪天天開始

結束 到哪天結束

提醒時間 在每天的哪個時間發出提醒

這個四個組合起來就構成一個日歷事件。

Cordova平臺實際上是一個基于web的平臺，所以除了webview提供的能力，其他和設備交互的功能全部依賴于插件來完成，插件的安裝和使用通常并不困難，比如增加一個關于狀態欄控制的插件，可以在項目下這么做：

cordova plugin add cordova-plugin-statusbar

然后在js里調用插件提供的接口就可以了，更多的關于cordova平臺和插件的使用，我有一個視頻課程可以參考。很明顯，創建系統日歷事件也需要通過插件來做，搜索之后我們可以發現，完成這個功能的插件并不多，其中使用比較多的是cordova-plugin-calendar，試著安裝

cordova plugin add cordova-plugin-calendar

這個插件可以支持android和iOS，我們現在android下測試，首先在js里寫下下面的代碼：

let calOptions = window.plugins.calendar.getCalendarOptions()
calOptions.firstReminderMinutes = 0
calOptions.secondReminderMinutes = null
calOptions.recurrenceEndDate = actionRemindEnd(action)
if (action.repeat.length === 7) {
  calOptions.recurrence = "daily"
}
else {
  calOptions.recurrence = "weekly"
  calOptions.recurrenceByDay = dateRepeat2Calendar(action.repeat)
}
window.plugins.calendar.createEventWithOptions(
  action.name, null, "dayday", eventTime, new Date(eventTime.getTime() + 15 * 60000), calOptions,
  (result) => {
  }, (err) => {
  })

action保存了用戶所創建的一個活動事件的所有信息，其中有兩個函數就不展開了，看起來應該可以了，實測的結果卻是，日歷事件創建起來了，沒有報錯，但是重復有問題，并沒有能一直重復下去，在重復數次之后，事件就停了，類似下圖這樣，到15號事件就沒有了：

在這種情況下，調試js代碼已經沒有什么幫助了，js代碼已經完全按照插件的要求來傳遞了參數，只能打開android studio，加載cordova項目下platforms/android下的這個工程，這個工程就是一個標準的android項目，打開之后可以定位到這個插件所提供的源碼文件，找到AbstractCalendarAccessor.java，其中的createEvent函數完成在android下創建一個日歷事件所做的事情，代碼如下：

public String createEvent(Uri eventsUri, String title, long startTime, long endTime, String description,
                              String location, Long firstReminderMinutes, Long secondReminderMinutes,
                              String recurrence, int recurrenceInterval, String recurrenceWeekstart,
                              String recurrenceByDay, String recurrenceByMonthDay, Long recurrenceEndTime, Long recurrenceCount,
                              String allday,
                              Integer calendarId, String url) {
        ContentResolver cr = this.cordova.getActivity().getContentResolver();
        ContentValues values = new ContentValues();
        final boolean allDayEvent = "true".equals(allday) && isAllDayEvent(new Date(startTime), new Date(endTime));
        if (allDayEvent) {
            //all day events must be in UTC time zone per Android specification, getOffset accounts for daylight savings time
            values.put(Events.EVENT_TIMEZONE, "UTC");
            values.put(Events.DTSTART, startTime + TimeZone.getDefault().getOffset(startTime));
            values.put(Events.DTEND, endTime + TimeZone.getDefault().getOffset(endTime));
        } else {
            values.put(Events.EVENT_TIMEZONE, TimeZone.getDefault().getID());
            values.put(Events.DTSTART, startTime);
            values.put(Events.DTEND, endTime);
        }
        values.put(Events.ALL_DAY, allDayEvent ? 1 : 0);
        values.put(Events.TITLE, title);
        // there"s no separate url field, so adding it to the notes
        if (url != null) {
            if (description == null) {
                description = url;
            } else {
                description += " " + url;
            }
        }
        values.put(Events.DESCRIPTION, description);
        values.put(Events.HAS_ALARM, firstReminderMinutes > -1 || secondReminderMinutes > -1 ? 1 : 0);
        values.put(Events.CALENDAR_ID, calendarId);
        values.put(Events.EVENT_LOCATION, location);

        if (recurrence != null) {
            String rrule = "FREQ=" + recurrence.toUpperCase() +
                    ((recurrenceInterval > -1) ? ";INTERVAL=" + recurrenceInterval : "") +
                    ((recurrenceWeekstart != null) ? ";WKST=" + recurrenceWeekstart : "") +
                    ((recurrenceByDay != null) ? ";BYDAY=" + recurrenceByDay : "") +
                    ((recurrenceByMonthDay != null) ? ";BYMONTHDAY=" + recurrenceByMonthDay : "") +
                    ((recurrenceEndTime > -1) ? ";UNTIL=" + nl.xservices.plugins.Calendar.formatICalDateTime(new Date(recurrenceEndTime)) : "") +
                    ((recurrenceCount > -1) ? ";COUNT=" + recurrenceCount : "");
            values.put(Events.RRULE, rrule);
        }

        String createdEventID = null;
        try {
            Uri uri = cr.insert(eventsUri, values);
            createdEventID = uri.getLastPathSegment();
            Log.d(LOG_TAG, "Created event with ID " + createdEventID);

            if (firstReminderMinutes > -1) {
                ContentValues reminderValues = new ContentValues();
                reminderValues.put("event_id", Long.parseLong(uri.getLastPathSegment()));
                reminderValues.put("minutes", firstReminderMinutes);
                reminderValues.put("method", 1);
                cr.insert(Uri.parse(CONTENT_PROVIDER + CONTENT_PROVIDER_PATH_REMINDERS), reminderValues);
            }

            if (secondReminderMinutes > -1) {
                ContentValues reminderValues = new ContentValues();
                reminderValues.put("event_id", Long.parseLong(uri.getLastPathSegment()));
                reminderValues.put("minutes", secondReminderMinutes);
                reminderValues.put("method", 1);
                cr.insert(Uri.parse(CONTENT_PROVIDER + CONTENT_PROVIDER_PATH_REMINDERS), reminderValues);
            }
        } catch (Exception e) {
            Log.e(LOG_TAG, "Creating reminders failed, ignoring since the event was created.", e);
        }
        return createdEventID;
    }

這段代碼并不長，在Android Studio下設置斷點，連接真機調試，發現整個過程沒有任何錯誤，日歷事件已經創建起來，但就是重復次數不正確。好吧，找到android api參考，看看官方文檔中怎么說的：

Here are the rules for inserting a new event:

You must include CALENDAR_ID and DTSTART.
You must include an EVENT_TIMEZONE. To get a list of the system"s installed time zone IDs, use getAvailableIDs(). Note that this rule does not apply if you"re inserting an event through the INSERT Intent, described in Using an intent to insert an event—in that scenario, a default time zone is supplied.
For non-recurring events, you must include DTEND.
For recurring events, you must include a DURATION in addition to RRULE or RDATE. Note that this rule does not apply if you"re inserting an event through the INSERT Intent, described in Using an intent to insert an event—in that scenario, you can use an RRULE in conjunction with DTSTART and DTEND, and the Calendar application converts it to a duration automatically.

仔細對照代碼和文檔，我們發現DURATION這個參數并沒有按照文檔來傳遞，好吧，我們修改一下關鍵代碼：

if (allDayEvent) {
  //all day events must be in UTC time zone per Android specification, getOffset accounts for daylight savings time
  values.put(Events.EVENT_TIMEZONE, "UTC");
  values.put(Events.DTSTART, startTime + TimeZone.getDefault().getOffset(startTime));
  if (recurrence == null) {
    values.put(Events.DTEND, endTime + TimeZone.getDefault().getOffset(endTime));
  } else {
    values.put(Events.DURATION, "P" + ((endTime - startTime) / (24 * 60 * 60000)) + "D");
  }
} else {
  values.put(Events.EVENT_TIMEZONE, TimeZone.getDefault().getID());
  values.put(Events.DTSTART, startTime);
  if (recurrence == null) {
    values.put(Events.DTEND, endTime);
  } else {
    values.put(Events.DURATION, "P" + ((endTime - startTime) / 60000) + "M");
  }
}

修改后的代碼再次測試，這次ok了，這個例子表明了cordova生態的一個現象，插件質量參差不齊，有些插件可能需要我們的修改才能工作。

為了使用修改后的插件，我們可以刪除原來的插件，使用fork并修改后的插件，很簡單，方法如下：

cordova plugin remove cordova-plugin-calendar
cordova plugin add https://github.com/i38/Calendar-PhoneGap-Plugin.git

所有其他代碼都不用修改，這是cordova很靈活的一個地方，這樣一切都ok了，最后附上完整App的鏈接，有興趣可以參考： 天天。