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

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 Esplora soluzioni 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>Gestione configurazione.
   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 Gestione configurazione fare clic su Close.

4. Installare il pacchetto NuGet SDK per app di Windows nel project.

   1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo Dependencies e scegliere Gestisci pacchetti NuGet.
   2. Nella finestra NuGet Gestione pacchetti 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 SDK per app di Windows per le app in pacchetto con percorso esterno o senza pacchetti) per assumere in modo dinamico una dipendenza dal pacchetto del framework SDK per app di Windows. In questo modo puoi usare le API SDK per app di Windows 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 SDK per app di Windows 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 SDK per app di Windows 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 SDK per app di Windows nell'app. In un'app .NET che usa il SDK per app di Windows 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 SDK per app di Windows sono stati caricati correttamente, aggiungere codice che usa la classe ResourceManager nella SDK per app di Windows 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 SDK per app di Windows nel project.

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

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

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

   #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 quale versione del SDK per app di Windows 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 della funzione MddBootstrapInitialize in modo da poter specificare una delle versioni del SDK per app di Windows 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.