如何实现App Widget仅在可见时更新同步？

针对你要开发「仅在用户可见时才同步」的Widget需求，这里有几个经过验证的最佳实现方案，结合Android不同版本的特性来适配：

• Android 12+：利用官方可见性回调精准触发
  Android 12（API 31）开始官方提供了Widget可见性的直接回调，你可以在AppWidgetProvider的onAppWidgetOptionsChanged方法里获取当前Widget的可见状态，精准控制同步时机：

  override fun onAppWidgetOptionsChanged(
      context: Context,
      appWidgetManager: AppWidgetManager,
      appWidgetId: Int,
      newOptions: Bundle
  ) {
      super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions)
      val visibility = newOptions.getInt(AppWidgetManager.OPTION_APPWIDGET_VISIBILITY)
      when (visibility) {
          // 完全可见或部分可见时触发同步
          AppWidgetManager.APPWIDGET_VISIBILITY_VISIBLE,
          AppWidgetManager.APPWIDGET_VISIBILITY_PARTIALLY_VISIBLE -> {
              syncWidgetData(context, appWidgetId)
          }
          // 隐藏时取消正在进行的同步任务，避免浪费资源
          AppWidgetManager.APPWIDGET_VISIBILITY_HIDDEN -> {
              cancelInProgressSync()
          }
      }
  }
  

• 低版本兼容：通过更新时机推断可见性
  对于Android 12以下的设备，没有直接的可见性回调，但系统会在用户滑动到Widget所在桌面页面时触发onUpdate方法，我们可以利用这个时机来触发同步，同时结合WorkManager做任务管理：

  override fun onUpdate(
      context: Context,
      appWidgetManager: AppWidgetManager,
      appWidgetIds: IntArray
  ) {
      super.onUpdate(context, appWidgetManager, appWidgetIds)
      // 给每个Widget触发同步任务，注意加防抖避免频繁请求
      appWidgetIds.forEach { appWidgetId ->
          syncWidgetDataWithDebounce(context, appWidgetId)
      }
  }
  
  // 防抖处理：1秒内重复触发只执行一次
  private val syncDebounceMap = mutableMapOf<Int, Job>()
  private fun syncWidgetDataWithDebounce(context: Context, appWidgetId: Int) {
      syncDebounceMap[appWidgetId]?.cancel()
      syncDebounceMap[appWidgetId] = CoroutineScope(Dispatchers.Main).launch {
          delay(1000)
          val syncRequest = OneTimeWorkRequestBuilder<WidgetSyncWorker>()
              .setInputData(Data.Builder().putInt("APP_WIDGET_ID", appWidgetId).build())
              .setConstraints(Constraints.Builder()
                  .setRequiredNetworkType(NetworkType.CONNECTED)
                  .build())
              .build()
          WorkManager.getInstance(context).enqueue(syncRequest)
      }
  }
  
  // 实际执行同步的Worker
  class WidgetSyncWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
      override fun doWork(): Result {
          val appWidgetId = inputData.getInt("APP_WIDGET_ID", -1)
          if (appWidgetId == -1) return Result.failure()
          // 这里写你的同步逻辑，比如拉取最新数据
          val latestData = fetchUpdatedData()
          // 更新Widget UI
          updateWidgetContent(applicationContext, appWidgetId, latestData)
          return Result.success()
      }
  }
  

• 为什么放弃AlarmService？
  你之前用的AlarmService更适合定时重复任务，但它无法感知Widget的实际可见状态，会导致Widget被隐藏时仍在执行同步，白白消耗设备资源和流量。上面的方案都是基于Widget的实际可见场景触发，更高效节能。

• 额外优化建议

  • 缓存同步结果：如果短时间内数据没有变化，直接用缓存更新Widget，减少网络请求。
  • 错误处理：同步失败时，可以在Widget上显示重试按钮，或者设置WorkManager的重试策略。
  • 资源控制：同步任务尽量放在后台线程执行，避免阻塞UI线程。

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