MAUI调用Launcher/Browser后返回主窗口问题求助

问题说明 #

应用导航流程：主视图（带菜单）→ 点击按钮进入列表视图 → 选择列表项打开模态窗口。在模态窗口中，通过Launcher打开YouTube视频，或用Browser打开文档，返回应用时直接回到主视图，而非停留在之前的模态窗口。该功能在Xamarin.Forms中可正常工作。

相关代码片段 #

打开外部链接的核心代码

• 启动YouTube视频：

await Launcher.Default.OpenAsync(new Uri($"vnd.youtube://{link}"));

• 打开文档：

await Browser.Default.OpenAsync(new Uri(link.ToString()), BrowserLaunchMode.SystemPreferred);

触发操作的XAML控件（图片点击）

<Image Grid.Row="9" Grid.Column="1" HeightRequest="50" WidthRequest="50" HorizontalOptions="Start" IsVisible="{Binding HasDocumentLink}" Source="pdf_icon" >
 <Image.GestureRecognizers>
   <TapGestureRecognizer Tapped="Document_Tapped" CommandParameter="{Binding BoardGame.TutorialLink}" NumberOfTapsRequired="1" />
 </Image.GestureRecognizers>
</Image>

视图模型中处理点击的方法

private void Document_Tapped(object sender, EventArgs e)
{
  var link = ((TappedEventArgs)e).Parameter;
  Browser.Default.OpenAsync(new Uri(link.ToString()), BrowserLaunchMode.SystemPreferred);
}

打开模态窗口的代码

• 列表项触发XAML：

<Grid.GestureRecognizers>
  <TapGestureRecognizer Command="{Binding BindingContext.TapCommand, Source={x:Reference BoardGamesView}}" CommandParameter="{Binding .}" NumberOfTapsRequired="1"/>
 </Grid.GestureRecognizers>

• 视图模型打开模态窗口方法：

private void OnItemTapped(BoardGame boardGame)
{
 App.Current.MainPage.Navigation.PushModalAsync(new BoardGamePage(boardGame), false);
}

问题原因 #

MAUI的导航栈处理逻辑和Xamarin.Forms存在差异，调用系统级外部应用（YouTube、浏览器）时，应用进程可能被系统暂时挂起，返回时导航栈状态未正确恢复。另外，直接使用App.Current.MainPage.Navigation进行模态导航，在部分平台上易导致状态丢失。

解决方案 #

1. 改用当前页面的Navigation实例发起模态导航 #

避免使用全局App.Current.MainPage.Navigation，改用当前列表页面的Navigation对象触发模态窗口：

// 在列表页面的代码逻辑中（如代码后置文件或绑定的命令方法）
private async void OnItemTapped(BoardGame boardGame)
{
 await this.Navigation.PushModalAsync(new BoardGamePage(boardGame), false);
}

如果采用MVVM模式，可通过弱引用传递当前页面的Navigation实例给视图模型，避免内存泄漏。

2. 调整Browser/Launcher的启动模式 #

• 针对浏览器打开场景，将BrowserLaunchMode改为LaunchAdjacent，让浏览器在应用相邻进程启动，更利于状态恢复：

await Browser.Default.OpenAsync(new Uri(link.ToString()), BrowserLaunchMode.LaunchAdjacent);

• 针对Launcher启动YouTube场景，指定LaunchOptions保持栈状态：

var options = new LauncherOptions
{
    LaunchAdjacent = true
};
await Launcher.Default.OpenAsync(new Uri($"vnd.youtube://{link}"), options);

3. 配置Android启动模式（Android平台） #

在Android项目的AndroidManifest.xml中，将主Activity的启动模式设为singleTop，避免系统重新创建活动：

<activity android:name=".MainActivity" android:launchMode="singleTop">

验证步骤 #

1. 替换模态导航方式为当前页面的Navigation实例
2. 修改Browser/Launcher的启动参数
3. 测试打开外部链接后返回应用，确认是否停留在模态窗口

内容的提问来源于stack exchange，提问作者K. Moteluk