Lernprogramm: Verwenden der Bootstrapper-API in einer App, die mit einem externen Speicherort gepackt oder ohne Verpackung genutzt wird und die Windows App SDK verwendet.

Führen Sie die folgenden Anweisungen aus, um ein C#-WinUI-Projekt zu konfigurieren, das entweder als Paket mit externem Speicherort oder ohne Paket vorliegt.

1. Erstellen Sie in Visual Studio eine neue C#-Console App project. Nennen Sie das Projekt DynamicDependenciesTest. Nachdem Sie das project erstellt haben, sollten Sie über eine C#-Konsolen-App "Hello, World!" verfügen.

2. Konfigurieren Sie als Nächstes Ihr Projekt.

   1. Klicken Sie in Solution Explorer mit der rechten Maustaste auf Ihre project, und wählen Sie Bearbeiten Project Datei aus.
   2. Ersetzen Sie den Wert des TargetFramework-Elements durch einen Zielframework-Moniker. Verwenden Sie beispielsweise Folgendes, wenn Ihre App auf Windows 10 Version 2004 ausgerichtet ist.

   <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
   

   1. Speichern und schließen Sie die project Datei.

3. Ändern Sie die Plattform für Ihre Lösung in x64. Der Standardwert in einem .NET project ist AnyCPU, aber WinUI unterstützt diese Plattform nicht.

   1. Wählen Sie Build>Configuration Manager aus.
   2. Wählen Sie das Dropdownmenü unter Aktive Projektmappenplattform aus, und klicken Sie auf Neu, um das Dialogfeld Neue Projektmappenplattform zu öffnen.
   3. Wählen Sie im Dropdownmenü unter Neue Plattform eingeben oder auswählen die Option x64 aus.
   4. Klicken Sie auf OK, um das Dialogfeld Neue Lösungsplattform zu schließen.
   5. Klicken Sie in Configuration Manager auf Close.

4. Installieren Sie das Windows App SDK NuGet-Paket in Ihrem project.

   1. Klicken Sie in Solution Explorer mit der rechten Maustaste auf den Knoten Dependencies und wählen Sie Manage Nuget Packages aus.
   2. Wählen Sie im Fenster NuGet Package Manager das Browseregister aus, und installieren Sie das Paket Microsoft.WindowsAppSDK.

5. Sie können jetzt die Bootstrapper-API verwenden (siehe Nutzung der Windows App SDK Laufzeit für Apps, die mit externem Speicherort oder entpackt sind), um dynamisch eine Abhängigkeit vom Windows App SDK Frameworkpaket zu übernehmen. Auf diese Weise können Sie die Windows App SDK-APIs in Ihrer App verwenden.

   Öffnen Sie die Program.cs Codedatei, und ersetzen Sie den Standardcode durch den folgenden Code, um die Bootstrap.Initialize-Methode aufzurufen, um den Bootstrapper zu initialisieren. Dieser Code definiert, welche Version der Windows App SDK die App beim Initialisieren des Bootstrappers abhängig ist.

   Wichtig

   Sie müssen den folgenden Code entsprechend Ihrer spezifischen Konfiguration bearbeiten. Lesen Sie die Beschreibungen der Parameter der Bootstrap.InitializeMethode, damit Sie eine der Versionen der Windows App SDK angeben können, die Sie installiert haben.

   using System;
   using Microsoft.Windows.ApplicationModel.DynamicDependency;
   
   namespace DynamicDependenciesTest
   {
       class Program
       {
           static void Main(string[] args)
           {
               Bootstrap.Initialize(0x00010002);
               Console.WriteLine("Hello, World!");
   
               // Release the DDLM and clean up.
               Bootstrap.Shutdown();
           }
       }
   }
   

   Im Kern ist die Bootstrapper-API eine native C/C++-API, mit der Sie die Windows App SDK-APIs in Ihrer App verwenden können. In einer .NET-App, die das Windows App SDK 1.0 oder höher verwendet, können Sie den .NET-Wrapper für die Bootstrapper-API verwenden. Dieser Wrapper bietet eine einfachere Möglichkeit, die Bootstrapper-API in einer .NET-App aufzurufen, als die systemeigenen C/C++-Funktionen direkt aufzurufen. Im vorherigen Codebeispiel werden die statischen Initialize und Shutdown Methoden der Bootstrap Klasse im .NET-Wrapper für die Bootstrapper-API aufgerufen.

6. Um zu veranschaulichen, dass die Windows App SDK Laufzeitkomponenten ordnungsgemäß geladen wurden, fügen Sie Code hinzu, der die klasse ResourceManager Windows App SDK verwendet, um eine Zeichenfolgenressource zu laden.

   1. Fügen Sie Ihrem Projekt eine neue Resources File (.resw) hinzu (behalten Sie den Standardnamen bei).

   2. Wenn die Ressourcendatei im Editor geöffnet ist, erstellen Sie eine neue Zeichenfolgenressource mit den folgenden Eigenschaften.

      • Name: Meldung
      • Wert: Hallo, Ressourcen!

   3. Speichern Sie die Ressourcendatei.

   4. Öffnen Sie die Program.cs Codedatei, und ersetzen Sie die Console.WriteLine("Hello, World!"); Zeile durch den folgenden Code.

   // Create a resource manager using the resource index generated during build.
      var manager = new Microsoft.Windows.ApplicationModel.Resources.ResourceManager("DynamicDependenciesTest.pri");
   
   // Look up a string in the .resw file using its name.
   Console.WriteLine(manager.MainResourceMap.GetValue("Resources/Message").ValueAsString);
   

   1. Klicken Sie auf "Ohne Debuggen starten" (oder starten Sie das Debuggen), um Ihre App zu erstellen und auszuführen. Die Zeichenfolge Hello, resources! sollte erfolgreich angezeigt werden.

