Tutoriel : Publier une application console .NET à l’aide de Visual Studio Code

Ce tutoriel montre comment publier une application console afin que d’autres utilisateurs puissent l’exécuter. La publication crée l’ensemble de fichiers nécessaires pour exécuter une application. Pour déployer les fichiers, copiez-les sur l’ordinateur cible.

L’interface CLI .NET est utilisée pour publier l’application.

Conditions préalables

• Ce didacticiel fonctionne avec l’application console que vous créez dans Créer une application console .NET à l’aide de Visual Studio Code.

Publier l’application

1. Démarrez Visual Studio Code.

2. Ouvrez le dossier de projet HelloWorld que vous avez créé dans Créer une application console .NET à l’aide de Visual Studio Code.

3. Choisissez Afficher>Terminal dans le menu principal.

   Le terminal s’ouvre dans le dossier HelloWorld.

4. Exécutez la commande suivante :

   dotnet publish
   

   La configuration de build par défaut est Release, qui convient pour un site déployé exécuté en production. La sortie de la configuration de compilation Release contient des informations de débogage symboliques minimales et est entièrement optimisée.

   La sortie de commande est similaire à l’exemple suivant :

   Restore complete (1.1s)
     HelloWorld net10.0 succeeded (7.8s) → bin\Release\net10.0\publish\
   
   Build succeeded in 10.3s
   

1. Ouvrez votre GitHub Codespace que vous avez créé dans Créer une application console .NET à l’aide de Visual Studio Code.

2. Ajoutez la ligne de code suivante en haut de HelloWorld.cs :

   #:property PublishAot=false
   

   Cette directive de propriété désactive la compilation native anticipée (AOT) et l’application utilisera le compilateur juste-à-temps standard (JIT) au moment de l’exécution. La sortie publiée dépend du cadre.

3. Dans le terminal, vérifiez que vous êtes dans le dossier des didacticiels .

4. Exécutez la commande suivante :

   dotnet publish HelloWorld.cs
   

   La commande crée un exécutable indépendant.

   La sortie de commande est similaire à l’exemple suivant :

   Restore complete (0.5s)
     HelloWorld net10.0 succeeded (4.0s) → artifacts\HelloWorld\
   
   Build succeeded in 5.1s
   

Inspecter les fichiers

Par défaut, le processus de publication crée un déploiement dépendant du framework, qui est un type de déploiement où l’application publiée s’exécute sur un ordinateur sur lequel le runtime .NET est installé. Pour exécuter l’application publiée, vous pouvez utiliser le fichier exécutable ou exécuter la commande dotnet HelloWorld.dll à partir d’une invite de commandes.

Dans les étapes suivantes, vous allez examiner les fichiers créés par le processus de publication.

1. Sélectionnez l’explorateur dans la barre de navigation gauche.

2. Étendez bin/Release/net10.0/publish.

   Explorateur

   Comme l’illustre l’image, la sortie publiée comprend les fichiers suivants :

   • HelloWorld.deps.json

     Il s’agit du fichier de dépendances d’exécution de l’application. Il définit les composants .NET et les bibliothèques (y compris la bibliothèque de liens dynamiques qui contient votre application) nécessaires pour exécuter l’application. Pour plus d'informations, consultez fichiers de configuration d'exécution.

   • HelloWorld.dll

     Il s’agit de la version de déploiement dépendante du framework de l’application. Pour exécuter cette bibliothèque de liens dynamiques, entrez dotnet HelloWorld.dll à l'invite de commande. Cette méthode d’exécution de l’application fonctionne sur n’importe quelle plateforme sur laquelle le runtime .NET est installé.

   • HelloWorld.exe (HelloWorld sur Linux ou macOS.)

     Il s'agit de la version de l'application, qui est un exécutable dépendant du framework . Le fichier est spécifique au système d’exploitation.

   • HelloWorld.pdb (facultatif pour le déploiement)

     Il s’agit du fichier de symboles de débogage. Vous n’êtes pas obligé de déployer ce fichier avec votre application, même si vous devez l’enregistrer dans le cas où vous devez déboguer la version publiée de votre application.

   • HelloWorld.runtimeconfig.json

     Il s’agit du fichier de configuration du runtime de l’application. Il identifie la version de .NET sur laquelle votre application a été créée pour s’exécuter. Vous pouvez également y ajouter des options de configuration. Pour plus d’informations, consultez les paramètres de configuration de l'environnement d'exécution .NET.

