Einrichten Ihrer Desktopanwendung für das Verpacken mit MSIX in Visual Studio

• Wenn es sich bei der Desktop-App um eine WinUI 3-App handelt, finden Sie weitere Informationen unter Verpacken Ihrer App mithilfe von MSIX mit nur einem Projekt. Bei einer WinUI-3-App handelt es sich um eine App, die das Framework der Windows-UI-Bibliothek (WinUI) 3 für die Benutzeroberfläche und das Windows App SDK nutzt.
• Für alle anderen Arten von Desktop-Apps können Sie jedoch die Lektüre dieses Themas fortsetzen.

Du kannst das Paketerstellungsprojekt für Windows-Anwendungen in Visual Studio verwenden, um ein Paket für deine Desktop-App zu generieren. Anschließend kannst du dein Paket an den Microsoft Store, im Web, in deinem Unternehmen oder in einem anderen von dir verwendeten Verteilungsmechanismus verteilen.

Erforderliche Visual Studio-Version und -Workload

Das Paketerstellungsprojekt für Windows-Anwendungen ist in Visual Studio 2017 15.5 und höher verfügbar.

Um die Vorlage „Paketerstellungsprojekt für Windows-Anwendungen“ im Menü „Neues Projekt hinzufügen“ anzuzeigen, musst du dich vergewissern, dass mindestens eine der folgenden Visual Studio-Workloads installiert ist:

• Die Workload „Entwicklung für die universelle Windows-Plattform“
• Die optionale Komponente „MSIX-Verpackungstools“ in der NET Core-Workload.
• Die optionale Komponente „MSIX-Verpackungstool“ in der Workload für die .NET-Desktopentwicklung.

Es wird empfohlen, die neueste Visual Studio-Version zu verwenden, um die besten Ergebnisse zu erzielen.

Wichtig

Das Paketerstellungsprojekt für Windows-Anwendungen in Visual Studio wird unter Windows 10, Version 1607 und höher, unterstützt. Es kann nur in Projekten verwendet werden, die auf Windows 10 Anniversary Update (10.0; Build 14393) oder eine höhere Version ausgerichtet sind.

Hier folgen einige andere Schritte, die du aus dem Anwendungsverpackungsprojekt in Visual Studio ausführen kannst:

✔️ Automatisches Generieren von visuellen Ressourcen

✔️ Vornehmen von Änderungen am Manifest mit einem visuellen Designer

✔️ Generieren oder Bündeln des Pakets mithilfe eines Assistenten

✔️ (Bei der Veröffentlichung im Microsoft Store) Einfaches Zuweisen einer Identität für deine Anwendung aus einem Namen, den du bereits im Partner Center reserviert hast

Vorbereiten der Anwendung

Lesen Sie die folgende Anleitung, bevor Sie mit der Paketerstellung für Ihre Anwendung beginnen: Vorbereiten des Verpackens einer Desktopanwendung.

Einrichten des Paketerstellungsprojekts für Windows-Anwendungen in Ihrer Projektmappe

1. Öffne in Visual Studio die Projektmappe mit deinem Desktopanwendungsprojekt.

Hinweis

Wenn Sie das Projekt in der x64-Konfiguration verpacken möchten, stellen Sie sicher, dass Sie das referenzierte Projekt für x64 konfiguriert haben. Weitere Informationen zur Bestätigung finden Sie nachfolgend unter [Weitere Hinweise](#Weitere Hinweise).

1. Fügen Sie der Projektmappe ein Paketerstellungsprojekt für Windows-Anwendungen hinzu, und wählen Sie die entsprechende Sprache (C# oder C++) aus, die der Sprache des vorhandenen Deskstop-App-Projekts entspricht.

   Dem Paketerstellungsprojekt müssen Sie keinen Code hinzufügen. Dessen Zweck besteht lediglich darin, ein Paket für Sie zu generieren und zu konfigurieren. Wir bezeichnen das Projekt als Paketerstellungsprojekt.

   

2. Lege die Zielversion des Projekts auf eine beliebige Version fest, stelle jedoch sicher, dass die Mindestens erforderliche Version nicht auf eine frühere Version als Windows 10 Anniversary Update festgelegt ist.

   

3. Legen Sie das Paketerstellungsprojekt für Windows-Anwendungen als Startprojekt fest (klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie Als Startprojekt festlegen aus).

4. Klicke im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner Abhängigkeiten unter dem Paketprojekt, und wähle dann Projektverweis hinzufügen... aus.

   

5. Wähle dein Desktopanwendungsprojekt aus und klicke dann auf die Schaltfläche OK.

   

   Du kannst mehrere Desktopanwendungen im Paket miteinbeziehen, aber nur eines kann gestartet werden, wenn Benutzer deine App-Kachel auswählen. Klicke mit der rechten Maustaste im Knoten Anwendungen auf die Anwendung, die die Benutzer starten sollen, wenn sie die App-Kachel auswählen, und wähle dann Als Einstiegspunkt festlegen aus.

   

6. Erstelle das Paketprojekt, um sicherzustellen, dass keine Fehler angezeigt werden. Wenn Fehler auftreten, öffne den Konfigurationsmanager und stelle sicher, dass deine Projekte auf dieselbe Plattform ausgerichtet sind.

   

7. Verwende den Assistenten App-Pakete erstellen, um ein MSIX-Paket/-Bündel oder eine .msixupload-/.appxupload-Datei (für die Veröffentlichung im Microsoft Store) zu erstellen.

Zusätzliche Hinweise

Führen Sie zum Erstellen von WAP für die x64-Plattform einen der folgenden Schritte aus:

1. Ansatz: Fügen Sie vor dem Hinzufügen des WAP-Projekts zu einem Projekt die x64-Architektur über den Konfigurations-Manager hinzu (wie im folgenden Screenshot dargestellt).

2. Ansatz: Für die vorhandenen Projekte, in denen WAP hinzugefügt wurde, gehen Sie wie folgt vor:

1. Entfernen Sie die x64-Einträge manuell aus SLN-Dateien.

_Global_
_GlobalSection(SolutionConfigurationPlatforms) = preSolution_
_Debug|Any CPU = Debug|Any CPU_
_Debug|ARM = Debug|ARM_
_Debug|ARM64 = Debug|ARM64_ (remove)
_Debug|x64 = Debug|x64_ (remove)
_Debug|x86 = Debug|x86_
_Release|Any CPU = Release|Any CPU_
_Release|ARM = Release|ARM_
_Release|ARM64 = Release|ARM64_ (remove)
_Release|x64 = Release|x64_ (remove)
_Release|x86 = Release|x86"_

2. Fügen Sie nach dem 1. Schritt x64-Konfigurationen über den Konfigurations-Manager hinzu.

Nächste Schritte

Verpacken einer Desktop-App mit Visual Studio

Weitere Informationen findest du unter Verpacken einer Desktop- oder UWP-App mit Visual Studio.

Ausführen, Debuggen oder Testen der Desktopanwendung

Weitere Informationen findest du unter Ausführen, Debuggen und Testen einer verpackten Anwendung

Zusätzliche Ressourcen

Verbessern der Desktopanwendung durch Hinzufügen von UWP-APIs

Weitere Informationen findest du unter Verbessern der Desktopanwendung für Windows 10

Erweitern der Desktopanwendung durch Hinzufügen von UWP-Projekten und Komponenten für Windows-Runtime

Weitere Informationen findest du unter Erweitern der Desktopanwendung mit modernen UWP-Komponenten.

Verteilen der App

Weitere Informationen findest du unter Verteilen einer verpackten Desktopanwendung.