自己动手写一个Alarm

Alarm结构的设计

应该有一个字段来存储触发时间，这个时间对于重复日也是固定的；

对于重复日，要有一个weekday的数组来存储一周内重复的星期；

将触发时间与重复日组合成一个触发时间队列，每到期一个时间，将该时间出队，再设置下一次定时任务。

触发时间的计算步骤

如果不重复，则执行2，否则到3；

则根据用户设置的触发小时和分，结合当天日期计算出完整的触发时间，判断该时间是否已经过期（与当前时间戳比较）如果过期，则加一天；

取出重复日的最后一天，计算出改天的触发时间，如果未过期，则计算出所有的触发时间并放入触发队列；

如果过期，则将所有的触发日加7天，相当于向后推一周。因为重复日都是以周为单位进行设置的；

每次到期后，将该时间出队，如果队列为空，则重复1~4步骤计算出下一周所有触发时间即可。

/**
* 初始化闹钟，计算触发时间
*
* @param alarm
*/
public static void initAlarm(Alarm alarm) {
alarm.triggerTimeQueue.clear();

Calendar today = Calendar.getInstance();
Calendar setDay = Calendar.getInstance();
if (alarm.isRepeat) {
// 1. 判断所有重复时间是否过期，只需要判断最后一天触发时间是否过期即可
// 取出重复天中最后一天
Weekday lastDay = alarm.weekdays.get(alarm.weekdays.size() - 1);
setDay.set(Calendar.DAY_OF_WEEK, lastDay.getValue());

// 设置时、分、秒
setDay.set(Calendar.HOUR_OF_DAY, alarm.triggerTimeHour);
setDay.set(Calendar.MINUTE, alarm.triggerTimeMinute);
// 触发时间去掉秒，因为设置到期时间的时候就没有选择秒
setDay.set(Calendar.SECOND, 0);

// 如果最后一个重复时间在本周内已经过期，则将所有的重复时间向后推迟7天
if (today.after(setDay)) {
setDay.add(Calendar.DAY_OF_MONTH, 7);
}

// 2. 将剩余的重复日转化为触发时间放入队列
StringBuilder logsb = new StringBuilder(64);
for (Weekday weekday : alarm.weekdays) {
setDay.set(Calendar.DAY_OF_WEEK, weekday.getValue());
if (today.before(setDay)) {
alarm.triggerTimeQueue.offer(setDay.getTimeInMillis());
logsb.append(DateUtil.formatDateTime(setDay.getTimeInMillis())).append(", ");
}
}

// log out
logger.d("alarm inited, triggerTimeQueue=" + logsb);
} else {
setDay.set(Calendar.HOUR_OF_DAY, alarm.triggerTimeHour);
setDay.set(Calendar.MINUTE, alarm.triggerTimeMinute);
setDay.set(Calendar.SECOND, 0);

// 如果时间已经过期，则将触发日向后推一天
if (today.after(setDay)) {
setDay.add(Calendar.DAY_OF_MONTH, 1);
}
alarm.triggerTimeQueue.offer(setDay.getTimeInMillis());
}
}

启用Alarm

启用Alarm的时机：

新增Alarm后会立即启用该Alarm，即设置其状态为enabled；

对处于disabled状态的alarm，如果用户重新设置了时间或者其他参数后，立即启用；

对处于enabled状态的alarm，如果用户设置了其部分参数，则取消之前的任务，以当前的参数重新设置一个定时任务。

