Tim Coreyと共にPostman Cloneを構築する

このレッスンでは、アプリケーションの基盤を慎重に設定することでPostmanクローンを構築する方法に詳しく見ていきます。 Tim Coreyはこのプロセスを彼のコースのレッスン2番で説明しており、焦点は完全にプロジェクトのセットアップにあり、機能やAPIロジックではありません。 この段階での目標は、リクエストを作成したり、レスポンスを処理したり、REST APIとやりとりすることではなく、アプリの構造が最初から正しく設計されていることを確認することです。

Timは、スクラッチから自分のPostmanスタイルのツールを構築する方法を示す完全なコースの一部として、このレッスンを紹介します。 彼は、このプロジェクトがアプリケーションのライフサイクルを、セットアップから改良、最終的には実際のPostmanの代替品に近いものへと理解するために役立つことを説明しています。レッスンは初心者向けで、意図的にスローペースで進行し、ユーザーがついて行き、各決定がなぜなされたのかを理解できるようにしています。

このビデオ"プロジェクトのセットアップ: Postmanクローンコースの構築"を通じて、Timは視聴者がWindows Formsアプリケーションを正しくセットアップし、それをサポートするクラスライブラリに接続し、将来のAPI開発のためにソリューションの準備ができるように手助けします。

コースの概観と目的

Timは、Postmanクローンを構築するために必要な最初の構造をセットアップすることをこのレッスンの主題として説明します。 彼は、まだAPIリクエストを行ったりJSONレスポンスを処理したりすることに焦点を当てていないことを明確にし、代わりにプロジェクトを作成し、それらを正しく設定し、すべての準備を整えることに注力します。

このコースは、Postmanのような実世界のツールがどのようにして単純なWindowsアプリケーションとして構築されるかをユーザーが理解するのを助けるために設計されています。 最終的なアプリはPostmanを置き換えはしませんが、RESTリクエスト、レスポンス、UIデザインなどの基本的な概念を示すでしょう。 Timはまた、このプロジェクトがポートフォリオ作品にインスピレーションを与える可能性があることを説明していますが、ユーザーはそれを直接コピーしてはなりません。 むしろ、彼らを強化し修正することで、自分だけのユニークな何かを作成すべきです。

Postmanクローンのためのクラスライブラリを作成する

この時点で、TimはVisual Studio 2022を開き、セットアッププロセスを開始します。 彼は録画時点で利用可能な最新バージョンを使用していることを説明し、新しいプロジェクトを作成することから始めます。 このレッスンでは、まずクラスライブラリを作成することを選びます。

Timは、このクラスライブラリが最終的にUIが参照する共有コードを保持することを説明します。 このアプローチは懸念を分離し、アプリケーションを整理するのに役立ちます。 彼は通常、プロジェクト作成の順序は問題にならないことが多いと説明していますが、最初にライブラリを開始することで、開発者がセットアップ中に直面する可能性がある一般的な問題を示すことができます。

彼はC#クラスライブラリを検索し、それが古い.NET Frameworkではなく最新 for .NETプロジェクトである必要があることを強調します。 Timは.NET 8クラスライブラリを選択し、.NET 9以降の新しいバージョンも使用できると述べています。 彼は、バージョン間の違いが開発の通常の一部であり、適応する方法を学ぶことが重要なスキルであると説明します。

ソリューションとプロジェクトの正しい命名

Timはソリューションとプロジェクトの命名について時間をかけて説明します。 彼はPostmanクローンアプリとしてソリューションを命名し、ライブラリをPostmanクローンライブラリとして命名します。 彼は、"ライブラリ"という言葉を含めることが、どのプロジェクトが共有ロジックを含み、どのプロジェクトがUIを含むかを非常に明確にすることを説明します。

この命名アプローチは参照と共に作業する際に役立ちます。 Timは、参照は常にUIからライブラリに流れるべきであり、その逆はないと説明しています。 この設計選択はよりクリーンなコードと長期的な開発プロセスをサポートします。

彼はまた、ソリューションとプロジェクトを同じディレクトリに置かない理由を説明します。 このアプリは複数のプロジェクトを含むことになるため、それらを分けることでナビゲーションが容易になり、ソリューションの成長に伴う混乱を避けることができます。

Windows Forms UIプロジェクトの追加

ライブラリが作成されると、Timはソリューションに2番目のプロジェクトを追加します。 今回はWindows Formsアプリケーションを選択します。 彼は、このプロジェクトがPostmanクローンのUIとして役立ち、最終的にはユーザーがURLを入力し、クエリパラメータを入力し、レスポンスを表示できるようになることを説明します。

彼はプロジェクトをPostmanクローンUIと命名し、再度.NET 8を使用していることを確認します。Timは、ディスプレイスケーリングによって引き起こされるDPI関連のメッセージについて簡単に述べます。 彼は、これはこのレッスンには重要でなく、必要であれば後でDPI処理を探求できると説明しています。

この時点で、ソリューションには2つのプロジェクトが含まれており、ライブラリとWindows Forms UIです。 この構造は、Windows上でPostmanスタイルのツールを構築する基礎となります。

