Postman-Klon mit Tim Corey bauen

Kursübersicht und Zweck

Tim beginnt damit, zu erklären, dass sich diese Lektion mit dem Einrichten der anfänglichen Struktur zur Erstellung eines Postman-Clones befasst. Er sagt klar, dass der Fokus noch nicht auf der Durchführung von API-Anfragen oder dem Umgang mit JSON-Antworten liegt, sondern darauf, die Projekte zu erstellen, sie korrekt zu konfigurieren und alles einsatzbereit zu machen.

Er erklärt, dass dieser Kurs darauf ausgelegt ist, Benutzern zu helfen, zu verstehen, wie ein echtes Postman-ähnliches Tool als einfache Windows-Anwendung erstellt werden könnte. Obwohl die endgültige App Postman nicht ersetzen wird, wird sie grundlegende Konzepte wie REST-Anfragen, Antworten und UI-Design demonstrieren. Tim erklärt auch, dass dieses Projekt zwar als Inspiration für Portfolioarbeit dienen kann, Benutzer es jedoch nicht direkt kopieren sollten. Stattdessen sollten sie es verbessern und modifizieren, um etwas Einzigartiges zu schaffen.

Erstellen der Klassenbibliothek für den Postman-Clone

An diesem Punkt öffnet Tim Visual Studio 2022 und beginnt den Einrichtungsprozess. Er erklärt, dass er die neueste zur Aufnahmezeit verfügbare Version verwendet und beginnt damit, ein neues Projekt zu erstellen. Für diese Lektion entscheidet er sich, zuerst die Klassenbibliothek zu erstellen.

Tim erklärt, dass diese Klassenbibliothek schließlich gemeinsamen Code enthalten wird, auf den die UI verweisen wird. Dieser Ansatz hilft dabei, die Anliegen zu trennen und die Anwendung organisiert zu halten. Er erklärt auch, dass die Reihenfolge der Projekterstellung normalerweise keine Rolle spielt, aber das Starten mit der Bibliothek ermöglicht es ihm, ein häufiges Problem zu demonstrieren, auf das Entwickler während der Einrichtung stoßen können.

Er sucht nach einer C#-Klassenbibliothek und betont, dass es sich um ein modernes .NET-Projekt handeln muss, nicht um das ältere .NET Framework. Tim wählt eine .NET 8-Klassenbibliothek aus und merkt an, dass neuere Versionen wie .NET 9 oder später ebenfalls funktionieren können. Er erklärt, dass Unterschiede zwischen Versionen ein normaler Teil der Entwicklung sind und das Lernen, sich anzupassen, eine wichtige Fähigkeit ist.

Die Lösung und Projekte korrekt benennen

Tim verbringt Zeit damit, zu erklären, wie er die Lösung und Projekte benennt. Er benennt die Lösung als die Postman-Clone-App und die Bibliothek als die Postman-Clone-Bibliothek. Er erklärt, dass das Hinzufügen des Wortes "Bibliothek" deutlich macht, welches Projekt die gemeinsame Logik enthält und welches Projekt die UI enthält.

Dieser Namensansatz hilft beim späteren Arbeiten mit Verweisen. Tim erklärt, dass Verweise immer von der UI zur Bibliothek fließen sollten und nie umgekehrt. Diese Designentscheidung unterstützt saubereren Code und ein besseres langfristiges Entwicklungsverständnis.

Er erklärt auch, warum er Lösung und Projekt nicht im selben Verzeichnis platziert. Da diese App mehrere Projekte enthalten wird, macht das Trennen einfacher die Navigation und vermeidet Verwirrung, wenn die Lösung wächst.

Hinzufügen des Windows Forms UI-Projekts

Sobald die Bibliothek erstellt ist, fügt Tim der Lösung ein zweites Projekt hinzu. Dieses Mal wählt er eine Windows Forms-Anwendung. Er erklärt, dass dieses Projekt als UI für den Postman-Clone dienen wird und es Benutzern schließlich ermöglicht, URLs einzugeben, Abfrageparameter festzulegen und Antworten anzusehen.

Er benennt das Projekt als Postman-Clone-UI und bestätigt erneut, dass es .NET 8 verwendet. Tim spricht kurz eine DPI-bezogene Nachricht an, die durch die Anpassung der Anzeigegröße verursacht wird. Er erklärt, dass dies für diese Lektion nicht wichtig ist und das Handling von DPI später erkundet werden kann, wenn nötig.

In dieser Phase enthält die Lösung nun zwei Projekte: eine Bibliothek und eine Windows Forms-UI. Diese Struktur bildet die Grundlage für den Aufbau eines Postman-ähnlichen Tools auf Windows.

Beheben des Startup-Projektproblems

Tim demonstriert ein Problem, das auftritt, weil die Klassenbibliothek zuerst erstellt wurde. Wenn er versucht, die Lösung zu starten, zeigt Visual Studio einen Fehler an, der besagt, dass eine Klassenbibliothek nicht direkt gestartet werden kann.

Tim erklärt, dass dies ein häufiges Einrichtungsproblem ist und betont die Bedeutung, Fehlermeldungen sorgfältig zu lesen. Er erklärt, dass Fehlermeldungen oft genau sagen, was falsch ist und wie es behoben werden kann.

Er zeigt zwei Möglichkeiten zur Behebung des Problems: das UI-Projekt als Startprojekt über das Kontextmenü festlegen oder es im Startprojekt-Dropdown in der Nähe der Schaltfläche Ausführen auswählen. Sobald dies erledigt ist, wird die Windows Forms-UI korrekt gestartet.

Hinzufügen des Projekts zu Git und GitHub

