MAUI Windows应用URI启动多实例问题：如何实现单实例运行

核心问题原因 #

MAUI Windows应用默认并非单实例模式，所以每次通过URI激活都会创建新实例。和Xamarin.Forms的OnActivated逻辑不同，MAUI需要结合单实例配置和激活事件处理来实现复用。

分步解决 #

1. 启用Windows单实例支持 #

在Platforms/Windows/App.xaml.cs中修改启动逻辑，启用单实例并定义重复激活时的处理逻辑：

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    base.OnLaunched(args);

    // 启用单实例，替换为你的应用唯一标识（比如反向域名）
    this.UseSingleInstance("com.yourcompany.yourapp", OnSecondInstanceActivated);
}

// 处理第二个实例激活事件
private void OnSecondInstanceActivated(object sender, SecondInstanceActivatedEventArgs e)
{
    // 提取URI参数
    if (e.Arguments is IReadOnlyList<string> activationArgs && activationArgs.Count > 0)
    {
        var uri = activationArgs[0];
        // 切换到MAUI主线程处理URI
        App.Current.Dispatcher.Dispatch(() =>
        {
            // 调用自定义的URI处理方法（需在主页面实现）
            if (App.Current.MainPage is MainPage mainPage)
            {
                mainPage.ProcessActivationUri(uri);
            }
        });
    }

    // 将现有应用窗口前置
    var activeWindow = Application.Current.Windows.FirstOrDefault();
    activeWindow?.Activate();
}

2. 统一URI处理逻辑 #

在你的主页面（比如MainPage.xaml.cs）中定义URI处理方法，用于接收首次启动和后续激活的URI：

public void ProcessActivationUri(string uri)
{
    // 这里编写你的业务逻辑：解析URI参数、导航到对应页面等
    // 示例：
    // var parsedParams = ParseUriParams(uri);
    // Navigation.PushAsync(new TargetPage(parsedParams));
    Console.WriteLine($"收到激活URI: {uri}");
}

3. 处理首次启动的URI #

如果应用是通过URI首次启动，需要在MAUI的App.xaml.cs中获取启动参数并传递给处理方法：

protected override void OnStart()
{
    base.OnStart();
    var launchUri = AppInfo.Current.RequestedUri?.ToString();
    if (!string.IsNullOrEmpty(launchUri) && MainPage is MainPage mainPage)
    {
        mainPage.ProcessActivationUri(launchUri);
    }
}

4. 确认协议配置（package.appxmanifest） #

确保你的协议配置正确，默认生成的配置即可，无需额外修改（除非你自定义了入口）：

<Extensions>
  <uap:Extension Category="windows.protocol">
    <uap:Protocol Name="your-app-protocol"> <!-- 替换为你的协议名 -->
      <uap:DisplayName>Your App Protocol</uap:DisplayName>
    </uap:Protocol>
  </uap:Extension>
</Extensions>

关键注意事项 #

• 单实例是前提：必须通过UseSingleInstance启用单实例，否则所有URI激活都会生成新进程。
• 主线程调度：MAUI的UI操作必须在主线程执行，所以要用Dispatcher.Dispatch切换线程。
• 窗口前置：务必调用activeWindow?.Activate()，确保用户看到的是现有实例而非被隐藏的窗口。

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