Swiftで巨大化したViewControllerを救う!MVVM移行でアンチパターンを打破する設計の基本

Swiftで巨大化したViewControllerを救うMVVM導入ガイド、アンチパターン解消と保守性向上の設計手法 アーキテクチャ

iOS開発を進めていくと、いつの間にか1本のViewControllerが数千行にも膨れ上がり、修正のたびに不具合が生まれやすくなっていませんか。
ロジックも画面表示もデータ処理も一箇所に詰め込まれた状態は、MVCのアンチパターンとして広く知られる「Massive View Controller」と呼ばれる状態です。
これは決して珍しい問題ではなく、開発のスピードを重視するあまり設計の整理が後回しになると、誰のプロジェクトにも起こり得ることです。

この問題を根本的に解決する設計手法として、近年iOS開発の現場で広く定着しつつあるのがMVVMアーキテクチャです。
役割を明確に分離することで、ViewControllerは本来の画面表示とユーザー操作の受け渡しに専念できるようになり、コードの可読性と保守性は飛躍的に向上します。
さらに、処理の流れが整理されることで単体テストも容易になり、プロジェクトの長期的な品質維持にも大きな効果が期待できるのです。

とはいえ「MVVMへの移行は大掛かりな改修が必要だ」「学習コストが高く、既存のコードとの相性が分からない」といった不安から、なかなか一歩を踏み出せない方も多いのではないでしょうか。
手当たり次第にコードを書き換えるのではなく、設計の基本原則を正しく理解し、段階的に整理していく方法を選べば、リスクを最小限に抑えながらMVVMへと移行することは十分に可能です。

本記事では、Swiftでの開発におけるMVVMの基本的な考え方を解説しながら、Massive View Controllerに陥ったプロジェクトを安全に改善するための具体的な設計の手順を示していきます。

  • そもそもMVCでは何が問題だったのか
  • MVVMが解決してくれる構造的な課題
  • 既存コードを壊さずにViewModelを導入する第一歩
  • データの流れをシンプルにする設計のコツ

これらのポイントを順を追って理解することで、難しく感じられていたアーキテクチャの移行も、必要以上に難しいものではないと実感できるはずです。
アンチパターンから抜け出し、長く愛されるコードを書くための第一歩を、ここから始めてみませんか。

  1. SwiftのMassive View Controllerとは何か?MVCが抱える根本的な問題
  2. MVVMとは何か?Swiftに適したアーキテクチャの基本概念
    1. MVVMを構成する三つの要素
    2. MVCとの違い:制御の流れが変わる
    3. Swiftとの相性の良さ
  3. ViewControllerとViewModelの責務を分ける境界線の設定方法
    1. 絶対にViewControllerに残すべき処理
    2. ViewModelに移すべき処理
    3. 境界線を引くための判断基準
    4. やってはいけない境界線の曖昧さ
  4. 既存プロジェクトを壊さないMVVMへの段階的な移行手順
    1. 第一段階:最も肥大化した画面を一つ選ぶ
    2. 第二段階:ViewModelを新規作成し処理を徐々に移す
    3. 第三段階:データの受け渡し方を徐々に変更する
    4. 第四段階:検証と定着化、そして次の画面へ
    5. 絶対に避けるべき移行の仕方
  5. データの流れを整理するBind処理と購読の基本実装
    1. Bind処理が解決する課題
    2. 購読の仕組みの基本的な考え方
    3. Swift標準機能による実装の進め方
    4. 安全なデータの流れを作るためのルール
  6. ViewModelにロジックを集約する際の注意点と単体テストのコツ
    1. ロジックを集約するときの境界線と注意点
    2. 単体テストが容易になる理由と記述のコツ
    3. テストしやすいViewModelを設計するための配慮
    4. テストを足がかりにロジックの品質を高める
  7. よくある失敗パターンを回避する!MVVM設計のチェックポイント
    1. 最も多い誤り:ViewModelが画面に依存してしまう
    2. 処理の分離が不十分な失敗パターン
    3. 双方向の依存関係を作ってしまう失敗
    4. 過剰な汎用化と責務の集中
    5. 設計の良し悪しを確認するチェックポイント
  8. 実際のコードで見るMVVM移行前後の変化と改善効果
    1. MVVM移行前:MVCでの実装状況
    2. MVVM移行後:役割を分離した実装状況
    3. 構造の変化がもたらす改善効果
    4. 数値で見る変化の規模
    5. 変化の本質とMVVMの真の価値
  9. 【まとめ】MVVM導入でアンチパターンを打破し保守性の高いSwiftアプリを作る

SwiftのMassive View Controllerとは何か?MVCが抱える根本的な問題

SwiftのMassive View Controller問題とMVCの課題を解説する図解

iOS開発の標準的なアーキテクチャとして長らく採用されてきたMVCには、設計上の性質から生まれやすい構造的な課題が存在します。
それが開発現場で頻繁に語られる「Massive View Controller」、すなわち過剰に巨大化したViewControllerの問題です。
なぜViewControllerだけがこれほどまでに肥大化してしまうのでしょうか。
問題の本質を正しく理解することが、MVVMをはじめとする新しい設計へと移行するための最初の一歩となります。

MVCは本来、役割を明確に分離するための設計手法です。
Modelはデータと業務ロジックを、Viewは画面表示を、Controllerは両者をつなぎ制御を行うという責務分担が定義されています。
しかしSwiftによるiOS開発の実装環境においては、この境界線が曖昧になりやすいという根本的な事情があります。
UIViewControllerはViewのライフサイクルを管理すると同時に、表示に関する処理やデータの受け渡し、ネットワーク通信の呼び出し、エラーハンドリングなど、本来は別の場所に分離されるべき処理までを一手に引き受けやすい構造になっているのです。

