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. Construisez votre projet avec .NET build

La première commande que Tim explique est .NET 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.

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

2. Exécutez votre application avec .NET run

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

dotnet run

Utilisant son application web Blazor, Tim démontre que .NET run lance l'application basée sur le fichier de configuration launchSettings.json. L'URL et le port HTTP par défaut sont automatiquement sélectionnés. Il modifie la page d'accueil en utilisant Notepad, et note que les mises à jour ne sont pas reflétées jusqu'à ce que .NET run soit relancé (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 .NET add reference. Pour les développeurs exécutant des tests unitaires dans .NET Core, combiner .NET build avec .NET run assure que les assemblées spécifiées sont prêtes pour le runner de tests.

3. Rechargement à chaud avec .NET watch

Pour éliminer la nécessité de redémarrer votre application après chaque changement, Tim présente .NET watch, une commande CLI de surveilleur de fichiers 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 .NET 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, .NET 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 démontre que .NET clean est particulièrement utile lorsqu'on s'occupe de fichiers de solution contenant plusieurs projets .NET Core ou des projets de bibliothèque de classes avec des packages nuget.

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

5. Publier votre projet avec .NET publish

Enfin, Tim présente .NET 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).

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

Conseils et notes supplémentaires

Tim souligne que maîtriser ces cinq commandes du CLI .NET Core — .NET build, .NET run, .NET watch, .NET clean, et .NET publish — couvre environ 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 de nouveaux projets, les développeurs peuvent utiliser .NET new console, .NET 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, .NET restore aide à restaurer les ressources locales de NuGet et les assemblées spécifiées avant de construire.

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. .NET build - Compile explicitement votre projet en fichiers DLL dans le répertoire de sortie.

2. .NET run - Compile et exécute immédiatement l'application .NET Core.

3. .NET watch - Permet le rechargement à chaud via un surveilleur de fichiers pour refléter automatiquement les changements.

4. .NET clean - Supprime tous les fichiers compilés et dossiers intermédiaires pour un build propre.

5. .NET publish - Prépare une application .NET Core entièrement publiée pour le déploiement sur tout 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.