Android Calendar Provider(日历事件)

这篇文章的目的

写这篇文章的目的，主要是为了记录在日历事件中遇到的2个比较少见，在网上比较难查找资料的问题。

应用背景：
在应用中通过ContentProvider操作系统日历，向系统日历中添加、更新、删除日程事件。
所以应用中的日程事件，是与系统日历中的事件同步的。

问题1：
为应用不同的登录账号添加日历账号，用此日历账号在应用中添加日程事件，然后应用切换账号，日程事件消失。

问题2：
删除日历事件后，系统日历中已经删除，但在应用中通过ContentProvider还能查询到（小米、魅族、联想一些国产手机没有这个问题，三星有）。

Calendar Provider的详细操作，参见官方文章：
http://developer.android.com/guide/topics/providers/calendar-provider.html
对应的中文译文：
http://www.cnblogs.com/popapa/p/android_calendar-provider.html#sync-adapter

---

问题1

问题描述：

为应用不同的登录账号添加日历账号，用此日历账号在应用中添加日程事件，然后应用切换账号，日程事件消失。

问题原因：

这个问题，应该是（猜想）和Android系统日历的账号管理有关。

在项目中，添加日历账号的代码如下所示

private long addCalendarAccount(Context context) {
    boolean has_permission = Utils.hasPermission(context, "android.permission.WRITE_CALENDAR");
    if (!has_permission) {
        Utils.toast(context, R.string.calendar_disable_hint);
        return -1;
    }
    TimeZone timeZone = TimeZone.getDefault();
    ContentValues value = new ContentValues();
    value.put(Calendars.NAME, CALENDARS_NAME);

    value.put(Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME);
    value.put(Calendars.ACCOUNT_TYPE, CalendarContract.ACCOUNT_TYPE_LOCAL);
    value.put(Calendars.CALENDAR_DISPLAY_NAME, CALENDARS_DISPLAY_NAME);
    value.put(Calendars.VISIBLE, 1);
    value.put(Calendars.CALENDAR_COLOR, Color.BLUE);
    value.put(Calendars.CALENDAR_ACCESS_LEVEL, Calendars.CAL_ACCESS_OWNER);
    value.put(Calendars.SYNC_EVENTS, 1);
    value.put(Calendars.CALENDAR_TIME_ZONE, timeZone.getID());
    value.put(Calendars.OWNER_ACCOUNT, CALENDARS_ACCOUNT_NAME);
    value.put(Calendars.CAN_ORGANIZER_RESPOND, 0);

    Uri calendarUri = Uri.parse(uri);
    calendarUri = calendarUri.buildUpon().appendQueryParameter(CALLER_IS_SYNCADAPTER, "true")
            .appendQueryParameter(Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME)
            .appendQueryParameter(Calendars.ACCOUNT_TYPE, CalendarContract.ACCOUNT_TYPE_LOCAL).build();

    Uri result = context.getContentResolver().insert(calendarUri, value);
    long id = result == null ? -1 : ContentUris.parseId(result);
    return id;
}

有一句设置账号类型的代码：

value.put(Calendars.ACCOUNT_TYPE, CalendarContract.ACCOUNT_TYPE_LOCAL);

其中Calendars.ACCOUNT_TYPE的说明如下图：

说明中有一句英文：
A type of ACCOUNT_TYPE_LOCAL will keep this event form being deleted if there are no matching accounts on the device.

大意是：
当ACCOUNT_TYPE为ACCOUNT_TYPE_LOCAL时，可以防止在设备中没有找到账号时日程事件被删除。

解决方案：

因此，问题1的解决方案就是设置ACCOUNT_TYPE为ACCOUNT_TYPE_LOCAL：

value.put(Calendars.ACCOUNT_TYPE, CalendarContract.ACCOUNT_TYPE_LOCAL);

---

问题2

问题描述：

删除日历事件后，系统日历中已经删除，但在应用中通过ContentProvider还能查询到（小米、魅族、联想一些国产手机没有这个问题，三星有）。

这个问题，在网上找了很长时间，都没有找到相应的资料，在最后快要放弃的时候，在Stackoverflow上找到了解决办法。
http://stackoverflow.com/questions/22554130/calendar-deleted-event-exists-in-cursor

其实问题修改起来很简单，因为日程事件删除之后，系统并没有真的删除，只是对把标示删除的字段改了而已，也就是只做了逻辑删除，而没有做物理删除。

小米、魅族、联想一些国产手机没有这个问题的原因，可能是国产手机的系统定制化高，查询的时候，已经对这个问题进行了处理，而三星没有处理。

其实这个问题，如果会阅读源码的话，花些时间，放些耐心应该是可以从源码中分析出来的，所有阅读源码还是很有必要的。

解决方案：

清楚问题原因之后，解决方案其实很简单，就是查询的时候，再过滤一下，增加查询条件(deleted != 1)就OK了。

比如应用中查询的代码

private void fillData(Context context, String selection,
        String[] selectionArgs, List<CalendarEvent> calendarEvents) {
    selection+=" and (deleted != 1)";
    Cursor cursor = context.getContentResolver().query(Uri.parse(eventUri),null, selection, selectionArgs, null);
    if (cursor.moveToFirst()) {
        do {
            CalendarEvent calendarEvent=new CalendarEvent();
            String title = cursor.getString(cursor.getColumnIndex(Events.TITLE));
            String description = cursor.getString(cursor.getColumnIndex(Events.DESCRIPTION));
            String repeat = cursor.getString(cursor.getColumnIndex(Events.RRULE));
            long eventId = cursor.getLong(cursor.getColumnIndex(Events._ID));
            long beginTime = cursor.getLong(cursor.getColumnIndex(Events.DTSTART));
            long endTime = cursor.getLong(cursor.getColumnIndex(Events.DTEND));
            int remind = getRemindMunites(context, eventId);
            calendarEvent.setEventId(eventId);
            calendarEvent.setDescription(description);
            calendarEvent.setTitle(title);
            calendarEvent.setBeginTime(beginTime);
            calendarEvent.setEndTime(endTime);
            calendarEvent.setRemind(remind);
            calendarEvent.setRepeat(repeat);
            calendarEvent.setCalendarId(cursor.getLong(cursor.getColumnIndex(Events.CALENDAR_ID)));
            calendarEvents.add(calendarEvent);
        } while (cursor.moveToNext());
    }
    cursor.close();
}

---

结束

文章就写到这里，附上添加、修改、删除日程时间完整Demo，点击下载。

如果需要查询日程时间操作的详细资料，参见官方文章：
http://developer.android.com/guide/topics/providers/calendar-provider.html
对应的中文译文：
http://www.cnblogs.com/popapa/p/android_calendar-provider.html#sync-adapter