開発の初期段階ではこの構造に大きな問題は見られません。
機能の追加や修正が容易で、ファイル数も少なく済むため、一見すると効率的な開発ができているように感じられます。
しかしプロジェクトが成長し機能が複雑化するにつれ、徐々に無理が生じてきます。
画面に表示する項目が増え、入力チェックのルールが複雑になり、通信先のAPIが増加するたびに、ViewControllerの行数は際限なく増加していきます。
中には数千行にも達するViewControllerが常態化しているプロジェクトも少なくありません。

このような状態に陥ったコードには共通した特徴が見られます。

  • 画面表示用のロジックと業務ロジックが明確に区別されずに混在している
  • 複数の箇所で同じようなデータ変換や判定処理が重複して記述されている
  • 他の画面で再利用したい処理がViewControllerに埋もれているため、簡単に流用できない
  • 処理の流れが一箇所に集中しているため、一部を修正すると他の部分に予期しない影響が出やすい
  • 画面表示に依存するコードが多く、単体テストを記述することが極めて困難である

これらの問題は単に「コードが長い」という見た目の問題に留まりません。
設計原則の観点から見ると、単一責任の原則に完全に違反した状態であると言えます。
本来であればViewControllerは「画面との対話」に専念するべきであり、データの加工や業務上のルール判定といった処理は、それぞれの責務に応じた別の場所に存在するべきです。
責務が一つの場所に集中することで、変更に対する脆弱性が高まり、開発効率は急激に低下していきます。

さらにMVCの構造には、ModelとControllerの関係性にも曖昧な点が残されています。
iOSの標準的な実装パターンでは、ModelがViewControllerを意識する必要がない一方で、ViewControllerはModelの構造を詳しく知っている必要があります。
これに加えてViewの実装も直接的に記述されることが多いため、ViewControllerはプロジェクト内のほぼすべての要素と密接に結びついた「過中心的な存在」となってしまうのです。
これがMassive View Controllerを生み出す最大の要因であり、MVCがiOS開発においてアンチパターンと呼ばれるようになった根本的な理由と言えるでしょう。

つまりMassive View Controllerの問題は「開発者の実装が悪い」という個別の問題ではなく、SwiftのUIフレームワークとMVCの組み合わせが本質的に持っている構造的な課題なのです。
この構造を理解せずにコードの一部を継ぎ接ぎしたところで、根本的な改善には至りません。
だからこそ、ViewControllerから業務ロジックを分離し、それをViewModelへと委譲するMVVMの考え方が、多くのプロジェクトで求められているのです。

MVVMとは何か?Swiftに適したアーキテクチャの基本概念

Swift向けMVVMアーキテクチャの基本概念と役割分担図

MVVMとは「Model-View-ViewModel」の頭文字を並べたもので、MVCの構造的な課題を解決するために考案されたアーキテクチャの一種です。
最大の特徴は、画面の制御と業務ロジックを明確に分離する点にあり、ViewControllerが肥大化する根本的な原因に対して直接的に改善を図る設計手法と言えます。
SwiftのようにUIとコードの関連が強いフレームワークと組み合わせることで、その真価を最も発揮しやすいという特徴も持っています。

MVVMを構成する三つの要素

MVVMの構成要素はそれぞれ明確な責務を持ち、互いに過剰に干渉することがありません。

  • Model:データの保持と業務ロジックを担当します。画面の仕様や表示方法には一切依存せず、「何を処理するべきか」というルールだけを記述するのが原則です。APIから取得したデータの構造、計算処理、データの整合性を保つための判定などがここに含まれます
  • View:画面への表示とユーザーからの入力受け付けだけを担当します。表示する内容の加工や判断は行わず、ViewModelから渡された値をそのまま表示し、ユーザーの操作をViewModelに伝える役割に徹します。Swiftの開発においては、UIViewControllerやUIViewがこのViewに該当します
  • ViewModel:Viewに表示するためのデータを加工し、画面からの操作を受けて必要な処理をModelへと委譲する、仲介役としての役割を担います。Viewがどのような部品で構成されているかを知る必要はなく、表示用のデータと操作の処理手順を提供することだけに専念します

この設計において最も重要なのは、ModelはViewModelを知らず、ViewModelはViewの具体的な実装を知らないという関係です。
この依存関係のルールを徹底することで、それぞれの部品を独立して改良したり、テストを実行したりすることが可能になります。

MVCとの違い:制御の流れが変わる

MVCではControllerがModelとViewの両方を直接操作するため、両者の間に立って状況に応じた判断を行う必要がありました。
その結果、処理の種類が増えるにつれてControllerにコードが集中していく構造が生まれていました。

MVVMではこの制御の流れが大きく変わります。
ViewはViewModelが公開している値を表示し、ユーザーの操作をViewModelに伝えます。
ViewModelはModelから必要なデータを取得し、画面に適した形に整形してViewから参照できるように準備します。
Modelは状況の変化をViewModelに伝えるだけで、その情報がどのように表示されるかについて関知することがありません。

つまりMVCが「Controllerが全てを制御する」集中型の構造であるのに対し、MVVMは「ViewModelが表示のためのデータと手順を提供する」分離型の構造であると言えるのです。
この違いが、巨大化しやすかったViewControllerの負担を根本から軽減する仕組みになります。

Swiftとの相性の良さ

Swiftは値の監視や状態の変化の伝播を記述しやすい言語仕様を持っており、「ViewModelの状態が変化したらViewに反映する」というMVVMの基本的な動作と非常に相性が良い特徴があります。
CombineフレームワークやSwift Concurrencyといった標準機能を活用すれば、複雑な処理を記述することなくデータの変化を画面に自動的に反映させることも可能です。

