Tutoriel : Utiliser l’API du programme de démarrage dans une application empaquetée avec un emplacement externe ou non empaquetée qui utilise le SDK d’application Windows

Suivez ces instructions pour configurer un projet WinUI 3 C# empaqueté avec un emplacement externe ou non empaqueté.

1. Dans Visual Studio, créez un projet d’application console C#. Nommez le projet DynamicDependenciesTest. Après avoir créé le projet, vous devez avoir un « Hello, World ! » Application console C#.

2. Configurez ensuite votre projet.

   1. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur votre projet et choisissez Modifier le fichier de projet.
   2. Remplacez la valeur de l'élément TargetFramework par un moniker Target Framework. Par exemple, utilisez ce qui suit si votre application cible Windows 10, version 2004.

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

   1. Enregistrez et fermez le fichier projet.

3. Changez la plateforme de votre solution en x64. La valeur par défaut dans un projet .NET est AnyCPU, mais WinUI 3 ne prend pas en charge cette plate-forme.

   1. Sélectionnez Build>Gestionnaire de configuration.
   2. Sélectionnez la liste déroulante sous Plate-forme de solution active et cliquez sur Nouveau pour ouvrir la boîte de dialogue Nouvelle plate-forme de solution.
   3. Dans la liste déroulante sous Type ou sélection de la nouvelle plate-forme, sélectionnez x64.
   4. Cliquez sur OK pour fermer la boîte de dialogue Nouvelle plate-forme de solution.
   5. Dans Configuration Manager, cliquez sur Fermer.

4. Installez le package NuGet SDK d'application Windows dans votre projet.

   1. Dans l'explorateur de solutions, cliquez avec le bouton droit de la souris sur le nœud Dépendances et choisissez Gérer les packages Nuget.
   2. Dans la fenêtre NuGet Gestionnaire de package, sélectionnez l’onglet Parcourir et installez le package Microsoft.WindowsAppSDK.

5. Vous êtes maintenant prêt à utiliser l’API de programme d’amorçage (voir Utiliser le runtime du Kit de développement logiciel (SDK) d’application Windows pour les applications empaquetées à l’aide d’un emplacement externe ou non empaquetées) pour prendre dynamiquement une dépendance sur le package d’infrastructure du Kit de développement logiciel (SDK) d’application Windows. Cela vous permet d'utiliser les API du SDK d'application Windows dans votre application.

   Ouvrez le fichier de code Program.cs et remplacez le code par défaut par le code suivant pour appeler la méthode Bootstrap.Initialize pour initialiser le programme d’amorçage. Ce code définit la version du Kit de développement logiciel (SDK) d’application Windows dont dépend l’application lors de l’initialisation du programme d’amorçage.

   Important

   Vous devez modifier le code ci-dessous pour répondre à votre configuration spécifique. Consultez les descriptions des paramètres de la méthode Bootstrap.Initialize afin de pouvoir spécifier l’une des versions du Kit de développement logiciel (SDK) d’application Windows que vous avez installée.

   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();
           }
       }
   }
   

   À sa racine, l’API de programme d’amorçage est une API C/C++ native qui vous permet d’utiliser les API du SDK d’application Windows dans votre application. Toutefois, dans une application .NET qui utilise le Kit de développement logiciel (SDK) d’application Windows 1.0 ou version ultérieure, vous pouvez utiliser le wrapper .NET pour l’API de démarrage. Ce wrapper offre un moyen plus simple d’appeler l’API de programme d’amorçage dans une application .NET que d’appeler directement les fonctions C/C++ natives. L’exemple de code précédent appelle les méthodes Statiques Initialize et Shutdown de la classe Bootstrap dans le wrapper .NET pour l’API de démarrage.

6. Pour démontrer que les composants d'exécution du SDK d'application Windows ont été chargés correctement, ajoutez du code qui utilise la classe ResourceManager du SDK d'application Windows pour charger une ressource de type chaîne.

   1. Ajoutez un nouveau fichier de ressources (.resw) à votre projet (laissez le nom par défaut).

   2. Le fichier de ressources étant ouvert dans l’éditeur, créez une nouvelle ressource de type chaîne avec les propriétés suivantes.

      • Nom : Message
      • Valeur : Bonjour, ressources!

   3. Enregistrez le fichier de ressources.

   4. Ouvrez le fichier de code Program.cs et remplacez la Console.WriteLine("Hello, World!"); ligne par le code suivant.

   // 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. Cliquez sur Démarrer sans débogage (ou Démarrer le débogage) pour générer et exécuter votre application. Vous devriez voir la chaîne Hello, resources! s'afficher avec succès.

Suivez ces instructions pour configurer un projet WinUI 3 C++ empaqueté avec un emplacement externe ou non empaqueté.

1. Dans Visual Studio, créez un nouveau projet C++ Console App. Nommez le projet DynamicDependenciesTest.

   

   Après avoir créé le projet, vous devez avoir un « Hello, World ! » Application console C++.

2. Ensuite, installez le package NuGet SDK d'application Windows dans votre projet.

   1. Dans l'Explorateur de solutions, cliquez avec le bouton droit de la souris sur le nœud Références et choisissez Gérer les packages Nuget.
   2. Dans la fenêtre NuGet Gestionnaire de package, sélectionnez l’onglet Parcourir et recherchez Microsoft.WindowsAppSDK.

3. Vous êtes maintenant prêt à utiliser l’API de programme d’amorçage (voir Utiliser le runtime du Kit de développement logiciel (SDK) d’application Windows pour les applications empaquetées avec un emplacement externe ou non empaqueté) pour initialiser le runtime du Kit de développement logiciel (SDK) d’application Windows dans votre application. Cela vous permet d’utiliser les API du Kit de développement logiciel (SDK) d’application Windows dans l’application.

   1. Ajoutez les fichiers include suivants au début de votre fichier DynamicDependenciesTest.cpp. L'en-tête mddbootstrap.h est disponible via le package NuGet SDK d'application Windows.

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

   1. Ensuite, ajoutez ce code au début de votre méthode principale pour appeler la fonction MddBootstrapInitialize pour initialiser le programme d’amorçage et gérer toutes les erreurs. Ce code définit la version du Kit de développement logiciel (SDK) d’application Windows dont dépend l’application lors de l’initialisation du programme d’amorçage.

   Important

   Vous devez modifier le code ci-dessous pour répondre à votre configuration spécifique. Consultez les descriptions des paramètres de la fonction MddBootstrapInitialize afin de pouvoir spécifier l’une des versions du Kit de développement logiciel (SDK) d’application Windows que vous avez installée.

   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. Enfin, ajoutez ce code pour afficher la chaîne Hello, World! et appeler la fonction MddBootstrapShutdown pour annuler l’initialisation du programme d’amorçage.

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

   1. Votre code final doit ressembler à ceci :

   #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. Cliquez sur Démarrer sans débogage (ou Démarrer le débogage) pour générer et exécuter votre application.