Visual Studio Installer Projects-Erweiterung und .NET

Das Packen von Anwendungen als MSI erfolgt häufig mithilfe der Projects-Erweiterung des Visual Studio-Installers.

Dieser Artikel gilt für Apps für .NET Core 3.1, .NET 5, .NET 6 und höher.

Sie können die Erweiterung hier herunterladen:

Update für .NET Core und .NET

.NET Core und .NET 5+ verfügen über zwei verschiedene Modelle für die Veröffentlichung.

  • Frameworkabhängige Bereitstellungen

  • Eigenständige Anwendungen enthalten die Runtime.

Weitere Informationen zu diesen Bereitstellungsstrategien finden Sie unter Übersicht über die .NET-Anwendungsveröffentlichung.

Erstellen eines Setup-Projekts

  1. Wählen Sie in Visual Studio Erweiterungen>Erweiterungen verwalten aus, und suchen Sie nach "Visual Studio-Installer Projects". Oder laden Sie die Erweiterung direkt aus Marketplace herunter.

  2. Wählen Sie im Startfenster die Option Neues Projekt erstellen aus, und geben Sie dann „setup“ in das Suchfeld ein. Wählen Sie ein Setupprojekt aus, und befolgen Sie die Anweisungen.

    Ein ausführliches Beispiel für die Erstellung eines Setup-Projekts finden Sie unter Walkthrough: Bereitstellen einer Windows-basierten Anwendung.

    Allgemeine Informationen zu Setup-Projekten (*.vsproj) finden Sie unter Setup and Deployment projects.

    Weitere Informationen zu Bereitstellungseigenschaften finden Sie unter Bereitstellungseigenschaften.

Workflowänderungen für .NET Core 3.1 und .NET 5 oder höher

  1. Wählen Sie Elemente veröffentlichen anstelle von Primäre Ausgabe aus, um die richtige Ausgabe für Projekte für .NET Core 3.1 und NET 5.0 oder höher zu erhalten. Um dieses Dialogfeld zu öffnen, wählen Sie im Kontextmenü des ProjektsHinzufügen>Projektausgabe... aus.

    The Publish Items output group in the Add Project Output Group dialog

  2. Um ein eigenständiges Installationsprogramm zu erstellen, legen Sie die PublishProfilePath-Eigenschaft für den Knoten Elemente veröffentlichen im Setupprojekt fest, indem Sie den relativen Pfad eines Veröffentlichungsprofils mit den richtigen Eigenschaften verwenden.

    Setting the publish profile on the Publish Items project output item

Hinweis

Dieser Workflow wird nicht für ASP.NET Core-Anwendungen unterstützt, sondern nur Für Windows-Desktopanwendungen.

Voraussetzungen

Wenn Sie möchten, dass Ihr Installationsprogramm die erforderliche Runtime für eine frameworkabhängige .NET Core 3.1- oder .NET 5.0+--App installieren kann, können Sie dies mithilfe der Voraussetzungen erreichen. Öffnen Sie im Eigenschaftendialogfeld Ihres Installationsprogrammprojekts das Dialogfeld Voraussetzungen.... Die folgenden Einträge werden angezeigt:

.NET Core items in the Prerequisites dialog

Die Option .NET Core-Runtime... sollte für Konsolenanwendungen ausgewählt sein, .NET Desktop-Runtime... für WPF-/WinForms-Anwendungen.

Hinweis

Diese Elemente sind ab dem Release Visual Studio 2019 Update 7 vorhanden.