【TaskbarDelegate】屏蔽上滑返回桌面手势功能

一、需求描述

基于Android 14 平台，在应用界面中默认使用上滑手势会返回桌面，某些应用要求不能返回到桌面，需要屏蔽上滑手势。

二、需求分析

我们知道手势导航的底部导航横线的逻辑是在 SystemUI 的 NavigationBarView -> NavigationBar -> NavigationBarController -> TaskbarDelegate 等相关的类控制，在手势导航中上滑手势有 2 种功能：

• 从屏幕底部向上滑动，即可进入主屏幕
• 从底部向上滑动、按住再松开，可切换应用

如果想要屏蔽，可以直接返回消费掉 InputEvent 事件，就不会走后续的流程了，我尝试在NavigationBarView 的 onInterceptTouchEvent 返回 true，但是只屏蔽了返回Home的功能，最近任务还是会启动。在 TaskbarDelegate 中有设置相关的 sys ui flag 的相关逻辑，于是我们可以参考 【EdgeBackGesture】屏蔽屏幕边缘返回手势，实现类似的屏蔽效果。

1. TaskbarDelegate 初始化时添加需要屏蔽上滑功能的 Activity 合集
2. 创建一个监听器 TaskStackChangeListener，用于监听前台应用是否需要屏蔽，并注册监听
3. 任务栈变化时候改变 SysuiFlag，如 SYSUI_STATE_OVERVIEW_DISABLED 和 SYSUI_STATE_HOME_DISABLED

这个方案的优点是，我们不需要去追踪复杂的输入事件流，而是直接通过官方提供的、系统级的状态标志来声明我们的意图。InputDispatcher（负责分发所有触摸事件的底层服务）会尊重这些标志，并从源头上就阻止手势的发生。

三、解决方案

SystemUI/src/com/android/systemui/navigationbar/TaskbarDelegate.java

1.添加需要屏蔽上滑功能的 Activity 合集

privatefinalList<ComponentName> mHomeBlockingActivities =newArrayList<>();publicTaskbarDelegate(Context context,LightBarTransitionsController.Factory lightBarTransitionsControllerFactory,StatusBarKeyguardViewManager statusBarKeyguardViewManager){ mLightBarTransitionsControllerFactory = lightBarTransitionsControllerFactory; mContext = context; mDisplayManager = mContext.getSystemService(DisplayManager.class); mPipListener =(bounds)->{ mEdgeBackGestureHandler.setPipStashExclusionBounds(bounds);}; mStatusBarKeyguardViewManager = statusBarKeyguardViewManager; mStatusBarKeyguardViewManager.setTaskbarDelegate(this);// 添加要屏蔽的 ActivityString[] disabledActivities = mContext.getResources().getStringArray(R.array.config_blockedHomeGestureActivities);for(String disabledActivity : disabledActivities){ mHomeBlockingActivities.add(ComponentName.unflattenFromString(disabledActivity));}}

在新建的 config_blockedHomeGestureActivities 数组中添加需要屏蔽类名即可

<string-arrayname="config_blockedHomeGestureActivities"><item>com.android.deskclock/.DeskClock</item></string-array>

2.注册并监听任务栈变化

TaskbarDelegate 原本逻辑中就包含了 TaskStackChangeListener 的监听，但是没有 onTaskStackChanged 的重写，只需要加上即可

privateboolean mIsHomeGestureBlocked;privatefinalTaskStackChangeListener mTaskStackListener =newTaskStackChangeListener(){@OverridepublicvoidonLockTaskModeChanged(int mode){ mSysUiState.setFlag(SYSUI_STATE_SCREEN_PINNING, mode == LOCK_TASK_MODE_PINNED).commitUpdate(mDisplayId);}@OverridepublicvoidonTaskStackChanged(){updateHomeGestureBlockState();}};privatevoidupdateHomeGestureBlockState(){boolean shouldBlock =false;ActivityManager.RunningTaskInfo runningTask =ActivityManagerWrapper.getInstance().getRunningTask();ComponentName topActivity = runningTask ==null?null: runningTask.topActivity; shouldBlock = topActivity !=null&& mHomeBlockingActivities.contains(topActivity);if(mIsHomeGestureBlocked != shouldBlock){ mIsHomeGestureBlocked = shouldBlock;updateSysuiFlags();}}

3.更新标志位 updateSysuiFlags

privatevoidupdateSysuiFlags(){android.util.Log.e("maxx","updateSysuiFlags");int a11yFlags = mNavBarHelper.getA11yButtonState();boolean clickable =(a11yFlags & SYSUI_STATE_A11Y_BUTTON_CLICKABLE)!=0;boolean longClickable =(a11yFlags & SYSUI_STATE_A11Y_BUTTON_LONG_CLICKABLE)!=0;//新增修改：boolean overviewDisabled =(mDisabledFlags &View.STATUS_BAR_DISABLE_RECENT)!=0|| mIsHomeGestureBlocked;boolean homeDisabled =(mDisabledFlags &View.STATUS_BAR_DISABLE_HOME)!=0|| mIsHomeGestureBlocked;//*/ mSysUiState.setFlag(SYSUI_STATE_A11Y_BUTTON_CLICKABLE, clickable).setFlag(SYSUI_STATE_A11Y_BUTTON_LONG_CLICKABLE, longClickable).setFlag(SYSUI_STATE_IME_SHOWING,(mNavigationIconHints & NAVIGATION_HINT_BACK_ALT)!=0).setFlag(SYSUI_STATE_IME_SWITCHER_SHOWING,(mNavigationIconHints & NAVIGATION_HINT_IME_SWITCHER_SHOWN)!=0)//新增修改：.setFlag(SYSUI_STATE_OVERVIEW_DISABLED, overviewDisabled /*(mDisabledFlags & View.STATUS_BAR_DISABLE_RECENT) != 0*/).setFlag(SYSUI_STATE_HOME_DISABLED, homeDisabled /*(mDisabledFlags & View.STATUS_BAR_DISABLE_HOME) != 0*/)//*/.setFlag(SYSUI_STATE_BACK_DISABLED,(mDisabledFlags &View.STATUS_BAR_DISABLE_BACK)!=0).setFlag(SYSUI_STATE_NAV_BAR_HIDDEN,!isWindowVisible()).setFlag(SYSUI_STATE_ALLOW_GESTURE_IGNORING_BAR_VISIBILITY,allowSystemGestureIgnoringBarVisibility()).setFlag(SYSUI_STATE_IMMERSIVE_MODE,isImmersiveMode()).commitUpdate(mDisplayId);}

还有一种思路是在 Launcher 做屏蔽处理，例如在 Launcher3 的源码中处理，在 TouchInteractionService 的 onInputEvent 方法中直接返回即可。

Launcher3/quickstep/src/com/android/quickstep/TouchInteractionService.java publicvoidonInputEvent(InputEvent ev){if(needInterceptHome()){return;}...}