[Xcode/Swift] iPhone Duo対応、TabBarの設定によっては画面が死ぬ?

背景

Xcode 27以降で iPhone Duo Simulatorも使えるそうなのでアプリをビルドしたら、メイン画面が真っ白で何も操作できない不具合に遭遇。

厄介なのが、開き方によって起きたり起きなかったりする、Portrait (縦) & Folded (折りたたみ)では真っ白でも、開くと表示されたりみたいな感じ。

あくまでSimulatorなので、実機で見てみないとなんとも言えないところではあるけど、一旦Claude Codeも活用しながら原因追及を開始して、おそらく根本原因がわかった。

原因

tabBar.frame.size.height

自分の場合は、この設定が原因になってたぽい。

TL;DR

  • Duo では状態によってタブバーが画面端に縦向きで表示される
  • そのとき tabBar.frame.size.height は「下端の厚み」ではなく「縦の長さ」になり、画面の高さに近い値を返す
  • これを下端の余白として使っていたため、子画面の高さがほぼ 0 に潰れていた

要するに、iPhone前提でPortraitしか対応しないように設計しているアプリだと、Duoだと状態によってはTabが縦並びになるので、tabBar.frame.size.heightがほぼ画面まるごとの高さを持ってしまってメインコンテンツが潰れてしまうということ。

DuoのもつTab状態のケース一覧

Claudeくんにまとめてもらったもの:

portrait・fully openだったりはiPhoneと同じく下に横並びのTabBarになるけど、それ以外で右に縦並びのTabBarになる場合があるので、ここで高さが異常になるというイメージ。

問題になっていたぽい実装周り

UIKitが残るプロジェクトだったので、一部の画面では、リストの下端を view.bottom − tabBar.frame.size.height で張っていました。小さくなった view からさらに大きな値を引くので、高さがマイナスになって、しかもこの値は viewDidLoad で1回計算したきりで、折りたたむ・開くで配置が変わっても更新されないという状態になってました。

修正方法

「タブバーが下端にあるときだけ高さを考慮して、縦向きのときは無視する」が一旦最低限のDuo対応として良さそうという結論。通常の iPhone ではタブバーは常に下端にあるので、挙動は変わらないはず。

1. タブバーが下端にあるかを判定する

UIKit にはタブバーの配置を返す API がないので、実際の形から判定:

extension UITabBar {
    /// 下端に横向きで配置されているか
    var isPlacedAlongBottom: Bool {
        bounds.width >= bounds.height
    }

    /// 下端から避けるべき高さ。縦向きのときは 0
    var bottomOcclusionHeight: CGFloat {
        isPlacedAlongBottom ? frame.size.height : 0
    }
}

2. 縦向きのときだけタブバーを半透明にする

半透明なら子画面は縮められず、Duoでは配置は折りたたみや回転で変わるので、viewDidLayoutSubviews で毎回判定するように変更。値が変わるときだけ代入するのは、レイアウトのやり直しを繰り返さないため。

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    let isTranslucent = !tabBar.isPlacedAlongBottom
    if tabBar.isTranslucent != isTranslucent {
        tabBar.isTranslucent = isTranslucent
    }
}

3. 下端制約を配置に追従させる

制約の参照を持っておき、レイアウトの度に constant を更新するようにする。

override func viewWillLayoutSubviews() {
    super.viewWillLayoutSubviews()
    let constant = -(tabBarController?.tabBar.bottomOcclusionHeight ?? 0)
    if bottomConstraint?.constant != constant {
        bottomConstraint?.constant = constant
    }
}

こうすると、自分のケースだと縦Tabでもコンテンツが表示されるようになりました。

↓ イメージ

他の選択肢

方法良いところ気になるところ
今回の方法(下端のときだけ高さを使う)通常の iPhone の挙動が変わらない。差分が小さい配置の判定が形に頼っている。縦向きタブバーとの横方向の重なりは残る
traitOverrides.horizontalSizeClass = .compact でタブバーを下端に固定1行で済み、見た目も iPhone と揃う子画面すべてが compact 扱いになる。
safeAreaLayoutGuide.bottomAnchor 基準に寄せるタブバーの高さを手で計算しなくて済む根本対応下端の基準が変わるので、iPhone 側の回帰確認が必要

根本的に実装を見直すなら、”safeAreaLayoutGuide.bottomAnchor 基準に寄せる” 案が良さそうかも?

おわりに

今回の学び:

  1. frame.size.height を「下端の余白」として使わない。使うなら、その値が何を意味するか(配置)まで確かめる
  2. レイアウトに関わる値を viewDidLoad で1回だけ計算しない。折りたたみや回転で、画面の形はアプリの実行中に変わる
  3. size class からの推測ではなく、実際の画面で確かめる。今回も「closed なら compact だから大丈夫」という思い込みを一度しかけたので

折りたたみ端末への対応を始めるときは、まずタブバーの高さを手で計算している箇所を探してみてください。