スタートアッププロジェクトの問題を修正する

Timは、最初にクラスライブラリを作成したために発生する問題を示します。彼がソリューションを実行しようとすると、Visual Studioはクラスライブラリを直接開始できないとエラーを表示します。

Timは、これは一般的なセットアップ問題であり、エラーメッセージを注意深く読むことの重要性を強調します。 彼はエラーメッセージが何が間違っているのか、どうすれば修正できるかを教えてくれることが多いと説明します。

彼は問題を解決する2つの方法を示します: コンテキストメニューを使用してUIプロジェクトをスタートアッププロジェクトとして設定するか、または実行ボタンの近くのスタートアッププロジェクトドロップダウンから選択することが可能です。 これが完了すると、Windows Forms UIが正しく起動します。

プロジェクトをGitとGitHubに追加する

ソリューション構造が整ったら、Timはソース管理に進みます。 彼はGit Changesウィンドウを開き、バージョン管理がまだ有効になっていないことを説明します。 彼はVisual Studioから直接Gitリポジトリを作成します。

Timは.gitignoreファイルの目的を説明し、ビルド出力、例えばコンパイル済みファイルはソース管理に含まれるべきでないと述べます。 これらのファイルは再生成可能なので、GitHub repoには属しません。

彼はまたライセンスについて議論し、ライセンスを選択しないことがコードのすべての権利を保持することを意味すると説明します。 TimはREADMEファイルを追加し、プロジェクトを説明する上で特にポートフォリオの一部として共有される場合の重要性を説明します。

TimはGitHubリポジトリに名前を付け、このPostmanのWindows Forms再現であることを分かりやすく説明する説明を追加し、ユーザーがコードをコピーするのではなく学習に集中できるようにリポジトリを非公開にすることを選択します。

ソース管理インジケーターを理解する

コードをGitHubにプッシュした後、TimはSolution Explorerに表示されるロックアイコンを説明します。 これらのアイコンはファイルがソース管理によって追跡され、変更されていないことを示しています。

彼はファイルが追加または更新されるとこれらのインジケーターがどのように変化するかを説明し、開発者がどの変更がコミットされるべきかを理解するのに役立ちます。 このビジュアルフィードバックは、プロジェクトが成長し、より多くの機能が追加されると非常に便利になります。

Class1を保持し、リファレンスを追加する

Timは、なぜ現在ライブラリにデフォルトのClass1ファイルを残しているのか説明します。 少なくとも1つのクラスがなければ、ライブラリには名前空間がなくなり、UIから参照することができません。

そのため、彼はライブラリをUIプロジェクトの依存関係として追加します。 Timは、ライブラリをUI依存関係にドラッグする方法と、プロジェクトリファレンスの追加オプションを使用する方法の両方を示します。 この手順でUIが共有コードにアクセスできるようになり、構造化されたPostmanクローンの構築に不可欠です。

Form1をダッシュボードにリネームする

TimはデフォルトのForm1をダッシュボードにリネームし、このフォームがアプリケーションのメイン画面を表すことを説明します。 このフォームが閉じられると、アプリケーションも終了します。

彼は、すべての参照が適切に更新されていることを確認し、コードビハインドファイルとProgram.csも更新します。 TimはProgram.csの名前空間をファイルスコープの名前空間に変換し、将来の変更に対するスペースとクリーンなフォーマットを提供することを説明します。

UIプロパティとフォント設定の調整

Timはダッシュボードフォームを開き、プロパティウィンドウに注目します。 彼はVisual Studio内でウィンドウを再配置してワークフローに一致させる方法を説明します。

彼はフォームのタイトルを変更して、このアプリケーションがPostmanクローンであることを明確に識別し、デフォルトのフォントサイズを9から18に増やします。Timは、フォントサイズを早期に設定することで、今後UIに追加されるすべてのコントロールに対して一貫したサイズを確保できることを説明します。

初期セットアップのコミット

すべてのセットアップ変更が完了したら、Timは変更されたファイルをステージングし、コミットを作成します。 彼はコミットメッセージが完璧である必要はないが、セットアップの変更を明確に記述するべきだと説明します。

彼はコミットと同期をGitHubと行い、リポジトリが完全に更新され、開発を続ける用意ができていることを確認します。

次の段階のための準備: Postmanクローンの構築

このビデオを締めくくるために、Timはプロジェクトセットアップが完了であると説明します。 次のレッスンでは、UIの構築に焦点を移し、APIにGETリクエストを送信し、レスポンスを表示する簡単な方法を作成します。

彼は視聴者に、次のビデオを見る前に自分で次のステップを試みるよう勧めます。 目標は、リクエストを送信し、データを受信し、フォーマットされたJSONレスポンスを表示できるシンプルなインターフェースを作成することです。 このアプローチはプロセスをよりよく理解し、アプリケーションを時間とともに強化する準備をさせます。

Timは、このプロジェクトが成長し続けることを意図していることを視聴者に思い出させて締めくくります。 シンプルなセットアップから始めることで、開発者は自信を培い、ワークフローを理解し、最終的にはプロジェクトを意味のあるPostmanスタイルのツールに徐々に変えることができます。