.NET MAUI 8 iOS平台Tap Gesture Recognizer无响应问题求助

问题场景 #

在.NET MAUI 8开发的应用中，实现了一个带返回主页功能的Image控件，Android平台上TapGestureRecognizer绑定的命令可正常执行PopAsync返回主页，但iOS平台上无论是绑定命令还是替换为Tapped事件，都无法触发交互逻辑。

相关代码如下：
XAML布局：

<Image
    Aspect="AspectFill"
    BackgroundColor="Transparent"
    HeightRequest="20"
    HorizontalOptions="StartAndExpand"
    Rotation="{AppThemeBinding Light='180',
                               Dark='0'}"
    Source="{AppThemeBinding Light='arrow_right.png',
                             Dark='arrow_left.png'}"
    VerticalOptions="CenterAndExpand"
    WidthRequest="26">
    <Image.GestureRecognizers>
        <TapGestureRecognizer Command="{Binding PopToDashboardCommand}" />
    </Image.GestureRecognizers>
</Image>

命令定义与执行逻辑：

public ICommand PopToDashboardCommand { get; private set; }

await App.Instance.MainNavigationPage.PopAsync(isAnimated);

解决方案 #

• 显式设置Image的IsEnabled属性
  iOS平台上Image控件默认可能未启用交互，添加IsEnabled="True"属性确保控件可响应触摸：

  <Image
      IsEnabled="True"
      Aspect="AspectFill"
      BackgroundColor="Transparent"
      HeightRequest="20"
      HorizontalOptions="StartAndExpand"
      Rotation="{AppThemeBinding Light='180',
                                 Dark='0'}"
      Source="{AppThemeBinding Light='arrow_right.png',
                               Dark='arrow_left.png'}"
      VerticalOptions="CenterAndExpand"
      WidthRequest="26">
      <Image.GestureRecognizers>
          <TapGestureRecognizer Command="{Binding PopToDashboardCommand}" />
      </Image.GestureRecognizers>
  </Image>
  

• 用Frame包裹Image，将GestureRecognizer绑定到Frame
  部分iOS环境下Image的触摸区域识别存在问题，改用Frame承载Image并绑定手势，能提升交互可靠性：

  <Frame
      BackgroundColor="Transparent"
      Padding="0"
      HeightRequest="20"
      WidthRequest="26"
      HorizontalOptions="StartAndExpand"
      VerticalOptions="CenterAndExpand">
      <Frame.GestureRecognizers>
          <TapGestureRecognizer Command="{Binding PopToDashboardCommand}" />
      </Frame.GestureRecognizers>
      <Image
          Aspect="AspectFill"
          BackgroundColor="Transparent"
          Rotation="{AppThemeBinding Light='180',
                                     Dark='0'}"
          Source="{AppThemeBinding Light='arrow_right.png',
                                   Dark='arrow_left.png'}" />
  </Frame>
  

• 确认命令的正确初始化
  确保PopToDashboardCommand在ViewModel构造函数中完成实例化，例如使用RelayCommand（需引用CommunityToolkit.Mvvm）：

  using CommunityToolkit.Mvvm.Input;
  
  public class YourViewModel
  {
      public ICommand PopToDashboardCommand { get; private set; }
  
      public YourViewModel()
      {
          PopToDashboardCommand = new RelayCommand(async () =>
          {
              await App.Instance.MainNavigationPage.PopAsync(true);
          });
      }
  }
  

• 验证NavigationPage实例的有效性
  确认App.Instance.MainNavigationPage在iOS平台上已正确初始化并设置为应用的主导航容器，避免因导航实例为空导致命令执行无响应。

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