Lernprogramm: Veröffentlichen einer .NET-Konsolenanwendung mit Visual Studio Code

Artikel
12/28/2024

In diesem Lernprogramm wird gezeigt, wie Sie eine Konsolen-App veröffentlichen, damit andere Benutzer sie ausführen können. Beim Veröffentlichen wird der Satz von Dateien erstellt, die zum Ausführen einer Anwendung erforderlich sind. Zum Bereitstellen der Dateien kopieren Sie diese auf den Zielcomputer.

Die .NET-CLI wird zum Veröffentlichen der App verwendet. Sie können dieses Tutorial also auch mit einem anderen Code-Editor als Visual Studio Code absolvieren.

Voraussetzungen

Dieses Tutorial kann mit der Konsolen-App durchgeführt werden, die Sie in Tutorial: Erstellen einer .NET-Konsolenanwendung mit Visual Studio Code erstellen.

Veröffentlichen der App

Starten Sie Visual Studio Code.
Öffnen Sie den HelloWorld Projektordner, den Sie in Erstellen einer .NET-Konsolenanwendung mit Visual Studio Codeerstellt haben.
Klicken Sie im Hauptmenü auf Ansicht>Terminal.

Das Terminal wird im Ordner HelloWorld geöffnet.

Führen Sie den folgenden Befehl aus:

dotnet publish

Die Standard-Build-Konfiguration ist Release, die für eine bereitgestellte Site geeignet ist, die im Produktionsbetrieb ausgeführt wird. Die Ausgabe der Releasekonfiguration enthält nur wenige symbolischen Debuginformationen und wird vollständig optimiert.

Die Befehlsausgabe ähnelt dem folgenden Beispiel:

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\

Überprüfen der Dateien

Standardmäßig erstellt der Veröffentlichungsprozess eine frameworkabhängige Bereitstellung, bei der es sich um einen Bereitstellungstyp handelt, auf dem die veröffentlichte Anwendung auf einem Computer ausgeführt wird, auf dem die .NET-Laufzeit installiert ist. Zum Ausführen der veröffentlichten App können Sie die ausführbare Datei verwenden oder den befehl dotnet HelloWorld.dll über eine Eingabeaufforderung ausführen.

In den folgenden Schritten sehen Sie sich die dateien an, die vom Veröffentlichungsprozess erstellt wurden.

Klicken Sie auf der linken Navigationsleiste auf den Explorer.
Erweitern Sie bin/Release/net8.0/publish.

Wie die Abbildung zeigt, enthält die veröffentlichte Ausgabe die folgenden Dateien:
- HelloWorld.deps.json
  
  Dies ist die Laufzeitabhängigkeitsdatei der Anwendung. Sie definiert die .NET-Komponenten und die Bibliotheken (einschließlich der Dynamic Link Library, die Ihre Anwendung enthält), die zum Ausführen der App erforderlich sind. Weitere Informationen finden Sie unter Konfigurationsdateien der Runtime.
- HelloWorld.dll
  
  Dies ist die frameworkabhängige Bereitstellungsversion der Anwendung. Um diese Dynamic Link Library (DLL) auszuführen, geben Sie an einer Eingabeaufforderung dotnet HelloWorld.dll ein. Diese Methode zum Ausführen der App funktioniert auf jeder Plattform, auf der die .NET-Laufzeit installiert ist.
- HelloWorld.exe (HelloWorld unter Linux oder macOS.)
  
  Dies ist die frameworkabhängige ausführbare Dateiversion der Anwendung. Die Datei ist betriebssystemspezifisch.
- HelloWorld.pdb (optional für die Bereitstellung)
  
  Dies ist die Debugsymboldatei. Sie müssen diese Datei nicht zusammen mit Ihrer Anwendung bereitstellen, obwohl Sie sie speichern sollten, wenn Sie die veröffentlichte Version Ihrer Anwendung debuggen müssen.
- HelloWorld.runtimeconfig.json
  
  Dies ist die Laufzeitkonfigurationsdatei der Anwendung. Diese Datei identifiziert die Version von .NET, für die Ihre Anwendung erstellt wurde. Sie können ihr auch Konfigurationsoptionen hinzufügen. Weitere Informationen finden Sie unter Konfigurationseinstellungen für die .NET-Runtime.

Ausführen der veröffentlichten App

Klicken Sie im Explorer mit der rechten Maustaste auf den Ordner publish (unter macOS klicken Sie bei gedrückter CTRL-Taste darauf), und wählen Sie Im integrierten Terminal öffnen aus.
Führen Sie die App unter Windows und Linux mithilfe der ausführbaren Datei aus.
1. Geben Sie unter Windows .\HelloWorld.exe ein, und drücken Sie Enter.
2. ** Geben Sie unter Linux ./HelloWorld ein, und drücken Sie Enter.
3. Geben Sie als Antwort auf die Eingabeaufforderung einen Namen ein, und drücken Sie die Eingabetaste zum Beenden.
Führen Sie die App auf einer beliebigen Plattform mit dem Befehl dotnet aus:
1. Geben Sie dotnet HelloWorld.dll ein, und drücken Sie die EINGABETASTE.
2. Geben Sie als Antwort auf die Eingabeaufforderung einen Namen ein, und drücken Sie die Eingabetaste zum Beenden.

Weitere Ressourcen

Nächste Schritte

In diesem Tutorial haben Sie eine Konsolen-App veröffentlicht. Im nächsten Tutorial erstellen Sie eine Klassenbibliothek.

Erstellen einer .NET-Klassenbibliothek mit Visual Studio Code

Freigeben über