为何UITapGestureRecognizer在keyWindow的全屏子视图中无法生效？

最近遇到一个挺典型的问题——之前在《UIView作为UIWindow子视图时无法响应点击》的讨论里提过，但觉得单独拆出来讲更清晰：当我们把自定义UIView子类（比如叫CustomView）添加到UIWindow时，有时候视图内的手势完全没反应，但换个添加姿势就一切正常。另外提个小细节：用.windows[0]替代.keyWindow能保留状态栏，但如果要实现全屏显示CustomView，得手动把状态栏隐藏掉。

两种不同的CustomView设置方式 #

先看两种对比场景：

• 手势失效的添加方式：

let customView = CustomView(frame: UIScreen.main.bounds)
UIApplication.shared.windows[0].addSubview(customView)
// 没做关键配置，导致手势无法触发

• 手势正常的添加方式：

let customView = CustomView(frame: UIScreen.main.bounds)
customView.isUserInteractionEnabled = true // 显式开启交互
UIApplication.shared.windows[0].addSubview(customView)
UIApplication.shared.windows[0].bringSubviewToFront(customView) // 确保视图在最上层

手势失效的常见原因分析 #

1. 用户交互未开启：
   UIView默认isUserInteractionEnabled为true，但如果在CustomView的初始化代码里不小心把它设为false，或者父视图（比如window的其他子视图）的交互被关闭，都会导致手势事件被拦截。

2. 视图层级被遮挡：
   如果window上已经有其他子视图（比如导航栏、tabBar或者其他弹窗），新添加的CustomView可能被压在下层，哪怕上层视图是透明的，也会挡住手势事件。

3. 手势添加对象错误：
   如果手势没有正确添加到CustomView本身，而是误加到了window或者其他无关视图上，自然无法触发CustomView内的响应逻辑。比如这种错误示例：

// 错误：把手势加到了window上，而非CustomView
let tapGesture = UITapGestureRecognizer(target: self, action: #selector(tapHandler))
UIApplication.shared.windows[0].addGestureRecognizer(tapGesture)

4. window状态异常：
   虽然.windows[0]能保留状态栏，但要确认这个window是当前活跃的、能接收事件的窗口——有些场景下app可能存在多个window，加错窗口也会导致手势失效。

针对性解决步骤 #

1. 强制开启交互权限：
   在CustomView的初始化代码里显式设置isUserInteractionEnabled = true，避免默认值被意外修改：

class CustomView: UIView {
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupGesture()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupGesture()
    }
    
    private func setupGesture() {
        self.isUserInteractionEnabled = true // 显式开启更稳妥
        let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleTap))
        self.addGestureRecognizer(tapGesture) // 手势绑定到当前视图
    }
    
    @objc private func handleTap() {
        print("CustomView 被点击啦！")
    }
}

2. 调整视图层级：
   添加CustomView后，调用bringSubviewToFront确保它在window的子视图最上层：

let window = UIApplication.shared.windows[0]
window.addSubview(customView)
window.bringSubviewToFront(customView)

3. 手动隐藏状态栏（全屏需求）：
   如果需要全屏显示CustomView，在添加视图时同步隐藏状态栏：

// iOS 12及以下
UIApplication.shared.isStatusBarHidden = true

// iOS 13+ 适配多场景
if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene {
    windowScene.statusBarManager?.isStatusBarHidden = true
}

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