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 des fichiers qui sont 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. Vous pouvez donc suivre ce tutoriel avec un éditeur de code autre que Visual Studio Code si vous préférez.

Prérequis

• Ce tutoriel 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 --configuration Release
   

   La configuration de build par défaut est Debug. Cette commande spécifie donc la configuration de build Release. La sortie de la configuration de build Release contient des informations de débogage minimales relatives aux symboles et est entièrement optimisée.

   La sortie de commande ressemble à l’exemple suivant :

   Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\publish\
   

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 de gauche.

2. Développez bin/Release/net7.0/publish.

   

   Comme l’illustre l’image, la sortie publiée inclut 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 du runtime.

   • 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 commandes. 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 exécutable dépendante du framework de l’application. Le fichier est propre 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 au cas où vous auriez à 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 Paramètres de configuration d’exécution .NET Core.

Exécuter l’application publiée

1. Dans Explorer, cliquez avec le bouton droit sur le dossier de publication (Ctrl-clic sur macOS) et sélectionnez Ouvrir dans le terminal intégré.

   

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 n’importe quelle touche 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 n’importe quelle touche pour quitter.

Ressources supplémentaires

• déploiement d'applications .NET
• Publier des applications .NET avec l’interface CLI .NET
• dotnet publish
• Utiliser le SDK .NET dans les environnements d’intégration continue (CI)

Étapes suivantes

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

Créer une bibliothèque de classes .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 des fichiers qui sont 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. Vous pouvez donc suivre ce tutoriel avec un éditeur de code autre que Visual Studio Code si vous préférez.

Prérequis

• Ce tutoriel 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 --configuration Release
   

   La configuration de build par défaut est Debug. Cette commande spécifie donc la configuration de build Release. La sortie de la configuration de build Release contient des informations de débogage minimales relatives aux symboles et est entièrement optimisée.

   La sortie de commande ressemble à l’exemple suivant :

   Microsoft (R) Build Engine version 16.7.4+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\publish\
   

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 de gauche.

2. Développez bin/Release/net7.0/publish.

   

   Comme l’illustre l’image, la sortie publiée inclut 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 du runtime.

   • 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 commandes. 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, non créé sur macOS.)

     Il s’agit de la version exécutable dépendante du framework de l’application. Le fichier est propre 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 au cas où vous auriez à 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 Paramètres de configuration d’exécution .NET Core.

Exécuter l’application publiée

1. Dans l’Explorateur, cliquez avec le bouton droit sur le dossier de publication (Ctrl-clicsur macOS), puis sélectionnez Ouvrir dans le terminal.

   

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. Sur Windows avec le terminal Bash, entrez ./HelloWorld.exe.

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

   3. Entrez un nom en réponse à l’invite, puis appuyez sur n’importe quelle touche 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 n’importe quelle touche pour quitter.

Ressources supplémentaires

• déploiement d'applications .NET
• Publier des applications .NET avec l’interface CLI .NET
• dotnet publish
• Utiliser le SDK .NET dans les environnements d’intégration continue (CI)

Étapes suivantes

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

Créer une bibliothèque de classes .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 des fichiers qui sont 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. Vous pouvez donc suivre ce tutoriel avec un éditeur de code autre que Visual Studio Code si vous préférez.

Prérequis

• Ce tutoriel 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 --configuration Release
   

   La configuration de build par défaut est Debug. Cette commande spécifie donc la configuration de build Release. La sortie de la configuration de build Release contient des informations de débogage minimales relatives aux symboles et est entièrement optimisée.

   La sortie de commande ressemble à l’exemple suivant :

   Microsoft (R) Build Engine version 16.7.0+b89cb5fde for .NET
   Copyright (C) Microsoft Corporation. All rights reserved.
     Determining projects to restore...
     All projects are up-to-date for restore.
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\HelloWorld.dll
     HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\
   

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 de gauche.

2. Développez bin/Release/net6.0/publish.

   

   Comme l’illustre l’image, la sortie publiée inclut 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 du runtime.

   • 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 commandes. 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, non créé sur macOS.)

     Il s’agit de la version exécutable dépendante du framework de l’application. Le fichier est propre 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 au cas où vous auriez à 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 Paramètres de configuration d’exécution .NET Core.

Exécuter l’application publiée

1. Dans l’Explorateur, cliquez avec le bouton droit sur le dossier de publication (Ctrl-clicsur macOS), puis sélectionnez Ouvrir dans le terminal.

   

2. Exécutez l’application à l’aide de l’exécutable.

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

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

   3. Entrez un nom en réponse à l’invite, puis appuyez sur n’importe quelle touche 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 n’importe quelle touche pour quitter.

Ressources supplémentaires

• déploiement d'applications .NET
• Publier des applications .NET avec l’interface CLI .NET
• dotnet publish
• Utiliser le SDK .NET dans les environnements d’intégration continue (CI)

Étapes suivantes

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

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