Android Studio高版本SDK（如33）PopupMenu图标显示异常

问题说明 #

在SDK 33及更高版本的Android系统中，带图标的PopupMenu出现图标不显示的异常，但在SDK 23版本中显示正常。我已经尝试通过setForceShowIcon(true)（针对Q及以上版本）和反射逻辑强制显示图标，但问题依然存在，当前实现代码如下：

//init the wrapper with style
Context wrapper = new ContextThemeWrapper(anchor.getContext(), R.style.MyPopupStyle);

//init the popup
PopupMenu popup = new PopupMenu(wrapper, anchor);

/*  The below code in try catch is responsible to display icons*/
if (isWithIcons) {

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        popup.setForceShowIcon(true);
    } else {
        try {
            Field[] fields = popup.getClass().getDeclaredFields();
            for (Field field : fields) {
                if ("mPopup".equals(field.getName())) {
                    field.setAccessible(true);
                    Object menuPopupHelper = field.get(popup);
                    assert menuPopupHelper != null;
                    Class<?> classPopupHelper = Class.forName(menuPopupHelper.getClass().getName());
                    Method setForceIcons = classPopupHelper.getMethod("setForceShowIcon", boolean.class);
                    setForceIcons.invoke(menuPopupHelper, true);
                    break;
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

//inflate menu
popup.getMenuInflater().inflate(menu, popup.getMenu());

popup.show();

问题根源 #

1. 样式配置缺失：自定义的MyPopupStyle没有正确配置菜单项的图标显示属性，高版本系统默认样式会隐藏图标。
2. 代码执行顺序错误：当前代码先设置强制显示图标，再加载菜单，这会导致后续加载的菜单没有应用图标显示的设置。
3. 反射逻辑失效：Android 11（SDK30）之后，PopupMenu的内部实现有调整，原有反射字段或方法可能不再有效。

解决办法 #

1. 补全自定义PopupMenu样式 #

在styles.xml中添加或完善以下样式，确保菜单项允许显示图标：

<style name="MyPopupStyle" parent="Widget.MaterialComponents.PopupMenu">
    <item name="dropDownItemStyle">@style/MyPopupMenuItemStyle</item>
</style>

<style name="MyPopupMenuItemStyle" parent="Widget.MaterialComponents.ListItem.Menu">
    <!-- 强制显示图标 -->
    <item name="android:iconVisible">true</item>
    <!-- 设置图标大小，可选 -->
    <item name="android:iconSize">24dp</item>
</style>

2. 调整代码执行顺序 #

将加载菜单的代码提前，再设置强制显示图标，确保设置能应用到已加载的菜单项上：

// 初始化上下文和PopupMenu
Context wrapper = new ContextThemeWrapper(anchor.getContext(), R.style.MyPopupStyle);
PopupMenu popup = new PopupMenu(wrapper, anchor);

// 先加载菜单
popup.getMenuInflater().inflate(menu, popup.getMenu());

// 再设置强制显示图标
if (isWithIcons) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        popup.setForceShowIcon(true);
    } else {
        try {
            // 简化反射逻辑，直接获取指定字段
            Field mPopupField = PopupMenu.class.getDeclaredField("mPopup");
            mPopupField.setAccessible(true);
            Object menuPopupHelper = mPopupField.get(popup);
            if (menuPopupHelper != null) {
                Method forceShowIconMethod = menuPopupHelper.getClass().getMethod("setForceShowIcon", boolean.class);
                forceShowIconMethod.invoke(menuPopupHelper, true);
            }
        } catch (NoSuchFieldException | NoSuchMethodException | IllegalAccessException | InvocationTargetException e) {
            e.printStackTrace();
        }
    }
}

popup.show();

3. 改用第三方库（可选） #

如果系统PopupMenu的兼容问题难以彻底解决，可以使用第三方库如MaterialPopupMenu，它对高版本系统的图标显示支持更稳定，无需复杂的兼容代码。

注意事项 #

• 检查菜单资源文件中每个<item>是否正确设置了android:icon属性
• 确保自定义样式的父类选择正确（推荐使用Material Components相关样式）
• 测试时覆盖不同Android版本，确保兼容性

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