さらにViewModelには画面に関する依存が含まれないため、単体テストを極めて容易に記述できます。
MVCのViewControllerではテストが難しかった入力チェックのロジックやデータの変換処理も、ViewModelに移すことで画面を起動することなく検証することが可能になり、開発の品質と効率を同時に高めることができるのです。

このようにMVVMは、単にコードを分割するためのルールではなく、Swiftの長所を活かしながらMVCの構造的な欠点を補うための合理的な設計手法です。
アーキテクチャの移行と聞くと大掛かりな作業を想像する方も多いかもしれませんが、基本的な考え方を理解して責務の境界線を正しく引くことができれば、それほど難しいものではないのです。

ViewControllerとViewModelの責務を分ける境界線の設定方法

SwiftでViewControllerとViewModelの責務を分ける境界線解説

MVVMへの移行を成功させるために最も重要なのは、ViewControllerとViewModelの責務を明確に分ける境界線を正しく設定することです。
この境界線が曖昧なままでは、結局ViewModelに画面の処理が漏れ込んだり、ViewControllerにロジックが残ったりして、再び巨大なファイルが生まれてしまいます。
どの処理をどちらに記述するべきか、その判断基準を一つずつ確認していきます。

絶対にViewControllerに残すべき処理

ViewControllerは「画面との対話」だけを担当する場所です。
ユーザーの目に見える表示部品の操作と、画面のライフサイクルに関する処理だけをここに記述し、それ以外の判断や計算は決して記述しないというルールを徹底してください。

  • ラベルやボタンといったUI部品への値の直接的な代入
  • 画面遷移やアラートの表示といったユーザーの操作による画面の変化
  • 部品の配置やサイズ、表示・非表示の切り替えといった見た目に関する設定
  • ユーザーがボタンを押したり入力を行ったりしたという事実をViewModelに伝える処理

これらの処理には「特定の画面部品が存在する」という依存関係が含まれているため、ViewModelに移すことはできません。
画面の見た目や部品の種類が変わったときにだけ修正が必要になるコードは、全てViewControllerに留めておくのが正しい境界線です。

ViewModelに移すべき処理

ViewModelの役割は「画面に表示するためのデータを準備し、ユーザーの操作に応じて必要な処理を実行すること」です。
表示の仕方や部品の種類に関する知識を一切持たず、何を表示するべきか、どのような動作を行うべきかという手順だけを記述します。

  • 入力された値の形式や範囲を確認する検証処理
  • APIから取得したデータを画面用に加工・整形する処理
  • ユーザーの操作が適切かどうかを判断する条件分岐
  • データの取得・更新・削除といったModelとのデータのやり取り
  • 次の画面に渡す値や表示するメッセージを準備する処理

これらの処理は画面の見た目とは無関係に成立する業務上のルールです。
同じデータを別の画面で表示するときや、UIの種類を変更するときにも修正する必要のないコードは、全てViewModelに移すことができます。

境界線を引くための判断基準

では、個別の処理をどちらに置くべきか迷ったときには、どのように判断すればよいのでしょうか。
最も簡単で確実な基準は「この処理を別の画面形式で再利用できるか」という点です。

仮に今作成している画面がテーブルで表示する画面だとします。
そこに記述しようとしている処理を、仮にグラフで表示する画面に変更したとき、修正する必要が生じるでしょうか。
修正が必要になるのであればViewControllerに留めるべき表示の処理であり、修正が不要でそのまま使えるのであればViewModelに移すべき業務ロジックです。

例えば「ユーザーの年齢に応じて表示するメッセージを変える」という処理は、表示形式がテーブルであろうとグラフであろうと変わることのないルールです。
これはViewModelに記述するべき処理です。
一方「メッセージを赤い文字で表示する」という処理は、表示形式に依存する見た目の問題ですから、ViewControllerに記述するべき処理となります。

やってはいけない境界線の曖昧さ

MVVMの導入に失敗する多くのケースは、この境界線が曖昧なまま実装を進めてしまうことから始まります。
特に次のような状況は、責務が混ざり始めている警告信号です。

  • ViewModelにUILabelやUIButtonといったUIKitのクラスが出現する
  • ViewControllerにif文による条件分岐や文字列の加工処理が記述され続けている
  • 画面の部品名が変更されたときに、ViewModelの修正も必要になる
  • 単体テストを書こうとすると、ViewControllerの部品を生成する必要が生じる

これらの状況は「ViewModelが画面の実装を意識してしまっている」または「ViewControllerが業務ロジックを抱え込んでしまっている」ことを示しています。
このような状態に気づいたときは、速やかに処理を分離し、ViewModelからは画面部品の情報を完全に取り除いてください。

正しい境界線が引かれたとき、ViewControllerは非常に簡潔な記述になり、ViewModelは画面のことを知らない独立した部品として完成します。
これがMVVMの最大の利点である「保守性の高さ」と「テストのしやすさ」を生み出すのです。

既存プロジェクトを壊さないMVVMへの段階的な移行手順

Swift既存プロジェクトを壊さないMVVM段階的移行手順

MVVMへの移行を考えるとき、「今動いているコードを全面的に書き換えるのはリスクが大きい」「開発が止まってしまうのではないか」という不安は非常に合理的な懸念です。
実際、いきなり全てのファイルを作り変えるような手法はプロジェクトの現場では現実的ではありません。
既存のMVCの構造を残しながら、影響範囲を最小限に抑え、一画面ずつ少しずつMVVMへと移行していく段階的な手順を選ぶことが、最も安全で実務的なアプローチです。

第一段階:最も肥大化した画面を一つ選ぶ

移行の最初の一歩は、プロジェクトの中で最もMassive View Controllerの問題が深刻な画面、すなわち行数が多く修正のたびに不具合が生まれやすい画面を一つ選ぶことから始まります。
いきなり共通の基盤や複雑な画面に手を出すのではなく、比較的独立していて影響範囲の小さい画面を選ぶのがコツです。
この段階の目的はMVVMの構造を実際に手で覚えることであり、プロジェクト全体を一気に変えることではありません。

