iOS前台自定义推送通知弹窗：如何挂载视图至最上层？

嗨，这个问题我做项目的时候也碰到过，核心痛点就是要找一个全局的、始终在最顶层的容器来挂载弹窗，完全不用管当前哪个ViewController处于活跃状态。下面给你两种亲测好用的实现思路：

方法一：用独立的UIWindow承载弹窗 #

UIWindow本身就是iOS视图层级里最高级别的容器，完全独立于当前的ViewController栈，非常适合做这种全局弹窗。

具体步骤： #

• 自定义一个PopupWindow类继承自UIWindow，设置它的windowLevel为UIWindowLevelAlert + 1，确保它能显示在系统弹窗（比如系统自带的通知弹窗）的上方：

  class PopupWindow: UIWindow {
      static let shared = PopupWindow()
      
      override init(frame: CGRect) {
          super.init(frame: UIScreen.main.bounds)
          self.windowLevel = UIWindowLevelAlert + 1
          self.backgroundColor = .clear
          self.rootViewController = UIViewController()
          self.isHidden = false
      }
      
      required init?(coder: NSCoder) {
          fatalError("init(coder:) has not been implemented")
      }
  }
  

• 当收到前台推送时，实例化你的自定义弹窗视图，添加到PopupWindow.shared.rootViewController.view上，然后执行滑入动画：

  func showPushPopup(title: String, content: String) {
      let popupView = CustomPushPopupView(title: title, content: content) // 你的自定义弹窗视图
      popupView.frame = CGRect(x: 0, y: -popupView.bounds.height, width: UIScreen.main.bounds.width, height: popupView.bounds.height)
      
      PopupWindow.shared.rootViewController.view.addSubview(popupView)
      
      // 滑入动画
      UIView.animate(withDuration: 0.3, animations: {
          popupView.frame.origin.y = 0
      })
      
      // 3秒后滑出消失
      DispatchQueue.main.asyncAfter(deadline: .now() + 3) {
          UIView.animate(withDuration: 0.3, animations: {
              popupView.frame.origin.y = -popupView.bounds.height
          }, completion: { _ in
              popupView.removeFromSuperview()
          })
      }
  }
  

• 这种方法的好处是弹窗完全不受当前页面的影响，就算页面跳转、模态弹窗弹出，它也能稳稳地显示在最顶层。

方法二：挂载到当前活跃窗口的根视图 #

如果不想额外创建UIWindow，也可以直接把弹窗挂载到当前活跃窗口的根ViewController视图上，同样能实现全局显示的效果。

具体步骤： #

• 先写一个工具方法，获取当前活跃的keyWindow（适配iOS13+的多场景）：

  func getCurrentKeyWindow() -> UIWindow? {
      if #available(iOS 13.0, *) {
          return UIApplication.shared.connectedScenes
              .filter { $0.activationState == .foregroundActive }
              .compactMap { $0 as? UIWindowScene }
              .first?.windows
              .first(where: \.isKeyWindow)
      } else {
          return UIApplication.shared.keyWindow
      }
  }
  

• 收到推送时，拿到keyWindow的rootViewController，把弹窗添加到它的view上：

  func showPushPopup(title: String, content: String) {
      guard let rootView = getCurrentKeyWindow()?.rootViewController?.view else { return }
      
      let popupView = CustomPushPopupView(title: title, content: content)
      popupView.frame = CGRect(x: 0, y: -popupView.bounds.height, width: rootView.bounds.width, height: popupView.bounds.height)
      popupView.layer.zPosition = CGFloat.greatestFiniteMagnitude // 确保在所有子视图最上层
      
      rootView.addSubview(popupView)
      
      // 滑入滑出动画和方法一一致
      UIView.animate(withDuration: 0.3) {
          popupView.frame.origin.y = 0
      }
      
      DispatchQueue.main.asyncAfter(deadline: .now() + 3) {
          UIView.animate(withDuration: 0.3, animations: {
              popupView.frame.origin.y = -popupView.bounds.height
          }, completion: { _ in
              popupView.removeFromSuperview()
          })
      }
  }
  

• 注意：如果你的rootViewController是UINavigationController或UITabBarController，添加到它的view上完全没问题，因为这个视图是整个导航/标签栏的根容器，覆盖所有子页面的视图。

额外注意事项 #

• 弹窗复用：可以把自定义弹窗做成单例，或者写一个全局的弹窗管理器，避免重复创建视图，提升性能。
• 多推送处理：如果短时间内收到多个推送，要考虑弹窗的排队或替换逻辑，比如当前弹窗显示时，新推送可以等待上一个消失后再显示，或者直接替换当前弹窗内容。
• 交互控制：如果需要弹窗可点击，记得开启userInteractionEnabled；如果不想让用户点击下层内容，可以在弹窗后面加一个半透明遮罩视图，拦截交互事件。

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