Esercitazione: Usare l'API del bootstrapper in un'app confezionata con percorso esterno o non confezionata che utilizza il Windows App SDK

Seguire queste istruzioni per configurare un progetto WinUI C# impacchettato con pacchetto esterno o non impacchettato.

1. In Visual Studio creare una nuova app C# Console App project. Denominare project DynamicDependenciesTest. Dopo aver creato il project, è necessario avere un'app console C# "Hello, World!".

2. Configurare quindi il project.

   1. In Solution Explorer fare clic con il pulsante destro del mouse sul project e scegliere Edit Project File.
   2. Sostituire il valore dell'elemento TargetFramework con un Moniker di destinazione Framework. Ad esempio, usare quanto segue se l'app è destinata Windows 10 versione 2004.

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

   1. Salvare e chiudere il file project.

3. Modificare la piattaforma della tua soluzione in x64. Il valore predefinito in un .NET project è AnyCPU, ma WinUI non supporta tale piattaforma.

   1. Selezionare Build>Configuration Manager.
   2. Selezionare l'elenco a discesa sotto Piattaforma soluzione attiva e fare clic su Nuovo per aprire la finestra di dialogo Nuova piattaforma soluzione.
   3. Nella casella a discesa, alla voce Digita o seleziona la nuova piattaforma, selezionare x64.
   4. Scegliere OK per chiudere la finestra di dialogo Piattaforma di nuova soluzione.
   5. In Configuration Manager fare clic su Close.

4. Installare il pacchetto NuGet Windows App SDK nel project.

   1. In Solution Explorer fare clic con il pulsante destro del mouse sul nodo Dependencies e scegliere Gestisci pacchetti NuGet.
   2. Nella finestra NuGet Package Manager selezionare la scheda Browse e installare il pacchetto Microsoft.WindowsAppSDK.

5. A questo punto è possibile usare l'API del programma di avvio automatico (vedere Usare il runtime di Windows App SDK per le app in pacchetto con percorso esterno o senza pacchetti) per assumere in modo dinamico una dipendenza dal pacchetto del framework Windows App SDK. In questo modo puoi usare le API Windows App SDK nella tua app.

   Aprire il file di codice Program.cs e sostituire il codice predefinito con il codice seguente per richiamare il metodo Bootstrap.Initialize per inizializzare il programma di avvio automatico. Questo codice definisce quale versione del Windows App SDK da cui l'app dipende al momento dell'inizializzazione del programma di avvio automatico.

   Importante

   Sarà necessario modificare il codice seguente in base alla configurazione specifica. Vedere le descrizioni dei parametri del metodo Bootstrap.Initialize in modo da poter specificare una delle versioni del Windows App SDK installate.

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

   Alla radice, l'API del programma di avvio automatico è un'API C/C++ nativa che consente di usare le API Windows App SDK nell'app. In un'app .NET che usa il Windows App SDK 1.0 o versione successiva, è possibile usare il wrapper .NET per l'API del programma di avvio automatico. Questo wrapper offre un modo più semplice per chiamare l'API del programma di avvio automatico in un'app .NET rispetto alla chiamata diretta delle funzioni C/C++ native. Nell'esempio di codice precedente vengono chiamati i metodi Initialize e Shutdown della classe Bootstrap nella classe .NET wrapper per l'API del programma di avvio automatico.

6. Per dimostrare che i componenti di runtime Windows App SDK sono stati caricati correttamente, aggiungere codice che usa la classe ResourceManager nella Windows App SDK per caricare una risorsa stringa.

   1. Aggiungere un nuovo file Resources (con estensione resw) al project (lasciare il nome predefinito).

   2. Con il file di risorse aperto nell'editor, creare una nuova risorsa di stringa con le proprietà seguenti.

      • Nome: Messaggio
      • Valore: Hello, resources!

   3. Salvare il file di risorse.

   4. Aprire il file del codice Program.cs e sostituire l'intero contenuto con il codice seguente Console.WriteLine("Hello, World!");.

   // 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. Fare clic su Avvia senza eseguire debug (o Avvia debug) per compilare ed eseguire l'app. Verrà visualizzata correttamente la stringa Hello, resources! .

Segui queste istruzioni per configurare un progetto WinUI C++ confezionato con percorso esterno o non confezionato.

1. In Visual Studio, creare un nuovo progetto C++ Console App. Denominare project DynamicDependenciesTest.

   

   Dopo aver creato il project, è necessario avere un'app console C++ "Hello, World!".

2. Installare quindi il pacchetto NuGet Windows App SDK nel project.

   1. In Solution Explorer fare clic con il pulsante destro del mouse sul nodo References e scegliere Gestisci pacchetti NuGet.
   2. Nella finestra NuGet Package Manager selezionare la scheda Browse e cercare Microsoft.WindowsAppSDK.

3. A questo punto è possibile utilizzare l'API del bootstrapper (vedere Usare il runtime di Windows App SDK per le app confezionate con percorso esterno o non confezionate) per inizializzare il runtime di Windows App SDK nella tua app. In questo modo è possibile usare le API Windows App SDK nell'app.

   1. Aggiungere i file di inclusione seguenti all'inizio del file DynamicDependenciesTest.cpp . L'intestazione mddbootstrap.h è disponibile tramite il pacchetto NuGet Windows App SDK.

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

   1. Aggiungere quindi questo codice all'inizio del metodo main per richiamare la funzione MddBootstrapInitialize in modo da inizializzare il programma di avvio automatico e gestire eventuali errori. Questo codice definisce di quale versione di Windows App SDK l'app dipende, quando inizializza il programma di avvio.

   Importante

   Sarà necessario modificare il codice seguente in base alla configurazione specifica. Vedere le descrizioni dei parametri della funzione MddBootstrapInitialize in modo da poter specificare una delle versioni del Windows App SDK installato.

   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. Aggiungere infine questo codice per visualizzare la stringa Hello, World! e richiamare la funzione MddBootstrapShutdown per annullare l'inizializzazione del programma di avvio automatico.

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

   1. Il codice finale avrà un aspetto simile al seguente.

   #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. Fare clic su Avvia senza eseguire debug (o Avvia debug) per compilare ed eseguire l'app.