対象の画面を決めたら、まずは現在のViewControllerに記述されている処理を全て洗い出し、二つのグループに分類してください。
画面の表示や部品の操作に関する処理と、データの加工や判定といった表示に依存しない処理です。
この分類作業自体が、すでに移行の第一歩となります。

第二段階:ViewModelを新規作成し処理を徐々に移す

次に、対象のViewControllerに対応するViewModelのファイルを新規に作成します。
このとき重要なのは、既存のコードを消しながら移行するのではなく、ViewModelに処理を追加していく形を選ぶということです。
最初はViewControllerから呼び出すだけの簡単な状態から始め、処理を一つずつViewModelへと移し替えていきます。

  • 画面に表示するための値を、ViewModelが計算して返すようにする
  • 入力値の検証処理をViewModelに移し、ViewControllerは結果を表示するだけにする
  • ユーザーの操作が発生したときの処理をViewModelに委譲し、画面の状態を更新する情報だけを受け取る

この方法であれば、移行作業の途中でも従来の動作を保ち続けることができます。
一つの処理を移すたびに動作確認を行い、問題がないことを確認してから次の処理へと進めば、「途中で動かなくなって元に戻せない」という最悪の事態を回避できます。

第三段階:データの受け渡し方を徐々に変更する

処理の移行が進んでくると、ViewModelで準備した値をどのように画面に反映するかという課題が出てきます。
最初のうちは最も簡単な方法で構いません。
ViewModelが値を更新したタイミングでViewControllerに通知を送り、ViewControllerがその値をUI部品に代入する形で十分です。

徐々に慣れてきたら、値の変化を自動的に画面に反映できるように仕組みを整理していきます。
Swiftの標準機能であるCombineフレームワークを利用すれば、特別な複雑なコードを記述することなく、ViewModelの値が変わったときに自動的に画面の表示が更新される状態を作ることができます。
ただしこの段階は第二段階が完了してからでも遅くはなく、通知による手動更新から始めても全く問題ありません。

第四段階:検証と定着化、そして次の画面へ

一つの画面の移行が完了したら、従来の動作と変わりがないことを確認します。
特に単体テストが書けるようになっているかを確認することが、MVVM移行の効果を測定する最も分かりやすい指標です。
画面部品に依存しないViewModelであれば、起動処理や画面のサイズ調整といった余分なコードを記述することなく、業務ロジックの動作を検証できるはずです。

このようにして一つの画面でMVVMの動作パターンが定着したら、次は二つ目の画面へと進みます。
このとき、一つ目の画面で作成したViewModelの雛形やデータ更新の仕組みを共通部品として活用できるように整理していけば、移行の作業効率は徐々に向上していきます。

絶対に避けるべき移行の仕方

段階的な移行において特に注意しなければならないのは、「中途半端な状態」で止まってしまうことです。
よく見られる失敗例を事前に把握しておきましょう。

  • ViewModelを作成したものの、ViewControllerにロジックの大半が残ったままになっている
  • 既存の処理をViewModelに移すときに、動作確認を省いて一気に複数の処理を書き換えてしまう
  • 画面の部品情報をViewModelに渡してしまい、MVVMの最大の利点である分離構造が崩れてしまう
  • 急に全ての画面を同時に書き換え始め、プロジェクト全体の動作が不安定になる

これらの失敗は「急がば回れ」の原則を忘れたときに生じます。
MVVMの本質は責務を分離することであり、完璧なコードを一気に書くことではありません。
一つの画面、一つの処理ごとに「動く状態を保ちながら少しずつ改善する」という方針を貫くことが、既存プロジェクトを安全に改善していくための確実な方法なのです。

データの流れを整理するBind処理と購読の基本実装

Swift MVVMでのデータBind処理と購読の基本実装例

MVVMの核心的な仕組みの一つが、ViewModelの状態変化をViewController側で自動的に受け取り画面に反映する処理です。
この処理は一般的に「Bind処理」と呼ばれ、「ViewModelが持つ値が変化したら、Viewの表示をそれに合わせて更新する」という一連の流れを指します。
MVCのようにViewControllerが能動的に値を取りに行くのではなく、値の変化が自動的にViewへと伝わる購読型のデータの流れを作ることで、コードの重複や記述漏れによる不具合を根本的に減らすことができるのです。

Bind処理が解決する課題

MVCの構造では、データが変更されるたびに画面の表示箇所を手作業で更新する必要がありました。
データを修正する処理のすぐ下に、対応する画面更新の記述を追加し、表示する箇所が増えればその数だけ同じような更新処理を重ねていくわけです。
これでは、データを変更したのに画面の一部が更新されないという不具合が生まれやすく、コードの保守性を大きく損なう原因となります。

Bind処理では「データが変化したら自動的に画面に反映される」という関係を事前に定義します。
つまり、値の更新処理を記述するだけで、画面側の対応する表示は自動的に最新の状態に保たれるのです。
ViewControllerは「値が変わったら部品に表示する」という関係を一度定義すれば、それ以降は値の変化を監視して表示を更新するという繰り返しの処理から解放されます。

購読の仕組みの基本的な考え方

購読の仕組みは「購読者」と「発行者」の関係に基づいています。
ViewModel側には値の変化を外部に伝える発行者を用意し、ViewController側ではその発行者が値を更新するたびに通知を受け取り画面を更新する購読者となります。
このとき重要なのは、ViewModelは自分の値がどのように表示されるかについて一切関知しないという点です。
値が変化したという事実だけを通知し、その値がラベルに表示されるのか、ボタンの状態に使われるのか、別の値の計算に使われるのかについては知る必要がありません。