Mit der Lösung in der richtigen Struktur macht Tim mit der Quellcodekontrolle weiter. Er öffnet das Fenster Git-Änderungen und erklärt, dass die Versionskontrolle noch nicht aktiviert wurde. Er erstellt ein Git-Repository direkt aus Visual Studio.

Tim erklärt den Zweck der .gitignore-Datei und beschriebt, dass Build-Ausgaben wie kompilierte Dateien nicht in die Quellcodekontrolle aufgenommen werden sollten. Da diese Dateien neu erstellt werden können, haben sie nichts in einem GitHub-Repo zu suchen.

Er diskutiert auch die Lizenzierung und erklärt, dass die Wahl keine Lizenz zu haben bedeutet, alle Rechte am Code zu behalten. Tim fügt eine README-Datei hinzu und erklärt, wie wichtig sie ist, um das Projekt zu erklären, besonders wenn es geteilt oder als Teil eines Portfolios verwendet wird.

Tim benennt das GitHub-Repository, fügt eine klare Beschreibung hinzu, die erklärt, dass dies eine Windows Forms-Nachbildung von Postman ist, und wählt, das Repository privat zu halten, damit Benutzer sich auf das Lernen statt auf das Kopieren des Codes konzentrieren.

Verständnis der Quellkontrollindikatoren

Nachdem der Code auf GitHub hochgeladen wurde, erklärt Tim die Sperr-Symbole, die im Projektmappen-Explorer angezeigt werden. Diese Symbole zeigen an, dass Dateien von der Quellverwaltung verfolgt werden und nicht geändert wurden.

Er erklärt, wie sich diese Indikatoren ändern, wenn Dateien hinzugefügt oder aktualisiert werden, was Entwicklern hilft zu verstehen, welche Änderungen commitet werden. Dieses visuelle Feedback wird sehr nützlich, wenn das Projekt wächst und mehr Funktionen hinzugefügt werden.

Beibehaltung von Class1 und Hinzufügen einer Referenz

Tim erklärt, warum die standardmäßige Class1-Datei vorerst in der Bibliothek verbleibt. Ohne mindestens eine Klasse hätte die Bibliothek keinen Namespace, wodurch es unmöglich wäre, sie von der Benutzeroberfläche aus zu referenzieren.

Er fügt dann die Bibliothek als Abhängigkeit des UI-Projekts hinzu. Tim demonstriert sowohl das Ziehen der Bibliothek in die UI-Abhängigkeiten als auch die Verwendung der Option 'Projektverweis hinzufügen'. Dieser Schritt ermöglicht es der UI, auf gemeinsamen Code zuzugreifen, was entscheidend für den Aufbau eines strukturierten Postman-Klons ist.

Umbenennen von Form1 in Dashboard

Tim benennt das Standardformular Form1 in Dashboard um und erklärt, dass dieses Formular den Hauptbildschirm der Anwendung darstellt. Wenn dieses Formular geschlossen wird, schließt sich die Anwendung ebenfalls.

Er stellt sicher, dass alle Verweise korrekt aktualisiert werden, einschließlich der Code-Behind-Datei und Program.cs. Tim konvertiert auch den Namespace in Program.cs in einen dateigebundenen Namespace und erklärt, dass dies mehr Raum und eine sauberere Formatierung für zukünftige Änderungen bietet.

Anpassen der UI-Eigenschaften und Schrifteinstellungen

Tim öffnet das Dashboard-Formular und konzentriert sich auf das Eigenschaftenfenster. Er erklärt, wie Entwickler Fenster in Visual Studio neu positionieren können, um ihrem Arbeitsablauf zu entsprechen.

Er ändert den Formulartitel, um die Anwendung klar als Postman-Klon zu identifizieren, und erhöht die Standardschriftgröße von 9 auf 18. Tim erklärt, dass die frühe Einstellung der Schriftgröße eine konsistente Größenwahl für alle zukünftigen Steuerelemente der UI gewährleistet.

Initiale Einrichtung committen

Mit allen abgeschlossenen Einrichtungsschritten staged Tim die geänderten Dateien und erstellt einen Commit. Er erklärt, dass die Commit-Nachricht nicht perfekt sein muss, aber die Einrichtungsänderungen klar beschreiben sollte.

Er committet und synchronisiert den Code mit GitHub, stellt sicher, dass das Repo vollständig aktualisiert und bereit für die fortgesetzte Entwicklung ist.

Vorbereitung auf den nächsten Schritt beim Aufbau des Postman-Klons

Um das Video abzuschließen, erklärt Tim, dass die Projekteinstellung nun abgeschlossen ist. In der nächsten Lektion wird der Fokus auf den Aufbau der UI und das Erstellen einer einfachen Möglichkeit zum Senden von GET-Anfragen an eine API und zum Anzeigen von Antworten verlagert.

Er ermutigt die Zuschauer, den nächsten Schritt auf eigene Faust zu versuchen, bevor sie das nächste Video ansehen. Das Ziel ist es, eine einfache Schnittstelle zu schaffen, die Anfragen senden, Daten empfangen und formatierte JSON-Antworten anzeigen kann. Dieser Ansatz hilft den Benutzern, den Prozess besser zu verstehen und bereitet sie darauf vor, die Anwendung im Laufe der Zeit zu erweitern.

Tim schließt mit der Erinnerung daran, dass dieses Projekt wachsen soll. Der Start mit einer einfachen Einrichtung ermöglicht es Entwicklern, Vertrauen aufzubauen, den Workflow zu verstehen und das Projekt schrittweise in ein bedeutungsvolles Postman-ähnliches Werkzeug zu verwandeln.