完全に理解する Storyboard & UIKit (Day 24): Storyboard Referenceを用いたStoryboard分割

Day 1〜23まで、私たちは全ての画面を Main.storyboard という1つのファイル内で構築してきました（※チュートリアル等でよく見る手法です）。

しかし、実際のプロダクト開発において数十画面を全て1つのStoryboardファイルに詰め込むと、以下の致命的な問題が発生します。

1. Gitコンフリクト地獄: 複数人で同時に別々の画面を編集した場合、XMLの競合が発生し高確率で壊れます。
2. パフォーマンスの低下: Storyboardファイルを開くたびにMacが悲鳴を上げ、Xcodeの動作が激重になります。
3. 視認性の悪化: 矢印（Segue）が複雑に絡み合い、もはやスパゲッティ状態になりフローが追えなくなります。

これを解決・回避するための機能が Storyboard Reference (ストーリーボード・リファレンス) によるファイル分割設計です。

1. 巨大なStoryboardを分割するアプローチ

理想的な設計は、「1つの主要な機能（または1タブ、1画面）につき、1つのStoryboardファイルを作成する」 ことです。 例えば、「ホーム画面用（Home.storyboard）」「設定画面用（Settings.storyboard）」といった具合にファイルを分けます。

既存の画面を別のファイルとして切り出す方法

すでにMain.storyboardに入っている画面を、新しいファイルに切り出して安全にする方法があります。

1. テンバス上で、切り出したい画面のViewController（複数選択可）を選択します。
2. Xcode上部のメニューバーから Editor > Refactor to Storyboard... をクリックします。
3. 「Save As:」に新しいStoryboardファイル名（例: Settings.storyboard）を入力し、保存します。
4. なんということでしょう！元の Main.storyboard から該当画面が消え、代わりに Storyboard Reference という小さな箱（リンク要素）が現れ、矢印（Segue）はそのまま 유지 されました。

これが最も簡単で安全な分割方法です。

2. 新しいファイルからStoryboard Referenceで画面を繋ぐ

一から別々のファイルとして作られた Storyboard 同士を、Segue（矢印）で繋ぐ手順です。ここでは、「ホーム（Home.storyboard）」から「プロフ（Profile.storyboard）」へ画面遷移させたい場合を例にします。

ステップ1: 遷移先（Profile.storyboard）の準備

1. Profile.storyboard に View Controller を1つ作成します。
2. その画面の Identity Inspector (⌥⌘3) で、Storyboard ID を必ず設定します（例: ProfileMainVC）。

ステップ2: 遷移元（Home.storyboard）からのリンク

1. Home.storyboard を開きます。
2. ライブラリパネル（⇧⌘L）から Storyboard Reference という部品を探し、キャンバスにドロップします。
3. 配置した Storyboard Reference を選択し、Attributes Inspector (⌥⌘4) を開きます。
4. Storyboard 項目で、遷移先のファイルである Profile （拡張子不要）を選択します。
5. Reference ID 項目に、ステップ1で設定した ProfileMainVC を入力します。
6. あとは通常の画面遷移と同じです。ホーム画面のボタンから、この Storyboard Reference の箱に対して Control + ドラッグ で繋ぎ、「Show」などのSegueを作成します。

これだけで、異なるStoryboardファイル間での視覚的な画面遷移が完成しました！

3. コードだけで別のStoryboardの画面を呼び出す

Segueを使わずに、プログラムから動的に別のStoryboardファイルに定義された画面を呼び出したい場合（初期起動時のログイン判定後など）の実装です。

swift
// 1. "Profile"という名前のStoryboardファイルを読み込む
let profileStoryboard = UIStoryboard(name: "Profile", bundle: nil)

// 2. そのファイル内から、Storyboard ID "ProfileMainVC" を持った画面をインスタンス化する
guard let profileVC = profileStoryboard.instantiateViewController(withIdentifier: "ProfileMainVC") as? ProfileViewController else {
    return
}

// 3. NavigationControllerで遷移させる
self.navigationController?.pushViewController(profileVC, animated: true)

📝 今日のまとめ

• プロの実務開発においては、1つのStoryboardファイルに画面を詰め込むのは絶対の御法度（アンチパターン） である。
• Editor > Refactor to Storyboard を使って、巨大化したStoryboardを機能単位で複数の別ファイルに分割（切り出し）する。
• 異なるStoryboardファイルどうしは、Storyboard Reference コンポーネントを使って視覚的にSegue接続できる。
• コードから別Storyboardの画面を呼ぶときは UIStoryboard(name:) し、instantiateViewController(withIdentifier:) を用いる。

この分割手法を身につければ、大規模アプリの複数人開発でもGitのコンフリクトを恐れる必要はありません。 しかし、Storyboardを使わない「1画面＝1ファイル」のもう一つのUI構築手法が存在します。明日の Day 25 では、Storyboardの先祖にあたり、今でも特定の場面で強みを発揮する XIB (NIB) ファイルの使い分けを学びます。