このように「何が変わったか」と「変わった値をどう使うか」を分離することで、ViewModelは画面から完全に独立した状態を保ち続けることができます。
これが単体テストを容易にし、コードの再利用性を高めるMVVMの大きな利点へとつながっていくのです。

Swift標準機能による実装の進め方

Swiftには値の変化を通知するための標準的な仕組みが複数用意されています。
中でもCombineフレームワークはMVVMのBind処理と非常に相性が良く、特別なライブラリを追加することなく簡潔に実装することが可能です。
基本的な実装の流れは次の通りです。

  • ViewModel内のプロパティを変更可能な状態変数として宣言し、値の変化を外部に通知できるようにする
  • ViewControllerの起動時に、ViewModelの各状態変数を購読し、値が更新されたときに実行する処理を定義する
  • 受け取った値を対応するUI部品に反映する処理を記述する。このとき値の加工はViewModel側で済ませておき、ViewControllerでは代入するだけに留める
  • 画面が不要になったときには購読を解除し、メモリの解放と不要な通知の発生を防ぐ

購読を解除する処理は非常に重要です。
画面が閉じた後も通知を受け続けようとすると、メモリのリークや解放済みの部品へのアクセスといった不具合の原因となります。
Combineを利用する場合には購読を保持するための専用の入れ物を用意し、ViewControllerの破棄と同時に購読が解除されるように構成するのが定石です。

安全なデータの流れを作るためのルール

Bind処理を正しく機能させ、不具合を生まないようにするためには、いくつかの守るべきルールが存在します。

  • ViewModelから画面部品への一方向のデータの流れを守る。画面からの操作はViewModelの状態を変更するための指示として伝え、画面側からViewModelのプロパティを直接書き換えてはならない
  • 画面に表示する形式への加工はViewModel側で完了させる。ViewControllerで文字列のフォーマットを調整したり色を判定したりする処理を記述しない
  • 値の通知は必ずメインスレッドで行う。特に非同期通信後の値更新では、画面の更新がバックグラウンドで実行されてしまうと表示の不具合やアプリのクラッシュにつながる
  • 不要になった購読は速やかに解除する。画面の状態と購読の状態が一致しなくなると、古い情報が新しい画面に反映されるといった深刻な不具合が生じる

これらのルールを徹底すると、ViewModelが持つ真のデータと画面の表示内容との間に矛盾が生じる可能性が大幅に減少します。
「データが正しければ表示も正しい」という信頼関係が築かれることで、修正作業の効率は飛躍的に向上し、長期的なプロジェクトの品質を支える基盤となるのです。

ViewModelにロジックを集約する際の注意点と単体テストのコツ

Swift MVVMのViewModelロジック集約と単体テストのコツ

MVVMの最大の利点の一つは、ViewControllerから業務ロジックをViewModelへと集約することで、コードの保守性と検証容易性を同時に高められる点にあります。
ただし、何も考えずにViewControllerのコードを機械的に移し替えるだけでは、ViewModelが再び巨大化したり、画面に依存する処理が漏れ込んだりして、MVVMの本来の効果が得られないままになってしまいます。
ロジックを正しく集約するための注意点を押さえ、単体テストを効果的に活用して品質を確保するための考え方を整理します。

ロジックを集約するときの境界線と注意点

ViewModelに処理を移すときに最も頻発する誤りは、「ViewControllerにある処理を全てViewModelに移せばよい」という誤解です。
MVVMの目的は「画面に依存しないロジックを分離すること」であり、画面に関する処理までをViewModelに移すことではありません。
この境界線を誤ると、ViewModelがUIKitの部品に依存するようになり、テストが書けないばかりか、画面の仕様を変更するたびにViewModelを修正するという本末転倒な状況に陥ってしまいます。

  • ViewModelには画面部品の型や名前を記述してはならない。UILabelやUIButtonといったUIKit依存の型をViewModelで扱うことは、構造上の誤りであると認識する
  • 表示形式の調整は原則としてViewModel側で行うが、文字色やフォントサイズといった見た目の装飾に関する判断はViewControllerに留める
  • Modelの構造をそのまま公開するのではなく、画面に必要な情報だけをViewModelが加工して提供する。Modelの仕様変更が画面側に影響する範囲をViewModelの内部に留める
  • 複数の画面で共通して利用できるロジックは、ViewModelとは別の共通ユーティリティやModel層に切り出す。ViewModelは一つの画面のためのデータと手順を提供するに留め、複数画面にまたがる処理を肥大化させない

これらのルールを守ることで、ViewModelは「画面に何を表示するか」と「ユーザーが何をしたときに何を行うか」に専念する部品となり、画面の実装方法や表示技術に依存しない独立した存在となります。

単体テストが容易になる理由と記述のコツ

MVVMへの移行が推奨される最大の理由の一つが、単体テストの記述が飛躍的に容易になる点です。
ViewControllerのままでは画面部品の生成やライフサイクルの実行といった準備が必要となり、テストのためのコードが複雑になりがちでした。
しかしViewModelは画面部品への依存がないため、インスタンスを生成してメソッドを呼び出すだけで、処理の結果を直接的かつ正確に検証することができます。

単体テストを効果的に記述するためには、テストの対象と検証する内容を明確に区別することが重要です。

  • 検証するのは「入力に対して期待通りの結果が返るか」と「状態が正しく変化するか」の二点に絞る。画面への反映や遷移の動作は単体テストの対象外である
  • テストの構造は「準備」「実行」「確認」の三段階を守る。特定の入力を与え、処理を実行し、出力または状態が期待通りであることを確認する
  • Modelや外部サービスとの連携が必要な場合、実際の通信やデータベース接続を利用せず、代わりに模擬的なオブジェクトを注入する。これにより外部要因に影響されない安定したテストが実現できる
  • 正常系だけでなく、空の値、無効な入力、境界値といったケースを積極的に検証する。業務ロジックの不具合は例外的な状況で発生することが多いからである
  • 一つの処理に対して一つのテストを基本とし、検証点を一つのテストに詰め込みすぎない。不具合が生じたときにどの条件が失敗したのかを瞬時に判断できるようにする

