Android 2.3.3自定义菜单图标显示发黑问题求助

这个问题我太熟悉了——Android 2.3.3（API Level 10）属于Honeycomb（Android 3.0）之前的版本，系统默认会对选项菜单的图标强制应用单色滤镜：把图标里所有非透明的区域统一渲染成黑色（或者系统主题中android:textColorPrimary指定的颜色），这就是你看到图标发黑的核心原因。单独打开图标正常是因为没有触发系统的这个自动滤镜处理。

下面给你几个靠谱的解决方案，按实现复杂度排序：

方案1：清除系统的图标颜色滤镜（最推荐） #

在onCreateOptionsMenu方法中，遍历所有菜单项，手动清除图标的颜色滤镜，恢复图标原本的色彩。代码示例如下：

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // 加载你的菜单布局
    getMenuInflater().inflate(R.menu.your_menu_layout, menu);

    // 遍历每个菜单项，处理图标
    for (int i = 0; i < menu.size(); i++) {
        MenuItem menuItem = menu.getItem(i);
        Drawable icon = menuItem.getIcon();
        
        if (icon != null) {
            // 清除颜色滤镜，恢复原始颜色
            icon.clearColorFilter();
            // 调用mutate()避免多个Drawable共享状态（防止修改一个图标影响其他地方）
            icon.mutate();
            // 重新设置图标
            menuItem.setIcon(icon);
        }
    }
    return true;
}

这个方法简单直接，不需要修改图标资源，只需要几行代码就能解决问题。

方案2：自定义菜单布局（适合需要完全自定义样式的场景） #

如果你的菜单需要更个性化的样式，完全可以绕过系统默认的菜单渲染逻辑，使用自定义布局来实现菜单：

1. 先创建一个自定义的菜单布局文件（比如layout/custom_menu_item.xml），在布局中直接使用ImageView显示你的图标，这样系统就不会对图标应用滤镜。
2. 在onCreateOptionsMenu中，替换系统默认的菜单项为自定义布局：

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // 这里可以不加载系统菜单，直接构建自定义菜单
    MenuItem item = menu.add("自定义菜单");
    item.setActionView(R.layout.custom_menu_item);
    // 设置点击事件
    item.setOnMenuItemClickListener(new MenuItem.OnMenuItemClickListener() {
        @Override
        public boolean onMenuItemClick(MenuItem item) {
            // 处理点击逻辑
            return true;
        }
    });
    return true;
}

这个方案自由度更高，但需要你自己处理菜单的布局和交互逻辑，适合对菜单样式有特殊要求的场景。

注意事项 #

• 确保你的图标是带Alpha通道的PNG格式：系统滤镜只会作用于非透明区域，透明部分不受影响。如果图标本身没有透明通道，可能会出现整个图标变黑的情况。
• 测试时一定要用Android 2.3.3的设备或模拟器：高版本Android系统已经取消了这个强制滤镜的逻辑，在高版本上测试可能看不到问题。

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