完全に理解する Storyboard & UIKit (Day 3): UIViewControllerのライフサイクル

Day 2ではStoryboard上で「見た目」を作りました。しかし、ボタンを押したときの処理や、ネットワークからデータを読み込んでラベルに表示するといった「動き」はコードで書く必要があります。

そのコードの基礎となり、1つの画面（Scene）を管理する頭脳が UIViewController です。

1. UIViewControllerの役割

UIViewController は、iOSアプリにおけるMVC（Model-View-Controller）アーキテクチャの Controller に相当します。

主な役割は以下の通りです：

1. Viewの管理: 自身の管理下にあるビュー階層（View Hierarchy）の作成と更新。
2. イベントハンドリング: ユーザーのタップ操作や、システムからの通知の処理。
3. データとViewの橋渡し: Model（データ）の変更をView（UI）に反映させる。
4. ライフサイクルの管理: 画面が表示される前後、消える前後に適切な処理を行う。

Storyboard上に配置した画面（Scene）に対し、右側の Identity Inspector で Custom Class に自分が作成したSwiftファイルのクラス名（例: HomeViewController）を指定することで、UIとコードが結びつきます。

2. 理解必須のライフサイクルメソッド

画面が作成され、表示され、隠れ、そして破棄されるまでの一連の流れを ライフサイクル と呼びます。 公式ドキュメントで定義されている重要なメソッド群を、実行される順に解説します。

① loadView()

• 役割: View Controllerの最上位の view プロパティを生成します。
• 注意: Storyboardを使用している場合はシステムが自動でXMLをパースしてViewを作成するため、このメソッドを自前でオーバーライドしてはいけません（Programmatic UIでのみ使用します）。

② viewDidLoad() (超重要⭐️)

• タイミング: loadView が終わり、Viewがメモリ上にロードされた直後に 1度だけ 呼ばれます。
• 用途:
  • 初期設定（背景色、ボタンの角丸など）。
  • ネットワークリクエストの開始。
  • NotificationCenter の監視登録。
• 注意: この時点ではまだ画面の正確なサイズ（Auto Layoutによる最終的な計算結果）は確定していません。

③ viewWillAppear(_:)

• タイミング: Viewが画面に表示される直前に呼ばれます（タブ切り替えなどで何度でも呼ばれる）。
• 用途:
  • 画面が表示されるたびに最新の状態に更新したい処理。
  • ナビゲーションバーの非表示/表示の切り替え。
  • キーボードの監視登録。

④ viewIsAppearing(_:) (iOS 13以降)

• タイミング: viewWillAppear の直後、かつビューが階層に追加されるときに呼ばれます。
• 特徴: このタイミングでは既にViewのサイズやTrait Collection（ダークモード等）が確定しています。サイズに依存したレイアウト調整に最適です。

⑤ viewDidAppear(_:)

• タイミング: Viewが完全に画面に表示された直後に呼ばれます。
• 用途:
  • アニメーションの開始。
  • APIから取得した結果に基づくアラートの表示。

⑥ viewWillDisappear(_:)

• タイミング: 表示されているViewが、他の画面への遷移などで隠れ始める直前に呼ばれます。
• 用途:
  • 編集中のデータの自動保存。
  • キーボードの強制非表示（resignFirstResponder()）。

⑦ viewDidDisappear(_:)

• タイミング: Viewが完全に画面から見えなくなった直後に呼ばれます。
• 用途:
  • バックグラウンドで動いている不要な処理の停止。
  • リソースの解放。

3. コードでの記述例

swift
import UIKit

class ExampleViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad() // 常にsuperを呼ぶ
        print("1. viewDidLoad: メモリにロードされました。初期設定を行います。")
    }

    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        print("2. viewWillAppear: まもなく画面が表示されます。")
    }

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        print("3. viewDidAppear: 完全に画面が表示されました。アニメーション開始！")
    }

    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        print("4. viewWillDisappear: 画面が隠れようとしています。")
    }

    override func viewDidDisappear(_ animated: Bool) {
        super.viewDidDisappear(animated)
        print("5. viewDidDisappear: 画面が完全に隠れました。")
    }
}

ベストプラクティス: ライフサイクルメソッドをオーバーライドする際は、必ず super.viewDidLoad() のように親クラスの実装を呼び出すクセをつけてください。これを忘れると、システム側で必要な事前準備や片付けが実行されず、予期せぬバグを引き起こす原因になります。

📝 今日のまとめ

• UIViewController は1つの画面を管理する「頭脳」。
• Storyboard上で設定した Custom Class によってUIとコードが紐づく。
• viewDidLoad は1回限りの初期化に使い、viewWillAppear は都度更新したい処理に使う。

さて、UIを配置する場所とコードの連携が分かりました。しかしデバイスにはiPhone SEからiPhone Pro Max、iPadまで様々な画面サイズがあります。 明日の Day 4 では、どんな画面サイズでもレイアウトが崩れない魔法のシステム、Auto Layout の基礎を学びます！