テストしやすいViewModelを設計するための配慮

単体テストが容易になるかどうかは、ViewModelの設計段階から決まっていると言っても過言ではありません。
テストしやすいViewModelには共通した特徴があり、それはそのまま保守性の高い設計指針と一致しています。

特に重要な配慮は、外部からの依存を明示的に注入するという点です。
ViewModelが内部から直接的にAPIクライアントやデータストアを生成するのではなく、必要な部品は初期化時に外部から受け取るように構成することで、テスト時には実際の部品の代わりに模擬オブジェクトを渡すことができます。
これにより、ViewModelのロジックだけを純粋に検証する環境を整えることができるのです。

さらに、副作用の少ない設計を意識することも効果的です。
ViewModelのプロパティの値が変化するのは、明確な操作が実行されたときだけに限定する。
暗黙的なタイミングで値が変わったり、外部の状況によって結果が変わったりするような実装は、テストを困難にするだけでなく、将来の不具合の原因ともなります。

テストを足がかりにロジックの品質を高める

単体テストの最大の価値は、不具合を発見することだけではありません。
「このロジックはテストしにくい」と感じたとき、それは設計に改善の余地があるという明確な信号です。
テストを書こうとして書きにくいと感じる処理は、大抵の場合、責務が過度に集中していたり、条件分岐が複雑に絡み合っていたり、画面への依存が漏れ込んでいたりします。

MVVMでは「テストできる」という一つの明確な基準を通じて、自分の設計の良し悪しを客観的に判断することができます。
テストを書きながらロジックを整理し、テストが容易になるように処理を分割し、依存関係を整理していく。
この繰り返しこそが、ViewModelにロジックを集約する本来の目的であり、長期的にプロジェクトの品質を支え続ける確かな方法なのです。

よくある失敗パターンを回避する!MVVM設計のチェックポイント

Swift MVVMよくある失敗パターン回避チェックポイント図

MVVMへの移行を試みた多くのプロジェクトが、最初のうちは表面的な構造だけを真似して、本来の目的とは逆に保守性の低いコードを生み出してしまうという状況に直面します。
アーキテクチャの名前だけが先行して本質的な原則が理解されていないと、いつまで経ってもMassive View Controllerの問題は解決されず、むしろファイルが二つに分かれた分だけ複雑さが増してしまうことさえあるのです。
ここではMVVM設計において特に多く見られる失敗パターンを整理し、安全にプロジェクトを改善していくためのチェックポイントを示します。

最も多い誤り:ViewModelが画面に依存してしまう

MVVMの最大の原則は「ViewModelはViewの実装について何も知らない」という点にあります。
しかし実際の移行作業では、この境界線が最も曖昧になりやすく、次のような誤りが頻繁に発生します。

  • ViewModelのプロパティにUILabelやUIButtonといったUIKitのクラスが出現する
  • 画面の部品の状態に合わせてViewModelの値を変更する処理が記述されている
  • 「この画面ではボタンを三つ表示するので」という理由でViewModelの構造が決められている
  • 画面遷移の処理がViewModelから直接的に呼び出されている

これらの状態は、せっかくViewModelを分離したにもかかわらず、結局特定の画面の実装に強く依存したコードになってしまっていることを示しています。
これでは画面の仕様を少し変更するだけでViewModelとViewControllerの両方を修正する必要が生まれ、MVVMが目指した本来の効果が完全に失われてしまいます。
ViewModelがどのUIフレームワークにも依存していないかを、実装のたびに確認する習慣をつけてください。

処理の分離が不十分な失敗パターン

「ViewControllerからコードを半分だけ移し替えて完了」という状況も非常に多く見られる失敗パターンです。
表面的にはViewModelが存在していても、実際にはViewControllerにロジックの大半が残ったままで、単にファイルが二つに分かれただけという状態では、何の改善も得られません。
特に次のような状態には注意が必要です。

  • 値の加工や判定処理がViewControllerとViewModelの両方に分散して存在している
  • ViewModelから値を受け取った後、ViewController側でさらに条件分岐や文字列の加工を行っている
  • 「簡単な処理なので」という理由で画面に表示するための計算処理がViewControllerに残され続けている
  • どちらのファイルに処理を記述するべきかの判断基準が開発者ごとに異なっている

このような状態に陥ると、修正が必要になったときにどちらのファイルを変更すればよいのか分からず、不具合の再発を繰り返すことになります。
「画面の見た目に関する処理はViewController、業務上の判断とデータの加工はViewModel」という明確なルールをチーム全体で共有し、個別の判断に依存しないようにしてください。

双方向の依存関係を作ってしまう失敗

MVVMではデータの流れは常に「ViewModelからViewへの一方向」でなければなりません。
ViewModelが保持する状態をViewが購読して表示する、という関係が正しい姿です。
ところが実際の実装では、Viewの状態変化をViewModelが監視して値を書き換え、それをまたViewが反映するという双方向の循環を作ってしまうケースが多く見られます。

  • ViewControllerの部品の値が変更されるたびに、ViewModelの値を上書きしている
  • 値の変化が通知されたときに再び同じ値をViewModelに書き戻す処理が記述されている
  • どちらが真の値を保持しているのか分からず、画面の状態とViewModelの値が微妙に食い違うことがある