/**
* 启用/禁用alarm。启用alarm后会重新计算触发时间；禁用alarm后则会清空所有的触发时间
*
* @param context
* @param alarm
* @param isEnable
* @return
*/
public static boolean enableAlarm(Context context, Alarm alarm, boolean isEnable) {
alarm.isEnabled = isEnable;
AlarmManager manager = (AlarmManager) context.getSystemService(Service.ALARM_SERVICE);
Intent intent = new Intent(context, AlarmExpireActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

if (isEnable) {
initAlarm(alarm);
intent.putExtra("alarm", gson.toJson(alarm));
PendingIntent pi = PendingIntent.getActivity(context, alarm.id, intent, PendingIntent.FLAG_CANCEL_CURRENT);
manager.set(AlarmManager.RTC_WAKEUP, alarm.triggerTimeQueue.peek(), pi);
logger.i("reset alarm successfully, alarm id=" + alarm.id + ", time=" + getAlarmHint(alarm));
} else {
alarm.triggerTimeQueue.clear();
PendingIntent pi = PendingIntent.getActivity(context, alarm.id, intent, PendingIntent.FLAG_CANCEL_CURRENT);
manager.cancel(pi);
logger.i("alarm has been canceled, alarm id=" + alarm.id);
}

saveAlarm(context, alarm);

return true;
}

Alarm到期的处理

到期后会启动一个Activity，然后做以下事：

解锁并点亮屏幕；

显示到期时间，闪烁字体；

显示备注信息；

出队当前触发时间，使用下个触发时间重置任务；

发送一个到期广播，通知主界面更新——如果该闹钟是一次性的，那么过期后应当自动禁用，所以闹钟列表中该闹钟的状态会变为disabled

/**
* 解锁屏幕
*/
private void unlockScreen() {
KeyguardManager keyguardMgr = (KeyguardManager) getSystemService(Context.KEYGUARD_SERVICE);
KeyguardLock keyguardLock = keyguardMgr.newKeyguardLock("unlock");
keyguardLock.disableKeyguard();
}

/**
* 点亮屏幕
*/
private void lightScreen() {
PowerManager powerMgr = (PowerManager) getSystemService(Context.POWER_SERVICE);
mWakeLock = powerMgr.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK | PowerManager.ON_AFTER_RELEASE, "[lightScreen]");
mWakeLock.acquire();
}

开机后重置所有激活态闹钟

注册系统开机广播：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
...
<receiver android:name="org.madmatrix.galarm.BootBroadcastReceiver" >
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />

<category android:name="android.intent.category.HOME" />
</intent-filter>
</receiver>

然后载入所有处在enabled态的闹钟，重置当前任务。

/**
* 监听开机，重启所有活动状态闹钟
*
* @author madmatrix
*/
public class BootBroadcastReceiver extends BroadcastReceiver {

@Override
public void onReceive(Context context, Intent intent) {

List<Alarm> activeAlarmList = GAlarmManager.loadAllActiveAlarms(context);
for (Alarm alarm : activeAlarmList) {
if (!alarm.isEnabled) {
continue;
}

// 重置当前任务
GAlarmManager.resetAlarm(context, alarm, false);
}
}
}

注意，此处重置的是当前正在运行但由于关机被中断的任务，GAlarmManager.resetAlarm此时要做的是仍使用对头的时间戳而不是下一个时间戳来重置当前任务：

/**
* 默认用触发队列中处于对头的时间戳重置当前任务。如果resetNext为true，则对头时间出队，使用下一个时间重置当前任务
*
* 注意：该方法只能重置处于enabled状态的闹钟
*
* @param context
* @param alarm
* @param resetNext 是否使用下一个时间戳重置当前任务
*/
public static void resetAlarm(Context context, Alarm alarm, boolean resetNext) {
if (!alarm.isEnabled) {
logger.e("[resetAlarm]the alarm should be enabled");
return;
}

if (alarm.triggerTimeQueue.isEmpty()) {
initAlarm(alarm);
}

if (resetNext) {
alarm.triggerTimeQueue.poll();

if (alarm.triggerTimeQueue.isEmpty()) {
initAlarm(alarm);
}
}

AlarmManager manager = (AlarmManager) context.getSystemService(Service.ALARM_SERVICE);
Intent intent = new Intent(context, AlarmExpireActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.putExtra("alarm", gson.toJson(alarm));
PendingIntent pi = PendingIntent.getActivity(context, alarm.id, intent, PendingIntent.FLAG_CANCEL_CURRENT);
manager.set(AlarmManager.RTC_WAKEUP, alarm.triggerTimeQueue.peek(), pi);
logger.i("restart alarm successfully, alarm id=" + alarm.id + ", time=" + getAlarmHint(alarm));
}

GAlarm没有解决在MIUI上延迟提醒的问题。

项目代码

GAlarm代码托管至：http://git.oschina.net/madmatrix/GAlarm.git

该项目依赖GLib：http://git.oschina.net/madmatrix/GLib.git