Verwenden des Windows-App SDK in einem vorhandenen Projekt

Wenn Sie über ein WPF-, WinForms- oder Win32-Desktopprojekt verfügen, in dem Sie Features des Windows App SDK verwenden möchten, können Sie das Windows App SDK NuGet-Paket in Ihrem Projekt installieren.

Voraussetzungen

Bevor Sie das Windows App SDK NuGet-Paket in Ihrer App installieren und verwenden, stellen Sie sicher, dass diese Anforderungen erfüllt sind:

Anweisungen

  1. Öffnen Sie ein vorhandenes WPF-, WinForms- oder Win32-Projekt in Visual Studio. Stellen Sie sicher, dass sie für Call Windows-Runtime-APIs konfiguriert ist.

  2. Öffnen Sie in Visual Studio die NuGet-Paket-Manager:

    1. Klicken Sie auf Tools > NuGet Paket-Manager > NuGet-Pakete für Lösung verwalten... .
      –ODER–
    2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Manage NuGet Packages for Solution... .

  3. Wählen Sie im Fenster NuGet Paket-Manager die Registerkarte Browse aus, und suchen Sie nach dem folgenden Paket:

    • Microsoft. WindowsAppSDK.

  4. Nachdem Sie das entsprechende Windows App SDK NuGet-Paket gefunden haben, aktivieren Sie das Paket, aktivieren Sie das Kontrollkästchen im rechten Bereich des NuGet Paket-Manager Fensters neben dem Projekt, in dem Sie das Paket installieren möchten, und klicken Sie dann auf Install.

    Screenshot des Windows App SDK NuGet-Pakets, das installiert wird

    Hinweis

    Das NuGet-Paket des Windows App SDK enthält weitere Unterpakete (einschließlich Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI und andere), die die Implementierungen für bestimmte Komponenten im Windows App SDK enthalten. Im Allgemeinen wird empfohlen, das Hauptpaket Windows App SDK NuGet zu installieren, das alle Komponenten enthält. In einigen Fällen können Sie ein Unterpaket einzeln installieren, um nur auf bestimmte Komponenten in Ihrem Projekt zu verweisen. Siehe z. B. Installieren und bereitstellen Windows ML.

Weitere Schritte für entpackte Apps

Wenn Ihre App entpackt ist (wie es bei Desktop-Apps standardmäßig der Fall ist), sind einige zusätzliche Schritte erforderlich, um das Windows-App-SDK zu verwenden.

Weitere Informationen zu den verpackten und entpackten Begriffen finden Sie unter "Packaging overview".

1. Installieren Sie die Windows App SDK Runtime

Die Windows App SDK Runtime muss auf jedem Computer installiert werden, auf dem die App ausgeführt wird.

Für Ihren Entwicklungscomputer empfehlen wir, Latest Windows App SDK Downloads zu besuchen und dann beides herunterzuladen, zu entzippen und auszuführen:

  • Die neueste stabile Version unter Runtime-Downloads.
  • Ein Versions- und Veröffentlichungskanal der Laufzeit, der mit der Version und dem Veröffentlichungskanal des Microsoft.WindowsAppSDK NuGet-Pakets übereinstimmt, das Sie installiert haben.

Wählen Sie die entsprechende Installationsprogrammoption für die Architektur Ihres Computers aus.

Wichtig

Wenn Ihre App bereitgestellt wird, sind Sie für die Bereitstellung erforderlicher Windows App SDK Laufzeitpakete für Ihre Endbenutzer verantwortlich. Weitere Informationen finden Sie im Windows App SDK Bereitstellungshandbuch für frameworkabhängige Apps, die mit externem Speicherort verpackt sind oder entpackt sind.

2. Initialisieren der Windows App SDK Runtime

Standardmäßig wird eine WPF-, WinForms- oder Win32-Desktop-App entpackt. Eine entpackte App muss die Windows App SDK-Laufzeit initialisieren, bevor Sie ein anderes Feature des Windows App SDK verwenden.

Sie können dies automatisch durchführen, wenn Ihre App über die automatische Initialisierung gestartet wird.

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihren project, und wählen Sie Edit Project File aus.

  2. Innerhalb des PropertyGroup-Elements fügen Sie ein WindowsPackageType-Element hinzu, das auf None eingestellt ist.

<WindowsPackageType>None</WindowsPackageType>

Wenn Sie Ihr Projekt erstellen, werden diese Dateien zu Ihrem Projekt in Visual Studio hinzugefügt:

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Bearbeiten Sie Ihre CXPROJ-Datei manuell.

  2. Innerhalb des <PropertyGroup Label="Globals">-Elements fügen Sie ein auf None eingestelltes WindowsPackageType-Element hinzu.

<WindowsPackageType>None</WindowsPackageType>

Hinweis

Wenn Sie erweiterte Anforderungen haben (z. B. benutzerdefinierte Fehlerbehandlung oder zum Laden einer bestimmten Version des Windows App SDK), können Sie die Bootstrapper-API explizit aufrufen, anstatt die Auto-Initialisierung zu verwenden. Weitere Informationen finden Sie unter Verwenden Sie die Windows App SDK-Laufzeit für Apps, die mit externem Speicherort verpackt oder entpackt sind und Tutorial: Verwenden Sie die Bootstrapper-API in einer App, die mit externem Speicherort verpackt oder entpackt ist und das Windows App SDK verwendet.

Weitere Informationen

Wenn beim Versuch, eine Komponente des Windows App SDK zu verwenden, ein Fehler "Klasse nicht registriert " auftritt, müssen Sie ihrem Projekt möglicherweise eine dynamische Abhängigkeit vom Windows App SDK Framework-Paket hinzufügen. Weitere Informationen finden Sie unter MSIX-Frameworkpakete und dynamische Abhängigkeiten.

Siehe auch

  • Last updated on