Xamarin iOS Shell应用点击推送通知跳转页面问题求助

核心问题分析 #

iOS端推送唤起应用分两种场景：

• 冷启动：应用完全关闭，点击通知启动，会调用FinishedLaunching
• 后台唤起：应用在后台，点击通知唤起，会调用DidReceiveRemoteNotification或WillPresentNotification（iOS 10+）

你之前的问题大多是导航时机不对，或是Shell未完成初始化就执行跳转导致的。

标准实现步骤 #

1. 冷启动场景处理（AppDelegate.cs） #

在FinishedLaunching中先完成App和Shell的初始化，再标记需要跳转，延迟到Shell就绪后执行：

public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
    global::Xamarin.Forms.Forms.Init();
    LoadApplication(new App());

    // 处理冷启动时的推送参数
    if (options != null && options.ContainsKey(UIApplication.LaunchOptionsRemoteNotificationKey))
    {
        App.Current.Properties["NeedNavigateToEvents"] = true;
    }

    return base.FinishedLaunching(app, options);
}

2. 后台唤起场景处理（AppDelegate.cs） #

在DidReceiveRemoteNotification中，确保在主线程执行导航：

public override void DidReceiveRemoteNotification(UIApplication application, NSDictionary userInfo, Action<UIBackgroundFetchResult> completionHandler)
{
    if (Shell.Current != null)
    {
        // iOS UI操作必须在主线程执行
        Device.BeginInvokeOnMainThread(async () =>
        {
            await Shell.Current.GoToAsync(nameof(EventsPage));
        });
    }
    else
    {
        // 极端情况Shell未初始化，标记跳转
        App.Current.Properties["NeedNavigateToEvents"] = true;
    }

    completionHandler(UIBackgroundFetchResult.NoData);
}

3. Shell初始化完成后执行跳转（AppShell.xaml.cs） #

在Shell构造函数中，延迟执行跳转确保UI完全就绪：

public AppShell()
{
    InitializeComponent();

    // 必须注册目标页面路由
    Routing.RegisterRoute(nameof(EventsPage), typeof(EventsPage));

    // 短延迟确保Shell加载完成
    Device.BeginInvokeOnMainThread(async () =>
    {
        await Task.Delay(500);
        if (App.Current.Properties.ContainsKey("NeedNavigateToEvents") && (bool)App.Current.Properties["NeedNavigateToEvents"])
        {
            await Shell.Current.GoToAsync(nameof(EventsPage));
            // 移除标记避免重复跳转
            App.Current.Properties.Remove("NeedNavigateToEvents");
            await App.Current.SavePropertiesAsync();
        }
    });
}

你之前尝试的问题点 #

• 方法2：未在主线程执行跳转，iOS所有UI操作（包括导航）必须在主线程运行
• 方法3：App构造函数中订阅时，Shell还未初始化，此时跳转无法生效
• 方法4：AppShell构造函数末尾订阅MessagingCenter时，消息可能已经发送完毕，导致错过接收

额外注意事项 #

• 必须注册Shell路由：目标页面未注册路由时，GoToAsync会直接失效
• 冷启动时不能直接在FinishedLaunching跳转：此时Shell还未完成加载，导航无法执行

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