Partage via

Tutoriel : Publier une application console .NET

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.

Prerequisites

Publier l’application

  1. Démarrez Visual Studio.

  2. Ouvrez le projet HelloWorld que vous avez créé dans Créer une application console .NET.

  3. Assurez-vous que Visual Studio utilise la configuration de build Release. Si nécessaire, modifiez le paramètre de configuration de compilation dans la barre d’outils de Debug en Release.

    Barre d'outils Visual Studio avec la version de build de release sélectionnée.

  4. Cliquez avec le bouton droit sur le projet HelloWorld (et non la solution HelloWorld) et sélectionnez Publier dans le menu.

    Visual Studio Publier un menu contextuel.

  5. Sous l’onglet Cible de la page Publier, sélectionnez Dossier, puis Suivant.

    Choisissez une cible de publication dans Visual Studio.

  6. Sous l’onglet Cible spécifique de la page Publier, sélectionnez Dossier, puis Suivant.

    Sélectionnez la cible de publication spécifique dans Visual Studio.

  7. Sous l’onglet Emplacement de la page Publier, sélectionnez Terminer.

    Visual Studio onglet Publier l’emplacement de la page.

  8. Sur la page Publier la progression de la création du profil, sélectionnez Fermer.

  9. Sous l’onglet Publier de la fenêtre publier , sélectionnez Publier.

    Fenêtre de publication de Visual Studio.

  1. Démarrez Visual Studio Code.

  2. Ouvrez le dossier de projet HelloWorld que vous avez créé dans Créer une application console .NET.

  3. Choisissez AfficherTerminal 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 espace de code GitHub que vous avez créé dans Créer une application console .NET.

  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 de l’infrastructure, 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é. Les utilisateurs peuvent exécuter l’application publiée en double-cliquant sur l’exécutable ou en émettant la commande à partir d’une invite de commandes.

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

  1. Dans Explorateur de solutions, sélectionnez Show All Files.

    option Explorateur de solutions pour afficher tous les fichiers.

  2. Dans le dossier du projet, étendez bin/Release/{net}/publish. (Où {net} est le dossier du framework cible, tel que net10.0.)

    Explorateur de solutions affichant les fichiers publiés.

    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épendant du framework de l’application. Pour exécuter cette bibliothèque de liens dynamiques, entrez à la ligne 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

      Il s'agit de la version de l'application, qui est un exécutable dépendant du framework . Pour l’exécuter, entrez à l’invite de commandes. 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 .NET paramètres de configuration du runtime.

Par défaut, le processus de publication crée un déploiement dépendant de l’infrastructure, 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 à 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 affichant des fichiers publiés

    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épendant du framework de l’application. Pour exécuter cette bibliothèque de liens dynamiques, entrez à 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 .NET paramètres de configuration du runtime.

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 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 affichant des fichiers publiés

    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épendant du framework de l’application. Pour exécuter cette bibliothèque de liens dynamiques, entrez à 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 .NET paramètres de configuration du runtime.

    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 Explorateur de solutions, cliquez avec le bouton droit sur le dossier publish, puis sélectionnez Copy Full Path.

  2. Ouvrez une fenêtre de commande et accédez au dossier publish. Pour ce faire, entrez , puis collez le chemin d’accès complet. Par exemple:

    cd C:\Projects\HelloWorld\bin\Release\net10.0\publish\

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

    1. Entrez , puis appuyez sur Entrée.

    2. Entrez un nom en réponse à l’invite, puis appuyez sur n’importe quelle touche pour quitter.

  4. Exécutez l’application à l’aide de la commande :

    1. Entrez , puis appuyez sur Entrée.

    2. Entrez un nom en réponse à l’invite, puis appuyez sur n’importe quelle touche pour quitter.

  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 Menu contextuel montrant 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 Enter.

    2. Sur Linux, entrez 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 :

    1. Entrez , 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 , puis appuyez sur Entrée.

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

Ressources supplémentaires

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 ».

Prochaines étapes

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

  • Last updated on