开发中Xamarin iOS应用无法显示通知与弹窗求助

平台 #

• iOS 16、17

软硬件配置 #

• 测试设备：搭载iOS 15、16、17的iPhone
• 开发环境：最新Visual Studio开发Xamarin应用，配对Mac通过Xcode 14.3构建
• 推送流程：服务器→Google Firebase→APNs

详细问题 #

我们开发的跨平台Xamarin应用包含登录页和网页视图页，Android端功能完全正常，但iOS端存在两个核心问题：

1. 无法接收Firebase推送的通知（服务器/Firebase控制台发送的测试通知均无响应）
2. 无法弹出任何提示框（包括UIAlertController原生提示和Xamarin自带的DisplayAlert）

已完成的配置与验证：

• 配置文件已启用APNs，Entitlements.plist配置如下：

  <dict>
      <key>aps-environment</key>
      <string>production</string>
  </dict>
  

• 已用Apple开发者账号的APNs私钥配置Google Firebase，且验证通知已从Firebase转发至APNs
• iPhone应用已成功获取Firebase令牌
• 已检查多台iOS 16/17设备的通知权限设置，均无异常
• 已查阅StackOverflow相关英文解答，未解决问题

重现步骤 #

1. 在iPhone上安装并运行应用
2. 完成登录流程进入网页视图页（流程正常）
3. 从服务器或Firebase测试控制台发送通知
4. iPhone无通知显示（Android端正常）
5. 尝试触发应用内提示框，无响应

一、提示框失效问题 #

提示框全失效通常是UI线程调用问题或权限/应用状态异常：

1. 确保所有提示框调用在UI主线程执行：
   Xamarin iOS中需用InvokeOnMainThread包裹：

   Device.BeginInvokeOnMainThread(() =>
   {
       DisplayAlert("标题", "内容", "确定");
   });
   

   原生UIAlertController同理，必须在主线程present：

   UIApplication.SharedApplication.KeyWindow.RootViewController.InvokeOnMainThread(() =>
   {
       var alert = UIAlertController.Create("标题", "内容", UIAlertControllerStyle.Alert);
       alert.AddAction(UIAlertAction.Create("确定", UIAlertActionStyle.Default, null));
       UIApplication.SharedApplication.KeyWindow.RootViewController.PresentViewController(alert, true, null);
   });
   

2. 检查应用前台状态：若应用处于后台挂起状态，主线程可能无法执行UI操作，需确保前台触发提示框时主线程可用。

二、推送通知失效问题 #

结合提示框异常，优先排查权限申请流程和配置一致性：

1. 确认通知权限已正确申请：
   在AppDelegate的FinishedLaunching方法中添加权限请求代码：

   UNUserNotificationCenter.Current.RequestAuthorization(UNAuthorizationOptions.Alert | UNAuthorizationOptions.Badge | UNAuthorizationOptions.Sound, (granted, error) =>
   {
       if (granted)
       {
           UIApplication.SharedApplication.RegisterForRemoteNotifications();
       }
   });
   

   注意：iOS 10+必须使用UNUserNotificationCenter，旧API已废弃。
2. 检查Info.plist配置：
   • 添加UIBackgroundModes键，包含remote-notification值，确保应用后台能接收通知：

     <key>UIBackgroundModes</key>
     <array>
         <string>remote-notification</string>
     </array>
     

   • 确认CFBundleIdentifier（Bundle ID）与Apple开发者后台、Firebase配置的GoogleService-Info.plist中的BUNDLE_ID完全一致，大小写敏感！
3. 核对环境一致性：
   • 若使用测试环境（Ad Hoc/Development），aps-environment应设为development，而非production；生产环境才用production。测试包配生产环境APNs会被拒绝推送。
   • 检查Firebase控制台的iOS应用配置：确保上传的APNs私钥对应当前环境（开发者私钥对应开发环境，生产私钥对应生产环境）。
4. 验证AppDelegate的通知回调是否实现：
   必须实现以下方法确保通知能被处理：

   public override void RegisteredForRemoteNotifications(UIApplication application, NSData deviceToken)
   {
       var token = deviceToken.Description.Trim('<', '>').Replace(" ", "");
       Firebase.Messaging.Messaging.Instance.ApnsToken = deviceToken;
   }
   
   public override void DidReceiveRemoteNotification(UIApplication application, NSDictionary userInfo, Action<UIBackgroundFetchResult> completionHandler)
   {
       Firebase.Messaging.Messaging.Instance.AppDidReceiveMessage(userInfo);
       completionHandler(UIBackgroundFetchResult.NewData);
   }
   

5. 检查设备通知细节：
   • 确认应用的“允许通知”开关开启，且“横幅样式”“声音”等未被禁用
   • iOS 16+需检查“通知调度”是否设置为“立即”，而非“计划通知”

三、关联问题排查 #

提示框和通知同时失效，可能是应用主线程阻塞或权限未正确授予：

• 使用Xcode调试工具查看应用日志，搜索APNs、notification、alert相关错误信息，定位具体失败原因
• 检查应用是否被系统限制了后台刷新、通知等权限

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