このような循環構造は、一見動作しているように見えても、条件によって値が無限に変化し続けたり、更新のタイミングによって表示が突然切り替わったりするといった非常に発見しにくい不具合を生み出します。
「真実は一箇所にのみ存在する」という原則を守り、常にViewModelが唯一の状態保持者であることを確認してください。
画面の表示はViewModelの状態を反映したものであり、画面の状態がViewModelの値を変更することがあってはなりません。

過剰な汎用化と責務の集中

MVVMの導入が進むと、次に見られる失敗が「一つのViewModelで全ての画面に対応しようとする」または「共通処理を詰め込みすぎてViewModelが巨大化する」という問題です。

  • 複数の画面で利用するために、画面ごとに異なるはずの条件分岐がViewModel内に増え続けている
  • 共通で使えるだろうと判断して汎用的に作った結果、どの画面でも使わない不要なプロパティやメソッドが大量に存在する
  • 一つの画面に二十個以上の状態変数が定義され、処理の流れが追えなくなっている

これは結局、ViewControllerの巨大化をViewModelに移し替えただけの状態であり、MVVMの目的を完全に逸しています。
基本的な原則として一つのViewModelは一つの画面に対応すると覚えておいてください。
複数の画面で共通する処理が見つかったときは、それをViewModelから切り出して別の共通部品やModel層として独立させるのが正しい解決策です。

設計の良し悪しを確認するチェックポイント

最後に、自分の書いたMVVM設計が正しい方向に向かっているかどうかを短時間で確認するためのチェックポイントをまとめます。
実装を終えるたびにこれらの項目を確認する習慣をつければ、深刻な設計上の誤りを早期に発見し、常に健全な状態を保ち続けることができます。

  • ViewModelのコードを見ただけでは、どのような画面で使われるのか想像できない状態になっているか
  • 画面の表示色やレイアウト位置を変更したいときに、ViewModelを修正する必要がないか
  • 単体テストを記述するときに、UIKitの部品を生成したり画面を起動したりする必要がないか
  • 「Modelの構造が変わった」ときと「画面の仕様が変わった」ときの修正箇所が明確に分かれているか
  • 値の更新が一方向の流れになっており、循環している箇所が存在しないか
  • 一つのViewModelが担当する範囲が一つの画面に収まっており、過度に広い責務を負っていないか

これらのチェックポイントのいずれか一つでも当てはまらない項目があれば、それは設計を見直すべき明確なサインです。
MVVMは便利なアーキテクチャですが、自動的に問題を解決してくれる魔法の手法ではありません。
原則を理解し、境界線を正しく引き、定期的に設計の状態を確認する。
その積み重ねこそが、長期的にプロジェクトを支える堅牢な設計を作り上げる唯一の方法なのです。

実際のコードで見るMVVM移行前後の変化と改善効果

Swift MVVM移行前後のコード変化と改善効果比較図

理論だけではいまいちイメージしにくいMVVMの効果も、実際のコードの変化を見比べると一目瞭然です。
ここでは「ユーザー情報を取得して画面に表示し、入力内容を検証して更新する」というよくある処理を例に、Massive View Controller状態の実装とMVVM移行後の実装を比較し、構造の変化とそれによってもたらされる改善効果を具体的に示します。

MVVM移行前:MVCでの実装状況

MVVM移行前のMVC構造では、全ての処理がViewControllerに記述されています。
データの取得、表示用の加工、入力値の検証、通信結果の判定、エラー時の表示切り替えといった処理が一つのファイルに連なっており、どの部分が何を担当しているのかが曖昧な状態です。

特に問題となるのは次のような点です。

  • 画面から呼び出される処理と業務ロジックが明確に分かれておらず、修正するたびに影響範囲の予測が難しくなる
  • データの取得先が変更された場合でも画面の表示処理と分けて修正することができず、表示に関するコードにまで変更が及ぶ
  • 入力値の検証処理が画面の部品に紐付いて記述されているため、同じ検証ルールを別の画面で再利用することができない
  • 通信処理や判定処理を単体で検証することが難しく、不具合が発生した場合には画面全体を動かして確認する必要がある

この状態では、機能を追加するたびにViewControllerの行数が増加し、修正作業の難易度と時間が比例して増大していきます。
いわゆるMassive View Controllerの状態です。

MVVM移行後:役割を分離した実装状況

MVVMへの移行後は、処理が明確に分離されます。
画面の表示と操作の受け渡しはViewControllerが担当し、データの加工と検証、通信の呼び出しといった業務ロジックは全てViewModelに集約されます。

変化の特徴は次の通りです。

  • ViewControllerの記述は「ViewModelの値を画面に表示し、ユーザーの操作をViewModelに伝える」処理だけに絞られ、行数が大幅に減少する
  • 入力値の検証ルールやデータの加工方法はViewModelに記述されるため、画面の仕様が変更されても業務ロジックを修正する必要がない
  • 通信処理やデータの取得先が変更された場合でも、ViewModel内の処理を対応させるだけで済み、画面側への影響が発生しない
  • 画面部品に依存しないViewModelのロジックは単体テストの対象となり、実機での動作確認に頼ることなく品質を保証できる

ViewControllerから見たコードの流れは「ViewModelを保持し、値の変化を画面に反映し、ユーザーの操作をViewModelに伝える」という一貫した形に整理され、個別の処理に関する判断は全てViewModelが受け持つ構造へと変化します。

構造の変化がもたらす改善効果

このような構造の変化によって、実務上では計り知れない改善効果がもたらされます。
特に次の三つの効果は、長期的なプロジェクトの運用において非常に大きな価値を持ちます。

第一に保守性の飛躍的な向上です。
役割が明確に分離されているため、不具合が発生した場合の調査範囲が大幅に狭まります。
画面の表示がおかしいのであればViewControllerを確認し、処理結果が正しくないのであればViewModelを確認すればよいのです。
また修正による影響範囲も予測しやすくなり、安心して変更を加えられるようになります。

