S-Pen触发菜单列表强制回滚至顶部的滚动异常问题问询

这是个典型的三星设备S-Pen与AndroidX组件的兼容问题，我之前在适配三星Note系列时也碰到过类似的触控事件异常，咱们从原因到解决方案一步步梳理：

问题原因分析 #

1. AndroidX与原生PopupMenu的实现差异：AndroidX的androidx.appcompat.widget.PopupMenu基于自定义PopupWindow和ListView实现，而原生android.widget.PopupMenu直接复用系统层级的菜单容器。三星One UI在Android 11上对S-Pen的触控事件分发有特殊逻辑，AndroidX组件的事件处理未适配这种逻辑。
2. S-Pen事件被误判：当S-Pen接触菜单列表时，AndroidX的菜单容器可能将S-Pen的ACTION_DOWN事件误识别为“菜单外部点击”，或触发了列表的初始定位逻辑，导致列表强制滚动回顶部。原生组件因和系统框架深度集成，不会出现这种误判。
3. 三星触控框架的特殊处理：三星Note系列的S-Pen事件带有专属工具类型标记，AndroidX的ListView未正确处理这类标记的事件，导致滚动事件被中断或重置。

可行解决方案 #

方案1：自定义触控事件拦截（推荐） #

通过为PopupMenu内部的ListView设置自定义OnTouchListener，拦截S-Pen事件并确保滚动逻辑正常执行：

// 弹出PopupMenu的代码示例
PopupMenu popupMenu = new PopupMenu(this, overflowButton);
getMenuInflater().inflate(R.menu.example_menu, popupMenu.getMenu());

popupMenu.show();

// 获取内部ListView并设置触控监听
View popupContentView = popupMenu.getPopup().getContentView();
if (popupContentView instanceof ListView) {
    ListView menuListView = (ListView) popupContentView;
    menuListView.setOnTouchListener((v, event) -> {
        // 识别S-Pen事件
        if (event.getToolType(0) == MotionEvent.TOOL_TYPE_STYLUS) {
            // 阻止父容器拦截滚动事件，避免列表被重置
            v.getParent().requestDisallowInterceptTouchEvent(true);
            if (event.getAction() == MotionEvent.ACTION_UP) {
                // 抬起S-Pen时恢复父容器的拦截权限
                v.getParent().requestDisallowInterceptTouchEvent(false);
            }
        }
        // 返回false让ListView正常处理触摸事件
        return false;
    });
}

核心逻辑是阻止父布局拦截S-Pen的滚动事件，避免AndroidX的PopupWindow错误触发列表重置。

方案2：切换至原生PopupMenu #

如果业务场景允许，直接替换为android.widget.PopupMenu——你已经验证过原生组件的滚动行为是正常的。注意调整菜单XML属性：将app:showAsAction改为android:showAsAction，确保兼容性。
示例代码：

android.widget.PopupMenu nativePopup = new android.widget.PopupMenu(this, overflowButton);
getMenuInflater().inflate(R.menu.example_menu, nativePopup.getMenu());
nativePopup.setOnMenuItemClickListener(item -> {
    // 处理菜单点击逻辑
    return true;
});
nativePopup.show();

方案3：升级AndroidX AppCompat库 #

检查当前项目的androidx.appcompat:appcompat版本，尝试升级到1.4.0及以上。Google在后续版本中修复了不少触控笔相关的兼容问题，可能已经解决了这个异常。

方案4：三星设备专属适配 #

如果只需要针对三星设备修复，可以通过Build.MANUFACTURER判断设备品牌，再单独应用方案1的拦截逻辑：

if (Build.MANUFACTURER.equalsIgnoreCase("samsung")) {
    // 应用方案1的TouchListener逻辑
}

总结 #

优先尝试方案3升级AndroidX版本，如果无法升级则用方案1自定义拦截，业务允许的话也可以直接切换到原生PopupMenu。这些方案都能有效解决三星Note20上S-Pen滚动菜单回顶的问题。

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