Führen Sie die folgenden Anweisungen aus, um ein C++-WinUI-Projekt zu konfigurieren, das entweder mit einem externen Speicherort verpackt oder entpackt ist.

1. Erstellen Sie in Visual Studio eine neue C++-Console App project. Benennen Sie das Projekt DynamicDependenciesTest.

   

   Nachdem Sie das project erstellt haben, sollten Sie über eine C++-Konsolen-App "Hello, World!" verfügen.

2. Installieren Sie als Nächstes das Windows App SDK NuGet-Paket in Ihrem project.

   1. Klicken Sie in Solution Explorer mit der rechten Maustaste auf den Knoten References und wählen Sie Manage Nuget Packages aus.
   2. Wählen Sie im Fenster NuGet Package Manager die Registerkarte Browse aus, und suchen Sie nach Microsoft.WindowsAppSDK.

3. Sie können jetzt die Bootstrapper-API verwenden (siehe Verwendung der Windows App SDK-Laufzeitumgebung für Apps, die mit einem externen Speicherort verpackt oder unverpackt sind), um die Windows App SDK-Laufzeitumgebung in Ihrer App zu initialisieren. Auf diese Weise können Sie die Windows App SDK-APIs in der App verwenden.

   1. Fügen Sie an den Anfang der DynamicDependenciesTest.cpp-Datei die folgenden Include-Dateien hinzu. Der header mdbootstrap.h ist über das Windows App SDK NuGet-Paket verfügbar.

   #include <windows.h>
   #include <MddBootstrap.h>
   

   1. Fügen Sie als Nächstes diesen Code am Anfang der Hauptmethode hinzu, um die MddBootstrapInitialize-Funktion aufzurufen, um den Bootstrapper zu initialisieren und alle Fehler zu behandeln. Dieser Code definiert, welche Version der Windows App SDK die App beim Initialisieren des Bootstrappers abhängig ist.

   Wichtig

   Sie müssen den folgenden Code entsprechend Ihrer spezifischen Konfiguration bearbeiten. Lesen Sie die Beschreibungen der Parameter der Funktion MdBootstrapInitialize, damit Sie eine der Versionen der Windows App SDK angeben können, die Sie installiert haben.

   const UINT32 majorMinorVersion{ 0x00010002 }; 
   PCWSTR versionTag{ L"" }; 
   const PACKAGE_VERSION minVersion{};
   
   const HRESULT hr{ MddBootstrapInitialize(majorMinorVersion, versionTag, minVersion) }; 
   
   // Check the return code for errors. If there is an error, display the result.
   if (FAILED(hr)) 
   { 
       wprintf(L"Error 0x%X in MddBootstrapInitialize(0x%08X, %s, %hu.%hu.%hu.%hu)\n", 
           hr, majorMinorVersion, versionTag, minVersion.Major, minVersion.Minor, minVersion.Build, minVersion.Revision); 
       return hr; 
   } 
   

   1. Fügen Sie abschließend diesen Code hinzu, um die Zeichenfolge Hello, World! anzuzeigen und die MddBootstrapShutdown-Funktion aufzurufen, um den Bootstrapper zu entinitialisieren.

   std::cout << "Hello, World!\n"; 
   
   // Release the DDLM and clean up.
   MddBootstrapShutdown(); 
   

   1. Der resultierende Code sollte wie folgt aussehen:

   #include <iostream> 
   #include <windows.h> 
   #include <MddBootstrap.h>
   
   int main() 
   { 
       // Take a dependency on Windows App SDK Stable.
       const UINT32 majorMinorVersion{ 0x00010002 }; 
       PCWSTR versionTag{ L"" }; 
       const PACKAGE_VERSION minVersion{};
   
       const HRESULT hr{ MddBootstrapInitialize(majorMinorVersion, versionTag, minVersion) }; 
   
       // Check the return code. If there is a failure, display the result.
       if (FAILED(hr)) 
       { 
           wprintf(L"Error 0x%X in MddBootstrapInitialize(0x%08X, %s, %hu.%hu.%hu.%hu)\n", 
               hr, majorMinorVersion, versionTag, minVersion.Major, minVersion.Minor, minVersion.Build, minVersion.Revision); 
           return hr; 
       } 
   
       std::cout << "Hello, World!\n"; 
   
       // Release the DDLM and clean up.
       MddBootstrapShutdown(); 
   } 
   

4. Klicken Sie auf "Ohne Debuggen starten" (oder starten Sie das Debuggen), um Ihre App zu erstellen und auszuführen.