Pour une application à fichier unique, le processus de publication crée un répertoire d’artefacts avec un fichier d’assembly compilé. L’application publiée peut être exécutée à l’aide de la dotnet commande.

Dans les étapes suivantes, vous allez examiner les fichiers créés par le processus de publication.

1. Sélectionnez l’explorateur dans la barre de navigation gauche.

2. Ouvrez artéfacts/HelloWorld.

   Explorateur

   Comme l’illustre l’image, la sortie publiée comprend les fichiers suivants :

   • Helloworld

     Il s'agit de la version de l'application, qui est un exécutable dépendant du framework . Le fichier est spécifique au système d’exploitation. Codespaces s’exécute sur Linux, ce qui en fait un exécutable Linux.

   • HelloWorld.deps.json

     Il s’agit du fichier de dépendances d’exécution de l’application. Il définit les composants .NET et les bibliothèques (y compris la bibliothèque de liens dynamiques qui contient votre application) nécessaires pour exécuter l’application. Pour plus d'informations, consultez fichiers de configuration d'exécution.

   • HelloWorld.dll

     Il s’agit de la version de déploiement dépendante du framework de l’application. Pour exécuter cette bibliothèque de liens dynamiques, entrez dotnet HelloWorld.dll à l'invite de commande. Cette méthode d’exécution de l’application fonctionne sur n’importe quelle plateforme sur laquelle le runtime .NET est installé.

   • HelloWorld.pdb (facultatif pour le déploiement)

     Il s’agit du fichier de symboles de débogage. Vous n’êtes pas obligé de déployer ce fichier avec votre application, même si vous devez l’enregistrer dans le cas où vous devez déboguer la version publiée de votre application.

   • HelloWorld.runtimeconfig.json

     Il s’agit du fichier de configuration du runtime de l’application. Il identifie la version de .NET sur laquelle votre application a été créée pour s’exécuter. Vous pouvez également y ajouter des options de configuration. Pour plus d’informations, consultez les paramètres de configuration de l'environnement d'exécution .NET.

   Cliquez avec le bouton droit et sélectionnez Télécharger... pour télécharger des fichiers à partir de Codespaces sur votre ordinateur local.

Exécuter l’application publiée

1. Dans l'Explorateur, cliquez avec le bouton droit de la souris sur le dossier de publication (Ctrl-clic sur macOS), puis sélectionnez Ouvrir dans le terminal intégré.

   menu contextuel

2. Sur Windows ou Linux, exécutez l’application à l’aide de l’exécutable.

   1. Sur Windows, entrez .\HelloWorld.exe et appuyez sur Entrée.

   2. Sur Linux, entrez ./HelloWorld et appuyez sur Entrée.

   3. Entrez un nom en réponse à l’invite, puis appuyez sur Entrée pour quitter.

3. Sur n’importe quelle plateforme, exécutez l’application à l’aide de la commande dotnet :

   1. Entrez dotnet HelloWorld.dll, puis appuyez sur Entrée.

   2. Entrez un nom en réponse à l’invite, puis appuyez sur Entrée pour quitter.

1. Dans l’Explorateur, cliquez avec le bouton droit sur le dossier artefacts/HelloWorld , puis sélectionnez Ouvrir dans le terminal intégré.

2. Exécutez l’application à l’aide de l’exécutable. Entrez ./HelloWorld , puis appuyez sur Entrée.

3. Entrez un nom en réponse à l’invite, puis appuyez sur Entrée pour quitter.

Ressources additionnelles

• Vue d’ensemble de la publication d’applications .NET
• dotnet publish
• Utiliser le Kit de développement logiciel (SDK) .NET dans les environnements d’intégration continue (CI)

Nettoyer les ressources

GitHub supprime automatiquement votre Espace de code après 30 jours d’inactivité. Si vous envisagez d’explorer d’autres tutoriels de cette série, vous pouvez laisser votre espace de code provisionné. Si vous êtes prêt à visiter le site .NET pour télécharger le Kit de développement logiciel (SDK) .NET, vous pouvez supprimer votre espace de code. Pour supprimer votre espace de code, ouvrez une fenêtre de navigateur et accédez à vos espaces de code. Vous voyez une liste de vos espaces de code dans la fenêtre. Sélectionnez les trois points (...) dans l’entrée de l’espace de code du didacticiel Learn. Sélectionnez ensuite « Supprimer ».

Étapes suivantes

Dans ce tutoriel, vous avez publié une application console. Dans le tutoriel suivant, vous créez une bibliothèque de classes.

Créer une bibliothèque de classes .NET à l’aide de Visual Studio Code