从iPhone X递归BUG看UI适配

2023-09-19 22:13:35

全面屏时代的 UI 适配陷阱：剖析 iPhone X 递归 BUG

随着全面屏手机的兴起，UI 适配已成为开发者必须正视的难题。本文将以真实开发案例为基础，深入剖析一次发生在 iPhone X 上的递归 BUG，探究其成因并提供解决方案，为广大开发者提供借鉴。

BUG 现象：scrollView 滚动时无休止递归

某日，一场例行版本更新后，公司应用在 iPhone X 上频频崩溃。排查后发现，罪魁祸首竟是主界面的 scrollView。令人不解的是，开发者只对导航栏和自定义底部栏进行了适配，并未对其他 UI 元素进行特殊处理。

成因溯源：Auto Layout 的约束博弈

查看崩溃日志，开发者发现问题出在 viewDidLayoutSubviews 方法中。该方法每逢界面布局发生变化时都会被调用，用来更新子视图的 frame。在该案例中，当 scrollView 滚动时，viewDidLayoutSubviews 会被触发，导致 scrollView 的 contentSize 发生变化，进而再次触发 viewDidLayoutSubviews 的调用，如此循环往复，形成递归，最终引发崩溃。

为何 viewDidLayoutSubviews 会在 scrollView 滚动时被触发？这就涉及到 Auto Layout。Auto Layout 是 iOS 中的一套约束布局系统，允许开发者通过添加约束来定义视图之间的位置关系。当视图的 frame 发生变化时，Auto Layout 会自动调整约束，以保证视图之间的相对位置保持不变。

在该案例中，开发者为 scrollView 添加了垂直滚动约束。当 scrollView 滚动时，它的 frame 会发生变化，进而触发 Auto Layout 的约束调整。由于 scrollView 的 contentSize 由其子视图的 frame 决定，因此当 Auto Layout 调整约束时，scrollView 的 contentSize 也会发生变化，导致 viewDidLayoutSubviews 再次被调用。

解决方案：抑制 Auto Layout 的过度热心

既然问题根源在于 Auto Layout 的约束调整，那么解决办法就是阻止 Auto Layout 在 scrollView 滚动时调整约束。开发者有两种途径：

禁用 Auto Layout： 在 scrollView 的 viewDidLayoutSubviews 方法中，禁用 Auto Layout，例如：

- (void)viewDidLayoutSubviews {
    [super viewDidLayoutSubviews];
    self.view.translatesAutoresizingMaskIntoConstraints = YES;
}

添加优先级较低的约束： 为 scrollView 的滚动约束添加一个较低的优先级，例如：

NSLayoutConstraint *constraint = [NSLayoutConstraint constraintWithItem:scrollView attribute:NSLayoutAttributeHeight relatedBy:NSLayoutRelationEqual toItem:view attribute:NSLayoutAttributeHeight multiplier:1.0 priority:UILayoutPriorityDefaultLow];
[view addConstraint:constraint];

这样一来，当 scrollView 滚动时，Auto Layout 会优先调整其他优先级较高的约束，而不会调整滚动约束，从而避免递归调用 viewDidLayoutSubviews。

经验总结：UI 适配的要诀

本次 iPhone X 递归 BUG 事件为开发者敲响了 UI 适配的警钟。在进行 UI 适配时，开发者必须充分考虑 Auto Layout 的约束机制，避免因约束冲突导致的意外问题。同时，本文也总结了 UI 适配中的一些常见问题和最佳实践：