.NET MAUI iOS端「更多」栏下标签页切换功能失效问题

问题描述 #

在.NET MAUI应用中，通过代码切换TabBar标签页时，直接显示在TabBar中的标签页可正常跳转，但位于「更多」栏下的标签页，调用GoToAsync只会选中「更多」选项，无法跳转到目标页面。该问题仅在iPhone 14 Plus模拟器（iOS 16.4）中出现，Android和Windows端功能正常。

当前导航代码：

public async void SwitchToLastTab()
{
    await Shell.Current.GoToAsync($"///{nameof(TabPage)}");
}

AppShell.xaml结构：

<Shell
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:MauiTestApplication"
    Shell.FlyoutBehavior="Disabled"
>
    <TabBar x:Name="MainTabBar"/>
</Shell>

解决方案 #

方案1：直接设置TabBar的SelectedItem #

绕过Shell导航的iOS兼容性限制，直接操作TabBar的选中项：

public void SwitchToLastTab()
{
    // 从TabBar中获取目标标签页（示例取最后一个标签）
    var targetTab = MainTabBar.Items.LastOrDefault();
    if (targetTab != null)
    {
        MainTabBar.SelectedItem = targetTab;
    }
}

如果在非Shell类中操作，可通过Shell.Current获取TabBar实例：

var mainTabBar = Shell.Current.Items.OfType<TabBar>().FirstOrDefault();
if (mainTabBar != null)
{
    var targetTab = mainTabBar.Items.LastOrDefault();
    mainTabBar.SelectedItem = targetTab;
}

方案2：自定义iOS Shell渲染器修复导航逻辑 #

若需保留GoToAsync的使用，可通过自定义渲染器处理iOS「更多」栏的特殊逻辑：

1. 在iOS平台项目中创建自定义Shell渲染器：

[assembly: ExportRenderer(typeof(AppShell), typeof(CustomShellRenderer))]
namespace MauiTestApplication.Platforms.iOS
{
    public class CustomShellRenderer : ShellRenderer
    {
        protected override IShellTabBarAppearanceTracker CreateTabBarAppearanceTracker()
        {
            return new CustomTabBarAppearanceTracker();
        }
    }

    public class CustomTabBarAppearanceTracker : IShellTabBarAppearanceTracker
    {
        public void Dispose() { }
        public void ResetAppearance(UITabBarController controller) { }
        public void SetAppearance(UITabBarController controller, ShellAppearance appearance) { }

        public void UpdateLayout(UITabBarController controller)
        {
            if (controller.MoreNavigationController != null)
            {
                controller.MoreNavigationController.Delegate = new MoreNavigationControllerDelegate(controller);
            }
        }
    }

    public class MoreNavigationControllerDelegate : UINavigationControllerDelegate
    {
        private readonly UITabBarController _tabBarController;

        public MoreNavigationControllerDelegate(UITabBarController tabBarController)
        {
            _tabBarController = tabBarController;
        }

        public override void DidShowViewController(UINavigationController navigationController, UIViewController viewController, bool animated)
        {
            base.DidShowViewController(navigationController, viewController, animated);
            if (viewController is UITabBarMoreNavigationController moreNavController)
            {
                var selectedItem = moreNavController.TabBarItem;
                if (selectedItem != null)
                {
                    _tabBarController.SelectedIndex = Array.IndexOf(_tabBarController.TabBar.Items, selectedItem);
                }
            }
        }
    }
}

添加后再调用GoToAsync，iOS端即可正确跳转到「更多」栏下的目标标签页。

方案3：确认路由注册正确性 #

确保目标Tab对应的页面已在AppShell.xaml.cs中正确注册路由：

public AppShell()
{
    InitializeComponent();
    Routing.RegisterRoute(nameof(TabPage), typeof(TabPage));
    // 此处添加TabBar标签页的创建代码
}

总结 #

优先选择方案1，直接操作TabBar的SelectedItem，这种方式简单高效，避免Shell导航在iOS上的兼容性问题；若需保留Shell导航逻辑，再采用方案2的自定义渲染器修复。

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