Tutoriel : Utiliser l’API de démarreur dans une application empaquetée avec une location externe ou une application sans emballage utilisant le Windows App SDK

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

1. Dans Visual Studio, créez une application C# Console App project. Nommez le project DynamicDependenciesTest. Après avoir créé le project, vous devez disposer d’une application console C# « Hello, World ! ».

2. Ensuite, configurez votre project.

   1. Dans Solution Explorer, cliquez avec le bouton droit sur votre project et choisissez Edit Project Fichier.
   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>net8.0-windows10.0.19041.0</TargetFramework>
   

   1. Enregistrez et fermez le fichier project.

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

   1. Sélectionnez Build>Configuration Manager.
   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 Close.

4. Installez le package NuGet Windows App SDK dans votre project.

   1. Dans Solution Explorer, cliquez avec le bouton droit sur le nœud Dependencies et choisissez Manage Nuget Packages.
   2. Dans la fenêtre NuGet Package Manager, sélectionnez l’onglet Browse, puis installez le package Microsoft.WindowsAppSDK.

5. Vous êtes maintenant prêt à utiliser l'API de bootstrapper (voir Utilisez le runtime Windows App SDK pour les applications emballées avec un emplacement externe ou non emballées) pour établir dynamiquement une dépendance envers le package framework Windows App SDK. Cela vous permet d’utiliser les API Windows App SDK 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 Windows App SDK dont l'application dépend lors de l'initialisation du bootstrap.

   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 de la Windows App SDK que vous avez installées.

   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 démarrage est une API C/C++ native qui vous permet d’utiliser les API Windows App SDK dans votre application. Toutefois, dans une application .NET qui utilise le Windows App SDK 1.0 ou version ultérieure, vous pouvez utiliser le wrapper .NET pour l’API de démarrage. Ce wrapper permet d’appeler plus facilement 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 l'enveloppe .NET pour l'API d'amorçage.

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

   1. Ajoutez un nouveau fichier Resources (.resw) à votre project (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 correctement.

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

1. Dans Visual Studio, créez une application C++ Console App project. Nommez le project DynamicDependenciesTest.

   

   Après avoir créé le project, vous devez disposer d’une application console « Hello, World ! » C++.

2. Ensuite, installez le package NuGet Windows App SDK dans votre project.

   1. Dans Solution Explorer, cliquez avec le bouton droit sur le nœud References et choisissez Manage Nuget Packages.
   2. Dans la fenêtre NuGet Package Manager, sélectionnez l’onglet Browse et recherchez Microsoft.WindowsAppSDK.

3. Vous pouvez maintenant utiliser l'API du programme de démarrage (voir Utiliser l'environnement d'exécution Windows App SDK pour les applications empaquetées avec un emplacement externe ou non empaquetées) pour initialiser l'environnement d'exécution Windows App SDK dans votre application. Cela vous permet d’utiliser les API Windows App SDK 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 Windows App SDK.

   #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 Windows App SDK dont l'application dépend lors de l'initialisation du bootstrap.

   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 de la Windows App SDK 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 désinitialiser le bootstrapper.

   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.