如何创建带计时器的Widget 实现应用杀后台后正常显示当前时间

你已经完成应用杀进程后的Widget保活，不需要额外处理后台存活逻辑，核心只要搞定时间更新调度、UI刷新两个环节就行，不要走应用内计时器的方案，应用进程销毁后应用内的Timer、Handler类延迟任务会全部失效。

核心实现原则 #

• 时间数据源必须取系统当前时间戳做格式化，不要自己在后台累加计数，避免系统调度延迟、设备休眠导致时间偏差
• 优先用系统原生提供的Widget更新调度能力，不要自己做后台保活拉活，会被系统拦截甚至判定为异常应用
• 系统对Widget刷新频率有强制限制：Android默认最小允许的常规更新间隔为1分钟，iOS对每日刷新总次数有预算限制，秒级高频刷新要注意耗电和系统节流规则

分平台具体实现 #

Android 端（基于AppWidgetProvider） #

1. 先在Widget配置文件里设置基础更新周期，小于1分钟的配置会被系统强制重置为1分钟：

<!-- res/xml/your_widget_config.xml -->
<appwidget-provider 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="120dp"
    android:minHeight="50dp"
    android:updatePeriodMillis="60000"
    android:initialLayout="@layout/widget_layout"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen">
</appwidget-provider>

2. 在AppWidgetProvider的onUpdate回调里，每次触发更新时直接拉取系统当前时间，格式化后更新到控件上：

override fun onUpdate(context: Context, appWidgetManager: AppWidgetManager, appWidgetIds: IntArray) {
    appWidgetIds.forEach { widgetId ->
        val remoteViews = RemoteViews(context.packageName, R.layout.widget_layout)
        // 直接取系统当前时间做格式化
        val showTime = SimpleDateFormat("HH:mm:ss", Locale.getDefault()).format(Date())
        remoteViews.setTextViewText(R.id.time_display_tv, showTime)
        appWidgetManager.updateAppWidget(widgetId, remoteViews)
    }
}

如果需要做秒级精度的计时，不要靠调小updatePeriodMillis实现，在onUpdate里通过AlarmManager设置精确重复闹钟，间隔1秒发送自定义广播触发Widget刷新即可，不要用Timer、协程延迟任务，进程被杀后这类任务会直接终止。

iOS 端（基于WidgetKit） #

1. 不要频繁调用WidgetCenter.shared.reloadTimelines触发刷新，高频调用会被系统直接节流拦截，用系统原生的Timeline机制提前生成刷新条目，系统会自动在对应时间点刷新UI，不需要应用进程存活：

struct TimerWidgetEntry: TimelineEntry {
    let date: Date
}

func getTimeline(in context: Context, completion: @escaping (Timeline<TimerWidgetEntry>) -> Void) {
    var entries: [TimerWidgetEntry] = []
    let startDate = Date()
    // 提前生成未来1小时的刷新条目，按秒粒度生成即可
    for offset in 0..<3600 {
        guard let entryDate = Calendar.current.date(byAdding: .second, value: offset, to: startDate) else { continue }
        entries.append(TimerWidgetEntry(date: entryDate))
    }
    // 所有条目加载完成后自动请求下一批Timeline
    completion(Timeline(entries: entries, policy: .atEnd))
}

2. Widget视图直接读取entry的时间参数做展示即可，系统会自动对齐时间刷新：

struct TimerWidgetView: View {
    let entry: TimerWidgetEntry
    
    var body: some View {
        Text(entry.date, style: .timer)
            .font(.system(size: 22, weight: .medium))
    }
}

iOS系统对Widget的后台刷新有严格预算限制，秒级刷新仅在Widget在前台可见时生效，设备锁屏、应用切后台后系统会自动降低刷新频率，避免预算耗尽后Widget长时间不更新。

常见踩坑 #

• 做正计时/倒计时功能时，只需要在计时启动时把起始时间戳存在共享存储里（Android用SharedPreferences、iOS用App Group共享UserDefaults），每次刷新时用当前系统时间戳减去起始时间戳算时长即可，完全不需要后台常驻跑计数
• 不要在Widget更新时拉起主应用进程做时间计算，应用被杀后这类跨进程调用会失败，直接在Widget的扩展进程里完成时间格式化和UI更新即可
• 设备重启后系统会自动恢复Widget，不需要额外监听开机广播做初始化，系统会主动触发一次Widget的onUpdate（Android）/Timeline加载（iOS）

内容的提问来源于stack exchange，提问作者Jay patel