iPad端SplitView无法正确调整PrimaryView宽度问题求助

问题现象 #

在iOS14至16版本中，SplitView的PrimaryView水平尺寸初始化时无法正确自动调整，导致依赖它的TableView宽度错误，TableCell左侧部分超出屏幕范围：

问题根源及解决步骤 #

1. 移除重复且冲突的TableView约束 #

你使用的是UITableViewController，该类默认已将内置的tableView与控制器的view完成全屏约束绑定。但你在viewWillAppear中每次都会调用setUpTableViewContraints添加新约束，这会造成布局冲突，导致系统无法正确计算PrimaryView的宽度。

解决操作：

• 删除setUpTableViewContraints方法
• 删掉viewWillAppear中对该方法的调用

2. 移除不必要的Delegate/DataSource重复设置 #

UITableViewController默认已将自身设为tableView的delegate和dataSource，你在viewWillAppear中重复设置毫无意义，还可能干扰布局时机。直接删除这两行代码：

tableView.delegate = self
tableView.dataSource = self

3. 检查SplitViewController的布局配置 #

若上述修改后问题仍存在，检查storyboard中SplitViewController的相关属性：

• 确保Primary View Controller的Size设置为Automatic
• 可手动配置Primary列的宽度范围，在SplitViewController的初始化代码中添加：

splitViewController?.preferredPrimaryColumnWidthFraction = 0.3
splitViewController?.minimumPrimaryColumnWidth = 200
splitViewController?.maximumPrimaryColumnWidth = 320

4. 强制布局刷新（调试应急方案） #

如果存在宽度计算延迟的问题，可在viewDidAppear中强制触发布局刷新：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    tableView.layoutIfNeeded()
    splitViewController?.view.layoutIfNeeded()
}

修改后的MasterViewController代码 #

import UIKit

class MasterViewController: UITableViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
    }

    override func numberOfSections(in tableView: UITableView) -> Int {
        return 1
    }

    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return 5
    }
    
    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath)

        var content = cell.defaultContentConfiguration()
        content.text = "Cell Item \(indexPath.row)"
        cell.contentConfiguration = content
        
        cell.layer.cornerRadius = 12
        cell.clipsToBounds = true
        
        return cell
    }
}

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