iOS Auto Layout 自适应布局实践

iOS 页面需要面对不同屏幕尺寸、安全区域、横竖屏、动态文字和多语言内容。可靠的布局不应依赖某一台设备上的固定坐标，而应描述视图之间的关系，以及内容在空间不足时如何压缩、换行或隐藏。Auto Layout 的价值正是把这些规则交给约束系统求解。

一、从内容关系设计约束

一个常见信息行包含标题、说明和右侧操作。约束应表达它们的相对关系，而不是提前计算每个控件的绝对位置。

final class InfoRowView: UIView {
    private let titleLabel = UILabel()
    private let detailLabel = UILabel()
    private let actionButton = UIButton(type: .system)

    override init(frame: CGRect) {
        super.init(frame: frame)
        setupViews()
        setupConstraints()
    }

    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupViews()
        setupConstraints()
    }

    private func setupViews() {
        titleLabel.numberOfLines = 1
        detailLabel.numberOfLines = 0

        [titleLabel, detailLabel, actionButton].forEach {
            $0.translatesAutoresizingMaskIntoConstraints = false
            addSubview($0)
        }
    }
}

代码创建视图时需要关闭自动转换掩码，否则系统会同时生成隐式约束，容易与手写约束冲突。

二、建立完整尺寸链路

自适应高度视图必须从顶部到达底部形成完整约束链：

private func setupConstraints() {
    NSLayoutConstraint.activate([
        titleLabel.topAnchor.constraint(equalTo: topAnchor, constant: 12),
        titleLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 16),

        actionButton.topAnchor.constraint(equalTo: topAnchor, constant: 8),
        actionButton.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -16),
        actionButton.leadingAnchor.constraint(
            greaterThanOrEqualTo: titleLabel.trailingAnchor,
            constant: 12
        ),

        detailLabel.topAnchor.constraint(equalTo: titleLabel.bottomAnchor, constant: 6),
        detailLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 16),
        detailLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -16),
        detailLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -12)
    ])
}

标题和按钮之间使用“大于等于”约束，表示两者至少保持一定距离。当内容较长时，还要结合抗压缩优先级决定谁先缩小。

三、理解拥抱与抗压缩优先级

内容拥抱优先级决定视图是否愿意变得大于固有内容尺寸，抗压缩优先级决定是否愿意小于固有尺寸。

actionButton.setContentCompressionResistancePriority(
    .required,
    for: .horizontal
)
titleLabel.setContentCompressionResistancePriority(
    .defaultLow,
    for: .horizontal
)

这表示空间不足时优先压缩标题，按钮尽量保持完整。优先级应该反映业务重要性，不能为了消除警告就随意设为极端值。

四、支持多行文本

标签设置为多行后，还需要给出明确的可用宽度。约束系统根据宽度计算高度，列表才能得到稳定的自适应尺寸。

不要用字符串长度估算行数。中英文、数字、字体和字符宽度均不同，交给排版系统计算更准确。如果业务要求最多两行，则明确设置行数和截断方式，并验证关键信息不会被错误隐藏。

五、使用安全区域和布局边距

页面级内容应相对安全区域布局，避免被状态区域、底部手势区域或导航容器遮挡。

NSLayoutConstraint.activate([
    contentView.topAnchor.constraint(
        equalTo: view.safeAreaLayoutGuide.topAnchor
    ),
    contentView.leadingAnchor.constraint(
        equalTo: view.layoutMarginsGuide.leadingAnchor
    ),
    contentView.trailingAnchor.constraint(
        equalTo: view.layoutMarginsGuide.trailingAnchor
    ),
    contentView.bottomAnchor.constraint(
        equalTo: view.safeAreaLayoutGuide.bottomAnchor
    )
])

背景视图可以延伸到屏幕边缘，但可交互内容通常仍应位于安全区域内。

六、处理键盘遮挡

表单页面不能简单假设屏幕可用高度固定。键盘出现后，需要调整滚动区域或底部约束，并把当前输入项滚动到可见位置。

如果项目已有键盘管理组件，应优先复用，避免多个页面分别监听通知并计算坐标。手动实现时要注意键盘坐标转换、动画时长、浮动键盘和外接键盘等差异。

七、动态类型与多语言

系统文字样式可以随用户设置变化。支持动态类型时，标签要允许足够行数，容器高度不能写死，图片与文字的对齐关系也需要在大字号下验证。

多语言不仅影响文本长度，还会改变换行位置和阅读方向。布局尽量使用 leading 与 trailing，少用固定的左、右概念。图标如果带有方向含义，应根据项目国际化策略处理镜像。

八、降低约束更新成本

滚动列表中反复删除并创建整组约束，会增加布局计算和维护成本。结构不变时，可以保存需要变化的约束，只更新常量或激活状态。

private var detailTopConstraint: NSLayoutConstraint!

func setCompact(_ compact: Bool) {
    detailTopConstraint.constant = compact ? 2 : 6
    setNeedsLayout()
}

如果显隐会彻底改变结构，使用项目已有的栈视图或状态布局组件通常更清晰。

九、排查约束冲突

遇到运行时约束警告时，不应通过降低所有优先级掩盖问题。可以按以下顺序检查：

1. 找到日志中参与冲突的约束和视图。
2. 确认是否同时存在隐式约束与手写约束。
3. 检查固定宽高是否与内容最小尺寸冲突。
4. 确认显隐状态是否遗留旧约束。
5. 在最小屏幕、大字号和最长文本下复现。

十、建立适配验证矩阵

至少测试小屏、大屏、横屏、多行文本、大字号、不同语言和键盘弹出状态。对于列表，还要验证复用后约束激活状态是否残留。

使用了较新的布局 API 时，必须确认项目最低系统版本，并沿用现有兼容方案，不能因为代码更短而提高运行要求。

总结

Auto Layout 的核心是表达关系和优先级。建立完整尺寸链路，合理配置拥抱与抗压缩，使用安全区域和方向无关约束，再以动态文字、多语言和键盘场景验证，页面才能从“某台设备上正确”提升为真正可适配。