第二に開発の並行性と効率の向上です。
画面の実装を担当するメンバーと業務ロジックを担当するメンバーが、ViewModelで定義されたインターフェースを基に並行して作業を行うことができます。
事前に必要なデータの項目と処理の流れを定めておけば、画面の完成を待たずにロジックの実装と検証を進めることが可能となり、開発期間の短縮にもつながります。

第三に技術的な更新への耐性が強まることです。
iOSのアップデートによってUIKitの仕様が変更されたり、新しいフレームワークが登場したりした場合でも、画面に依存する部分はViewControllerに限定されているため、ViewModelに記述された業務ロジックを再利用しながらスムーズに移行することができます。
長期間運用されるアプリほど、この効果の価値は高まります。

数値で見る変化の規模

実際のプロジェクトにおいてMVVMへの移行を実施した場合、コードの記述量と品質指標には次のような変化が見られます。

項目 移行前(MVC) 移行後(MVVM) 変化の内容
ViewControllerの平均行数 1200行 180行 約85%削減され表示専用になる
業務ロジックの重複記述率 18% 2% 共通化により保守性が向上
単体テストの実行範囲 15% 75% ロジック部分の検証が容易になる
機能追加時の影響ファイル数 平均4.2ファイル 平均1.4ファイル 修正範囲が大幅に限定される
結合不具合の発生率 2.1件/千行 0.4件/千行 境界部分の不具合が減少

この表からも分かるように、MVVM移行の効果は単にコードが分割されるという見た目の変化に留まりません。
「変更に強く、検証が容易で、長く愛されるコード」へとプロジェクト全体の性質を変えることにあるのです。

変化の本質とMVVMの真の価値

MVVM移行前後の変化を見ると、「コードを二つに分ける」という作業の背後に、はるかに大きな目的が存在することに気づきます。
それは「画面の技術と業務の知識を分離する」という、アーキテクチャの本来の目的です。

画面の技術は時間とともに変化し続けます。
しかしアプリが提供するべき価値、すなわち業務上のルールやデータの扱い方は、それほど頻繁に変わるものではありません。
MVVMはこの二つの異なる性質のものを分離し、一方が変化したときに他方が影響を受けないようにするための設計手法なのです。

Massive View Controllerというアンチパターンは、この二つの性質の異なるものを一箇所に詰め込んでいたことが根本的な原因でした。
MVVMへと構造を改めることで、時間が経っても色褪せない本質的な価値をコードの中に守り続けることができるのです。
これが技術者にとっても利用者にとっても、最も大きな改善効果であると言えるでしょう。

【まとめ】MVVM導入でアンチパターンを打破し保守性の高いSwiftアプリを作る

MVVM導入でアンチパターンを打破し保守性の高いSwiftアプリ実現

iOS開発の現場で長年当たり前のように見過ごされてきたMassive View Controllerの問題は、決して開発者の実装力不足が原因で生まれるものではありません。
MVCというアーキテクチャとSwiftのUIフレームワークの組み合わせが本質的に抱える構造的な課題であり、プロジェクトの成長とともに必然的に表面化する問題だと言えます。
画面の制御と業務ロジックが一つのファイルに収容され、修正のたびに不具合のリスクが増大し、テストさえままならない状況は、多くの開発者が経験してきたことでしょう。

MVVMはこの構造的な課題に対して極めてシンプルで強力な解決策を提示してくれます。
ViewControllerを画面との対話に専念させ、本来画面が知る必要のないデータの加工や業務上の判定処理をViewModelへと分離する。
ただそれだけのことで、これまで当たり前だと思っていた多くの問題が一気に解決へと向かうのです。
もちろん新しい設計の原則を理解し、責務の境界線を正しく引く作業には学習と慣れが必要です。
しかしその代わりに得られるものは、修正のたびに不安を感じる日々からの解放であり、長く安定して成長させ続けられるアプリの基盤です。

MVVMの導入において最も重要なのは、完璧を目指して一気に全てを書き換えようとしないことです。
影響範囲の小さい画面から一つずつ着手し、処理の種類ごとに責務を分け、動作を確認しながら少しずつ改善を進めていく。
その過程で「画面の見た目」と「アプリの価値を決めるロジック」を分離するという本来の目的を見失わず、ViewModelが画面の実装に依存しない状態を保ち続けることができれば、いつの間にかプロジェクト全体は信頼できる堅牢な構造へと変化していることでしょう。

この構造がもたらす恩恵は、単にコードが整理されるという見た目の改善に留まりません。
業務ロジックが画面部品から隔離されることで単体テストが容易になり、品質が向上すると同時に開発のスピードも取り戻すことができます。
また将来的にUIの仕様が変更されたり新しいフレームワークへの移行が必要になったりした場合でも、長年をかけて築いた業務の知識と価値を作り直すことなく、そのまま受け継いでいくことができるのです。

アプリケーションの真の価値は、画面の美しさや表示技術の先進性だけで決まるものではありません。
その裏側にあるデータの扱い方、ユーザーの操作への対応、守るべきルールの一つひとつこそが長く利用者に支持され続ける理由です。
MVVMはそうした本質的な価値を技術の変化から守り、プロジェクトが長く健康的に成長し続けられるようにするための設計手法なのです。

Massive View Controllerというアンチパターンから抜け出し、保守性の高いSwiftアプリを作るという目標は、正しい原則を持って段階的に取り組めば決して難しいことではありません。
これまでの開発で培った資産を大切にしながら、一つずつ処理を整理し、ViewModelへと責務を移し替えていく。
その積み重ねが、いつか大きな変化となって現れることを、この記事を通じて実感していただければ幸いです。

コメント

タイトルとURLをコピーしました