5 schnelle .NET CLI-Befehle, die jeder C#-Entwickler kennen sollte

Einführung in das .NET CLI und die .NET-Befehlszeilenschnittstelle

Zu Beginn des Videos betont Tim, dass auch wenn Sie ein IDE wie Visual Studio bevorzugen, das Verstehen der .NET-Befehlszeilenschnittstelle (CLI) entscheidend ist. Eine Befehlszeilenschnittstelle CLI ermöglicht es Ihnen, direkt mit Ihren .NET Core-Anwendungen zu interagieren, ohne sich auf die IDE zu verlassen. Dies ist besonders nützlich, wenn Sie Startbefehle ausführen, explizite Kompilationen durchführen oder in einer plattformübergreifenden Werkzeugumgebung mit Windows, Mac oder Linux arbeiten möchten.

Tim gibt auch einen kurzen Bonustipp bei 1:15: Ausführen von

dotnet --info

Dieser Befehl listet installierte .NET SDK-Versionen, Laufzeitpakete im Runtime-Paket-Speicher, Architektur und andere Umgebungsdetails auf. Er bestätigt, dass die .NET Core CLI installiert und einsatzbereit ist, was wichtig ist, bevor weitere Befehle erkundet werden.

1. Erstellen Sie Ihr Projekt mit dotnet build

Der erste Befehl, den Tim erklärt, ist dotnet build. Dieser Build-Befehl kompiliert Ihren Quellcode in DLL-Dateien im Ausgabeverzeichnis, typischerweise unter bin/Debug/net10/ oder bin/Release/net10/. Tim demonstriert das Löschen des bin-Verzeichnisses, um zuvor kompilierte Dateien zu entfernen und einen sauberen Build zu gewährleisten.

dotnet build

Tim erklärt, dass dieser Befehl die kompilierte Ausgabe basierend auf der Konfigurationsdatei und dem Projekttemplate erstellt, sei es eine Konsolenanwendung, eine Klassenbibliothek oder eine ASP.NET Core-Anwendung. Der Build-Befehl ist entscheidend, da er sicherstellt, dass Ihre .NET Core CLI genau weiß, was kompiliert werden muss und welche spezifizierten Dateien einzubeziehen sind.

Die Verwendung des Build-Befehls ist auch eine Voraussetzung für fortgeschrittenere CLI-Befehle wie dotnet run oder dotnet publish. Tim betont, dass obwohl Visual Studio Builds automatisch durchführt, das Wissen um die explizite Kompilierungsoption mit dotnet build in CI/CD-Pipelines oder Kernbefehlszeilen-Workflows hilft.

2. Führen Sie Ihre Anwendung mit dotnet run aus

Tims zweiter Befehl ist dotnet run, ein Ausführungsbefehl, der Ihre .NET Core-Anwendung in einem Schritt erstellt und ausführt. Im Gegensatz zu dotnet build, das nur kompiliert, führt dotnet run die Anwendung im aktuellen Terminal oder Befehlsfenster aus.

dotnet run

Mit seiner Blazor-Webapp zeigt Tim, dass dotnet run die Anwendung basierend auf der launchSettings.json-Konfigurationsdatei startet. Die Standard-URL und der HTTP-Port werden automatisch ausgewählt. Er bearbeitet die Startseite mit Notepad und merkt an, dass Änderungen nicht angezeigt werden, bis dotnet run erneut ausgeführt wird (5:02).

Dieser Befehl ist besonders hilfreich zum Testen von Konsolenanwendungen, ASP.NET Core-Webapps oder sogar Klassenbibliotheksprojekten, die andere DLL-Dateien mit dotnet add reference referenzieren. Für Entwickler, die Unittests in .NET Core ausführen, stellt die Kombination von dotnet build mit dotnet run sicher, dass die spezifizierten Assemblies für den Testrunner bereit sind.

3. Hot Reload mit dotnet watch

Um die Notwendigkeit zu beseitigen, Ihre App nach jeder Änderung neu zu starten, stellt Tim dotnet watch vor, einen Dateiüberwachungs-CLI-Befehl, der Hot Reload ermöglicht (5:44).

dotnet watch

Diese CLI-Befehlszeilenschnittstelle überwacht spezifizierte Dateien in Ihrem Projektverzeichnis und wendet Änderungen automatisch auf die laufende Anwendung an. Tim bearbeitet die Startseite erneut, ändert den Text von "Hallo YouTube" zurück zu "Hallo Welt" und der Browser aktualisiert sich in Echtzeit ohne Neustart.

Die Dateiüberwachungsfunktion ist unschätzbar für plattformübergreifende Entwicklung, da sie .NET Core-Entwicklern ermöglicht, in leichten Editoren wie Notepad zu arbeiten und dennoch die Hot Reload-Erfahrung zu haben, die normalerweise nur in Visual Studio oder VS Code verfügbar ist.

