Android Widget点击启动应用延迟及重复点击问题求助

问题分析 #

点击Widget后onReceive方法延迟1-2秒触发，这段时间内用户重复点击会导致多次执行扫码界面启动逻辑，核心原因：

• Widget的广播接收由系统后台调度，应用冷启动时的资源调度会产生明显延迟
• 当前PendingIntent配置未做防重复处理，允许重复触发广播

解决方案 #

1. 阻止PendingIntent重复触发 #

修改setOnItemClicks方法中的PendingIntent创建逻辑，添加PendingIntent.FLAG_ONE_SHOT标记，确保每次PendingIntent仅能被使用一次，避免重复点击触发多次广播：

private fun setOnItemClicks(views: RemoteViews, context: Context) {
    val onItemClickIntent = Intent(context, QrScanWidgetProvider::class.java)
    onItemClickIntent.action = ON_ITEM_CLICK_ACTION
    views.setOnClickPendingIntent(
        R.id.root_view, PendingIntent.getBroadcast(
            context, 0, onItemClickIntent,
            PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_ONE_SHOT
        )
    )
}

同时在onReceive处理启动逻辑后，立即临时禁用Widget点击，避免用户在延迟期间继续操作，待一段时间后恢复点击状态：

override fun onReceive(context: Context?, intent: Intent?) {
    if (intent?.action == ON_ITEM_CLICK_ACTION && context != null) {
        val appWidgetManager = AppWidgetManager.getInstance(context)
        val componentName = ComponentName(context, QrScanWidgetProvider::class.java)
        
        // 临时移除点击事件，禁用Widget交互
        val disabledViews = RemoteViews(context.packageName, R.layout.widget_qr_scan).also {
            it.setTextViewText(R.id.tv_qr_scan, context.getString(R.string.qr_scan))
            it.setOnClickPendingIntent(R.id.root_view, null)
        }
        appWidgetManager.updateAppWidget(componentName, disabledViews)

        // 启动扫码界面
        NavigationUtils.getShowScreenPendingIntent(
            context,
            SCREEN_SCAN,
            null,
            true
        ).send()

        // 3秒后恢复Widget点击状态
        Handler(Looper.getMainLooper()).postDelayed({
            val widgetIds = appWidgetManager.getAppWidgetIds(componentName)
            for (id in widgetIds) {
                updateAppWidget(context, appWidgetManager, id)
            }
        }, 3000)
    }
    super.onReceive(context, intent)
}

2. 优化应用启动速度降低延迟 #

• 给扫码界面所在Activity设置android:launchMode="singleTop"或singleTask，避免重复创建实例
• 精简Application的onCreate方法，将非必要初始化操作延迟到后台线程执行
• 可使用ActivityOptions.makeLaunchAnimation优化启动过渡动画，减少用户对延迟的感知

完整修改后的代码 #

class QrScanWidgetProvider : AppWidgetProvider() {

    override fun onUpdate(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetIds: IntArray
    ) {
        for (appWidgetId in appWidgetIds) {
            updateAppWidget(context, appWidgetManager, appWidgetId)
        }
    }

    fun updateAppWidget(
        context: Context, appWidgetManager: AppWidgetManager,
        appWidgetId: Int
    ) {
        val views = RemoteViews(context.packageName, R.layout.widget_qr_scan).also {
            it.setTextViewText(R.id.tv_qr_scan, context.getString(R.string.qr_scan))
        }
        setOnItemClicks(views, context)
        appWidgetManager.updateAppWidget(appWidgetId, views)
    }

    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == ON_ITEM_CLICK_ACTION && context != null) {
            val appWidgetManager = AppWidgetManager.getInstance(context)
            val componentName = ComponentName(context, QrScanWidgetProvider::class.java)
            
            // 临时禁用Widget点击
            val disabledViews = RemoteViews(context.packageName, R.layout.widget_qr_scan).also {
                it.setTextViewText(R.id.tv_qr_scan, context.getString(R.string.qr_scan))
                it.setOnClickPendingIntent(R.id.root_view, null)
            }
            appWidgetManager.updateAppWidget(componentName, disabledViews)

            // 启动扫码界面
            NavigationUtils.getShowScreenPendingIntent(
                context,
                SCREEN_SCAN,
                null,
                true
            ).send()

            // 延迟恢复点击状态
            Handler(Looper.getMainLooper()).postDelayed({
                val widgetIds = appWidgetManager.getAppWidgetIds(componentName)
                for (id in widgetIds) {
                    updateAppWidget(context, appWidgetManager, id)
                }
            }, 3000)
        }
        super.onReceive(context, intent)
    }

    private fun setOnItemClicks(views: RemoteViews, context: Context) {
        val onItemClickIntent = Intent(context, QrScanWidgetProvider::class.java)
        onItemClickIntent.action = ON_ITEM_CLICK_ACTION
        views.setOnClickPendingIntent(
            R.id.root_view, PendingIntent.getBroadcast(
                context, 0, onItemClickIntent,
                PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_ONE_SHOT
            )
        )
    }

    companion object {
        const val ON_ITEM_CLICK_ACTION = "ON_ITEM_CLICK_ACTION"
        const val SCREEN_SCAN = "SCREEN_SCAN"
    }
}

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