Visual Studio Installer Projects-Erweiterung und .NET

  • Artikel

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

Dieser Artikel bezieht sich auf Apps für .NET Core 3.1 und .NET 5 oder 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

  • Um die richtige Ausgabe für .NET Core 3.1- und .NET 5.0- oder höher-Projekte zu erhalten, wählen Sie " Elemente veröffentlichen" anstelle der primären Ausgabe im Dialogfeld "Projektausgabegruppe hinzufügen" aus. Um dieses Dialogfeld zu öffnen, wählen Sie "Projektausgabe hinzufügen>... aus dem Kontextmenü des Setupprojekts" aus.

    Die Ausgabegruppe „Elemente veröffentlichen“ im Dialogfeld „Projektausgabegruppe hinzufügen“

  • Um ein eigenständiges Installationsprogramm zu erstellen, legen Sie die PublishProfilePath-Eigenschaft im Knoten "Publish Items " im Setup-Projekt mithilfe des relativen Pfads eines Veröffentlichungsprofils fest, wobei die richtigen Eigenschaften festgelegt sind.

    Screenshot, der zeigt, wie das Veröffentlichungsprofil für das Ausgabeelement

    Screenshot der Einstellung des Veröffentlichungsprofils für das Ausgabeelement

    Bevor Sie diese Eigenschaft festlegen können, erstellen Sie ein Veröffentlichungsprofil aus dem Anwendungsprojekt, indem Sie im Kontextmenü des Anwendungsprojekts in Projektmappen-Explorer veröffentlichen und die Anwendung in einem Ordner bereitstellen.

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-Elemente im Dialogfeld „Voraussetzungen“

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

Hinweis

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

Zugehöriger Inhalt