5 commandes .NET CLI rapides que tout développeur C# devrait connaître

Introduction au .NET CLI et à l'interface en ligne de commande .NET

Au début de la vidéo, Tim souligne que même si vous préférez un IDE comme Visual Studio, il est crucial de comprendre l'interface en ligne de commande .NET (CLI). Une interface en ligne de commande CLI vous permet d'interagir directement avec vos applications .NET Core, sans compter sur l'IDE. Cela est particulièrement utile lorsque vous souhaitez exécuter des commandes de lancement, effectuer une compilation explicite, ou travailler dans un environnement d'outil multiplateforme utilisant Windows, Mac ou Linux.

Tim donne aussi un conseil bonus rapide à 1:15 : exécuter

dotnet --info

Cette commande liste les versions SDK .NET installées, les packages runtime dans le magasin de packages runtime, l'architecture et d'autres détails de l'environnement. Cela confirme que le CLI .NET Core est installé et prêt à être utilisé, ce qui est essentiel avant d'explorer d'autres commandes.

1. Construire votre projet avec dotnet build

La première commande que Tim explique est dotnet build. Cette commande de build compile votre code source en fichiers DLL dans le répertoire de sortie, généralement sous bin/Debug/net10/ ou bin/Release/net10/. Tim démontre le nettoyage du répertoire bin pour supprimer les fichiers préalablement compilés, assurant une construction propre.

dotnet build

Tim explique que cette commande crée le résultat compilé basé sur le fichier de configuration et le modèle de projet, que ce soit une application console, une bibliothèque de classes, ou une application ASP.NET Core. La commande build est essentielle car elle assure que votre CLI .NET Core sait exactement quoi compiler et quels fichiers spécifiés inclure.

Utiliser la commande build est également un prérequis pour les commandes CLI plus avancées comme dotnet run ou dotnet publish. Tim souligne que bien que Visual Studio gère les builds automatiquement, connaître l'option de compilation explicite avec dotnet build aide dans les pipelines CI/CD ou les workflows ligne de commande noyau.

2. Exécuter votre application avec dotnet run

La deuxième commande de Tim est dotnet run, une commande d'exécution qui construit et exécute votre application .NET Core en une étape. Contrairement à dotnet build, qui ne compile que, **dotnet run exécute l'application dans le terminal ou l'invite de commande actuelle.

dotnet run

En utilisant son application web Blazor, Tim montre que dotnet run lance l'application basée sur le fichier de configuration launchSettings.json. L'URL par défaut et le port HTTP sont automatiquement sélectionnés. Il modifie la page d'accueil avec Notepad, et note que les mises à jour ne se reflètent pas jusqu'à l'réexécution de dotnet run (5:02).

Cette commande est particulièrement utile pour tester les applications console, les applications web ASP.NET Core, ou même les projets de bibliothèque de classes qui référencent d'autres fichiers DLL en utilisant dotnet add reference. Pour les développeurs exécutant des tests unitaires dans .NET Core, combiner dotnet build avec dotnet run garantit que les assemblages spécifiés sont prêts pour le test runner.

3. Rechargement à chaud avec dotnet watch

Pour éliminer le besoin de redémarrer votre application après chaque changement, Tim introduit dotnet watch, une commande CLI file watcher qui permet le rechargement à chaud (5:44).

dotnet watch

Cette commande CLI interface ligne de commande surveille les fichiers spécifiés dans votre répertoire de projet et applique automatiquement les changements à l'application en cours d'exécution. Tim modifie à nouveau la page d'accueil, changeant le texte de " Hello YouTube " à " Hello World ", et le navigateur se met à jour en temps réel sans redémarrage.

La fonction file watcher est inestimable pour le développement multiplateforme, permettant aux développeurs .NET Core de travailler dans des éditeurs légers comme Notepad tout en maintenant l'expérience de rechargement à chaud généralement disponible uniquement dans Visual Studio ou VS Code.

4. Nettoyer votre projet avec dotnet clean

Parfois, les projets .NET peuvent avoir des fichiers compilés restants qui causent des erreurs ou des incohérences. La quatrième commande de Tim, dotnet clean, supprime tous les fichiers dans le répertoire de sortie et les dossiers intermédiaires, tels que bin/ et obj/ (7:06).

dotnet clean

Après avoir exécuté cette commande, les builds suivants sont réalisés à partir de zéro, assurant qu'aucun fichier DLL ou ressource NuGet locale n'interfèrent. Tim montre que dotnet clean est particulièrement utile lors du traitement de fichiers de solution contenant plusieurs projets .NET Core ou projets de bibliothèque de classes avec des packages nuget.

Cette commande assure un nouveau départ pour l'exécution des tests unitaires avec dotnet test ou pour préparer le projet pour le déploiement.

5. Publier votre projet avec dotnet publish

Enfin, Tim introduit dotnet publish, qui prépare votre application .NET Core pour le déploiement sur un système d'hébergement comme IIS, Azure, ou d'autres environnements.

dotnet publish

Cette commande CLI compile le projet et place les actifs publiés dans le dossier publish sous bin/Release/net10/. La sortie inclut tous les assemblages spécifiés, les packages runtime, et les certificats de développement nécessaires pour l'hébergement. Tim souligne que cette commande fonctionne pour tous les projets .NET Core, y compris les applications console, les applications ASP.NET Core, et les bibliothèques de classes (8:18).

dotnet publish est également utile lorsqu'il est combiné avec dotnet pack pour créer des packages NuGet, rendant votre code réutilisable à travers plusieurs solutions .NET Core.

Conseils et notes supplémentaires

Tim souligne que maîtriser ces cinq commandes CLI .NET Core —dotnet build, dotnet run, dotnet watch, dotnet clean, et dotnet publish—couvre à peu près 85% des tâches quotidiennes dans le développement .NET Core (9:01). Il mentionne également d'autres options de commande et une documentation plus détaillée en ligne si vous voulez explorer des drapeaux avancés, des runners de test unitaire, ou des modèles de projet personnalisés.

Pour les nouveaux projets, les développeurs peuvent utiliser dotnet new console, dotnet new class library, ou d'autres modèles spécifiés pour générer rapidement une application console .NET Core ou un projet ASP.NET Core. De plus, dotnet restore aide à restaurer les ressources NuGet locales et les assemblages spécifiés avant la construction.

Ces commandes sont multiplateformes, ce qui signifie que la même interface de ligne de commande CLI fonctionne sur Windows, Mac et Linux. Elles sont également compatibles avec les modèles de projet, les fichiers de solution, les applications console, les projets de bibliothèque de classes, et les applications modèle-vue-contrôleur, les rendant polyvalentes pour presque tous les projets .NET Core.

Résumé

Voici un résumé rapide des cinq commandes CLI essentielles .NET Core recommandées par Tim Corey :

1. dotnet build – Compile explicitement votre projet en fichiers DLL dans le répertoire de sortie.

2. dotnet run – Construit et exécute immédiatement l'application .NET Core.

3. dotnet watch – Active le rechargement à chaud via un file watcher pour refléter automatiquement les changements.

4. dotnet clean – Supprime tous les fichiers compilés et les dossiers intermédiaires pour une construction propre.

5. dotnet publish – Prépare une application .NET Core entièrement publiée pour le déploiement sur n'importe quel système d'hébergement.

Ces commandes permettent aux développeurs de gérer efficacement les projets .NET Core, les fichiers de solution, et les projets console en utilisant la CLI .NET sans s'appuyer entièrement sur un IDE. En les incorporant dans votre workflow, vous pouvez rapidement construire, exécuter, tester, et déployer vos applications .NET Core avec confiance.