Xamarin.Forms配合Prism开发时iOS工具栏头部图形异常如何解决

1. 工具栏图标全白问题 #

产生原因：iOS平台默认会对导航栏工具栏图标应用模板着色效果，自动将图标非透明区域替换为导航栏的tint颜色，默认导航栏tint为白色时就会出现全白的显示异常。
解决方案：

• 方法1：修改iOS项目内图片资源的渲染属性。在iOS资源目录中选中settings.png和mylogo.gif，将属性栏的「Render As」选项设置为Original Image，即可关闭系统自动着色，原样显示图片内容。
• 方法2：通过自定义渲染器全局控制。在iOS项目中新增ToolbarItem自定义渲染器，强制所有工具栏图标使用原始渲染模式：

[assembly: ExportRenderer(typeof(ToolbarItem), typeof(CustomToolbarItemRenderer))]
namespace YourNamespace.iOS.Renderers
{
    public class CustomToolbarItemRenderer : ToolbarItemRenderer
    {
        protected override void OnElementChanged(ElementChangedEventArgs<ToolbarItem> e)
        {
            base.OnElementChanged(e);
            if (NavigationItem?.RightBarButtonItems != null)
            {
                foreach (var item in NavigationItem.RightBarButtonItems)
                {
                    if (item.Image != null)
                    {
                        item.Image = item.Image.ImageWithRenderingMode(UIImageRenderingMode.AlwaysOriginal);
                    }
                }
            }
        }
    }
}

• 额外注意：iOS原生不支持直接将gif格式作为静态工具栏图标，建议将mylogo.gif替换为png格式的静态图，若需要动效可改用自定义视图嵌入gif播放控件。

2. 图标未靠右对齐问题 #

产生原因：Xamarin.Forms中ToolbarItem的Order属性默认值为Default，在iOS平台默认会将图标排列在导航栏左侧，与Android平台的默认规则不同。
解决方案：

• 在XAML中给每个ToolbarItem显式添加Order="Primary"属性，即可指定图标排列在导航栏右侧：

<ToolbarItem IconImageSource="settings.png" Command="{Binding TapSettingsCommand}" Order="Primary" />
<ToolbarItem IconImageSource="mylogo.png" Command="{Binding TapLogoCommand}" Order="Primary" />

• 若设置后仍有布局偏移，可在iOS项目的AppDelegate.cs的FinishedLaunching方法中添加全局导航栏边距调整代码：

UINavigationBar.Appearance.LayoutMargins = new UIEdgeInsets(0, 0, 0, 16);
UIBarButtonItem.Appearance.BackButtonTitle = "";

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