Android日历操作

最近接到一个需求，要为用户增加一些日历提示信息。感觉不是很难的一个需求，也折腾了一天，记录一些关键步骤，以资来者。

申请日历权限

APP想要操作用户的日历，需要有读写日历的权限：android.permission.READ_CALENDAR,android.permission.WRITE_CALENDAR。上述权限读取和写入可以分别申请，即如果需求只是写入日历提醒功能，则不需要申请READ_CALENDAR权限。此外，由于此权限是高危权限，需要进行动态申请，具体申请方式可以参见Android原生动态权限申请方法
.

写入日历提醒

Android的日历系统对外暴露是通过provider机制进行的，即每次操作都要拼装对应的URI。这里比较关键的是三个URL为：

private static String CALENDAR_URL = "content://com.android.calendar/calendars"; // 日历账户
private static String CALENDAR_EVENT_URL = "content://com.android.calendar/events"; // 事件表
private static String CALENDAR_REMINDER_URL = "content://com.android.calendar/reminders"; // 提醒表

首先我们需要获得用户日历的账户id，这个值是我们所有日历操作的基础；然后向events表插入对应的日程，包括起止时间（ms）、标题、事件描述；最后向reminders表插入对应的提醒事件，包括日程填入后的eventId，提醒时间以及提醒方式。

核心代码：

public static boolean insertCalendarEvent(Context context, String title, String description,
											  long beginTimeMillis, long endTimeMillis) {
	if (context == null || TextUtils.isEmpty(title) || TextUtils.isEmpty(description)) {
		return false;
	}

	int calId = checkCalendarAccount(context); // 获取日历账户的id
	if (calId < 0) { // 获取账户id失败直接返回，添加日历事件失败
		return false;
	}

	try {
		/** 插入日程 */
		ContentValues eventValues = new ContentValues();
		eventValues.put(CalendarContract.Events.DTSTART, beginTimeMillis); // 事件起始时间
		eventValues.put(CalendarContract.Events.DTEND, endTimeMillis); // 事件结束时间
		eventValues.put(CalendarContract.Events.TITLE, title); // 事件标题
		eventValues.put(CalendarContract.Events.DESCRIPTION, description); // 事件描述
		eventValues.put(CalendarContract.Events.CALENDAR_ID, 1); // 使用默认日历目录
		eventValues.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getID()); // 获取默认时区
		Uri eUri = context.getContentResolver().insert(Uri.parse(CALENDAR_EVENT_URL), eventValues);
		long eventId = ContentUris.parseId(eUri);
		if (eventId == 0) { // 插入失败
			return false;
		}

		/** 插入提醒 - 依赖插入日程成功 */
		ContentValues reminderValues = new ContentValues();
		reminderValues.put(CalendarContract.Reminders.EVENT_ID, eventId);
		reminderValues.put(CalendarContract.Reminders.MINUTES, 10); // 提前10分钟提醒
		reminderValues.put(CalendarContract.Reminders.METHOD, CalendarContract.Reminders.METHOD_ALERT); // 提示方式提醒
		Uri rUri = context.getContentResolver().insert(Uri.parse(CALENDAR_REMINDER_URL),
				reminderValues);
		if (rUri == null || ContentUris.parseId(rUri) == 0) {
			return false;
		}
	} catch (Exception e) {
		e.printStackTrace();
		return false;
	}
	return true;
}

查看日历

查看日历一种方式是通过qurey的方式进行provider查询，这种方式有很大可能会读取到用户其他的日历信息，不是很友好（主要是没需求，都懂得~）。这里推荐另一种查看日历的方式，直接拉起系统日历来查看具体信息。具体代码如下：

private void gotoCalendar() {
	Intent intent = new Intent(Intent.ACTION_MAIN);
	intent.addCategory(Intent.CATEGORY_APP_CALENDAR);
	startActivity(intent);
}

TODO

需求虽然做完且交付了，还有两个问题需要继续学习解决，记录下来，省的忘了。

1. 日历的账户操作很重要，能有效解决多个应用日程污染问题；
2. 如何过滤本APP插入日程，如果日程被修改过如何识别出来。

参看代码：CalendarActivity