4. Säubern Sie Ihr Projekt mit dotnet clean

Manchmal können .NET-Projekte verbliebene kompilierte Dateien haben, die Fehler oder Inkonsistenzen verursachen. Tims vierter Befehl, dotnet clean, entfernt alle Dateien im Ausgabeverzeichnis und in den Zwischenordnern wie bin/ und obj/ (7:06).

dotnet clean

Nach dem Ausführen dieses Befehls werden nachfolgende Builds von Grund auf neu durchgeführt, was sicherstellt, dass keine DLL-Dateien oder lokalen NuGet-Ressourcen stören. Tim demonstriert, dass dotnet clean besonders hilfreich ist, wenn man mit Lösungsdateien arbeitet, die mehrere .NET Core-Projekte oder Klassenbibliotheksprojekte mit NuGet-Paketen enthalten.

Dieser Befehl sorgt für einen frischen Start für das Ausführen von Unittests mit dotnet test oder zur Vorbereitung des Projekts für die Bereitstellung.

5. Veröffentlichen Sie Ihr Projekt mit dotnet publish

Schließlich stellt Tim dotnet publish vor, das Ihre .NET Core-Anwendung für die Bereitstellung auf einem Hostsystem wie IIS, Azure oder anderen Umgebungen vorbereitet.

dotnet publish

Dieser CLI-Befehl kompiliert das Projekt und platziert die veröffentlichten Assets im Publish-Verzeichnis unter bin/Release/net10/. Die Ausgabe umfasst alle spezifizierten Assemblies, Laufzeitpakete und notwendige Entwicklerzertifikate für das Hosting. Tim betont, dass dieser Befehl für alle .NET Core-Projekte funktioniert, einschließlich Konsolenanwendungen, ASP.NET Core-Anwendungen und Klassenbibliotheken (8:18).

dotnet publish ist auch nützlich, wenn es mit dotnet pack kombiniert wird, um NuGet-Pakete zu erstellen, die Ihren Code für mehrere .NET Core-Lösungen wiederverwendbar machen.

Zusätzliche Tipps und Anmerkungen

Tim hebt hervor, dass die Beherrschung dieser fünf .NET Core CLI-Befehle – dotnet build, dotnet run, dotnet watch, dotnet clean und dotnet publish – etwa 85 % der täglichen Aufgaben in der .NET Core-Entwicklung abdecken (9:01). Er erwähnt auch andere Befehlsoptionen und detailliertere Dokumentationen online, wenn Sie fortgeschrittene Flags, Unittestrunner oder benutzerdefinierte Projekttemplates erkunden möchten.

Für neue Projekte können Entwickler dotnet new console, dotnet new class library oder andere spezifizierte Templates verwenden, um schnell eine .NET Core-Konsolenanwendung oder ein ASP.NET Core-Projekt zu erstellen. Darüber hinaus hilft dotnet restore, lokale NuGet-Ressourcen und spezifizierte Assemblies vor dem Build wiederherzustellen.

Diese Befehle sind plattformübergreifend, was bedeutet, dass die gleiche CLI-Befehlszeilenschnittstelle auf Windows, Mac und Linux funktioniert. Sie sind auch mit Projektvorlagen, Lösungsdateien, Konsolenanwendungen, Klassenbibliotheksprojekten und Model-View-Controller-Anwendungen kompatibel, was sie vielseitig für fast alle .NET Core-Projekte macht.

Zusammenfassung

Hier ist eine schnelle Zusammenfassung der fünf wesentlichen .NET Core CLI-Befehle, die Tim Corey empfiehlt:

1. dotnet build – Kompiliert Ihr Projekt explizit in DLL-Dateien im Ausgabeverzeichnis.

2. dotnet run – Baut und führt die .NET Core-Anwendung sofort aus.

3. dotnet watch – Ermöglicht Hot Reload über einen Datei-Überwacher, um Änderungen automatisch zu reflektieren.

4. dotnet clean – Entfernt alle kompilierten Dateien und Zwischenordner für einen frischen Build.

5. dotnet publish – Bereitet eine vollständig veröffentlichte .NET Core-Anwendung für die Bereitstellung auf jedem Hosting-System vor.

Diese Befehle befähigen Entwickler, .NET Core-Projekte, Lösungsdateien und Konsolenprojekte effizient mit der .NET CLI zu verwalten, ohne vollständig auf eine IDE angewiesen zu sein. Durch die Integration in Ihren Workflow können Sie Ihre .NET Core-Anwendungen schnell erstellen, ausführen, testen und mit Zuversicht bereitstellen.