Android 调用openContextMenu打开上下文菜单时未正确应用主题样式

问题根因 #

• 系统原生长按触发上下文菜单的流程，会自动沿视图层级链，结合当前Activity绑定的Theme.MaterialComponents主题属性，完成完整的样式解析，最终弹出匹配Material规范的菜单样式。
• 所有主动调用类API（包括Activity.openContextMenu()、View.showContextMenu()、View.performLongClick()），在触发菜单时都存在样式解析链路断档：
  1. 从Android 12开始，Material组件库对系统上下文菜单的样式接管逻辑，只绑定在原生长按的触发分支上。主动调用类的触发入口最终会走ViewInitializers的框架层默认实现分支，构造菜单时直接使用应用全局Context的基础主题初始化，不会读取当前Activity设置的Material派生主题中的菜单相关属性（比如圆角、文字配色、阴影、内边距等Material组件库定义的样式规则）。
  2. 你观察到android:itemBackground这类配置在两种触发方式下都能生效，是因为这类属性属于框架层的菜单基础配置，在视图构造分支中就会被直接解析，不属于Material组件库扩展的样式体系，因此不会受到链路断档的影响。

修复方案 #

方案1：绕过原生主动触发的断链路径，复用菜单构建逻辑 #

放弃使用系统提供的主动打开上下文菜单的API，直接基于Material组件库提供的菜单组件实现弹出逻辑，从根源上匹配主题样式：
在列表项的点击监听中替换原有触发逻辑：

viewHolder.itemView.setOnClickListener(v -> {
    // 用MaterialPopupMenu构造菜单，自动继承当前Activity的Material主题
    MaterialPopupMenu popupMenu = new MaterialPopupMenu(v.getContext(), v);
    Activity activity = (Activity) v.getContext();
    // 直接复用之前写在OnCreateContextMenuListener里的菜单构建逻辑，无需重复定义菜单项
    activity.onCreateContextMenu(
        (ContextMenu) popupMenu.getMenu(),
        v,
        new ContextMenu.ContextMenuInfo() {}
    );
    popupMenu.show();
});

这种方式弹出的菜单，所有样式属性都会和系统长按触发的菜单完全统一，不存在视觉差异。

方案2：手动补全主题解析节点 #

如果必须保留原有原生上下文菜单的实现逻辑，只需要给目标视图手动指定菜单的主题覆盖层，就能让两种触发路径的样式保持一致：

1. 先在主题资源中定义适配Material规范的菜单主题覆盖层：

   <style name="AppTheme.Menu.ContextMenu" parent="ThemeOverlay.MaterialComponents.DarkSurface">
       <item name="android:popupBackground">@drawable/bg_material_menu</item>
       <item name="android:textColor">@color/menu_text_primary</item>
   </style>
   

2. 在RecyclerView的bind方法中，替换原来的默认上下文菜单注册逻辑，给视图设置主题覆盖层标记：

   // 替换原有setOnCreateContextMenuListener的注册逻辑
   viewHolder.itemView.setTag(
       com.google.android.material.R.id.material_menu_theme_overlay,
       R.style.AppTheme_Menu_ContextMenu
   );
   

注意：不要尝试通过调用View.performLongClick()的方式模拟长按触发菜单，不同厂商定制ROM对这个方法的实现存在大量分支差异，部分场景下根本不会走完整的上下文菜单弹出流程，不仅样式不统一，还会出现菜单弹出失败的兼容问题。

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