Návod: Použití rozhraní API bootstrapperu v aplikaci zabalené s externí lokací nebo v nebalené aplikaci, která používá Windows App SDK

Podle těchto pokynů nakonfigurujte projekt WinUI jazyka C# zabalený do externího umístění nebo bez balení.

1. Ve Visual Studio vytvořte novou aplikaci C# konzolová aplikace. Pojmenujte project DynamicDependenciesTest. Po vytvoření project byste měli mít konzolovou aplikaci Hello, World! C#.

2. Dále nakonfigurujte project.

   1. V Průzkumník řešení klikněte pravým tlačítkem na project a zvolte Edit Project Soubor.
   2. Nahraďte hodnotu prvku TargetFramework pomocí Target Framework Moniker. Pokud například vaše aplikace cílí na Windows 10 verze 2004, použijte následující kód.

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

   1. Uložte a zavřete soubor project.

3. Změňte platformu pro vaše řešení na x64. Výchozí hodnota v .NET project je AnyCPU, ale WinUI tuto platformu nepodporuje.

   1. Vyberte Build>Správce konfigurace.
   2. V části Aktivní platforma řešení vyberte rozevírací seznam a kliknutím na Tlačítko Nový otevřete dialogové okno Nová platforma řešení .
   3. V rozevíracím seznamu pod položkou zadejte nebo vyberte novou platformu, a poté zvolte x64.
   4. Kliknutím na tlačítko OK zavřete dialogové okno Nová platforma řešení .
   5. V Správce konfigurace klikněte na Close.

4. Nainstalujte balíček NuGet Windows App SDK do svého project.

   1. V Průzkumník řešení klikněte pravým tlačítkem na uzel Dependencies a zvolte Manage NuGet Packages.
   2. V okně NuGet Správce balíčků vyberte kartu Browse a nainstalujte balíček Microsoft.WindowsAppSDK.

5. Teď jste připraveni použít Bootstrapper API (viz Použít modul runtime Windows App SDK pro aplikace zabalené s externím umístěním nebo rozbalením) pro dynamické navázání závislosti na balíček rámce Windows App SDK. To vám umožní používat rozhraní API Windows App SDK ve vaší aplikaci.

   Otevřete soubor kódu Program.cs a nahraďte výchozí kód následujícím kódem, který zavolá metodu Bootstrap.Initialize pro inicializaci bootstrapperu. Tento kód určuje, na které verzi Windows App SDK je aplikace závislá při inicializaci bootstrapru.

   Důležité

   Níže uvedený kód budete muset upravit tak, aby vyhovoval vaší konkrétní konfiguraci. Prohlédněte si popisy parametrů metody Bootstrap.Initialize, abyste mohli zadat jednu z verzí Windows App SDK, které jste nainstalovali.

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

   Poznámka:

   Šestnáctková hodnota předaná do Bootstrap.Initialize kóduje hlavní a dílčí verzi modulu runtime sady Windows App SDK, na který vaše aplikace cílí. 0x00010005 představuje verzi 1.5. Aktualizujte tuto hodnotu tak, aby odpovídala Windows App SDK verzi, na kterou odkazuje váš projekt (například 0x00010006 pro verzi 1.6).

   V jádru je rozhraní API bootstrapperu nativní API jazyka C/C++, které umožňuje používat rozhraní API Windows App SDK ve vaší aplikaci. Ale v aplikaci .NET, která používá Windows App SDK 1.0 nebo novější, můžete použít obálku .NET pro rozhraní API bootstrapperu. Tato obálka umožňuje jednodušší způsob volání rozhraní API bootstrapperu v aplikaci v .NET než přímé volání funkcí nativně v C/C++. Předchozí příklad kódu volá statickou Initialize a Shutdown metody třídy Bootstrap v .NET obálky rozhraní API bootstrapperu.

6. Chcete-li předvést, že komponenty modulu runtime Windows App SDK byly načteny správně, přidejte kód, který v rámci Windows App SDK použije třídu ResourceManager k načtení prostředku řetězce.

   1. Přidejte do project nový soubor Sourcové soubory (.resw) (ponechte výchozí název).

   2. S otevřeným souborem prostředků v editoru vytvořte nový řetězcový prostředek s následujícími vlastnostmi.

      • Název: Zpráva
      • Hodnota: Ahoj, prostředky!

   3. Uložte soubor prostředků.

   4. Otevřete soubor kódu Program.cs a nahraďte Console.WriteLine("Hello, World!"); řádek následujícím kódem.

   // 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. Klikněte na Spustit bez ladění (nebo Spustit s laděním) pro sestavení a spuštění vaší aplikace. Měl by se úspěšně zobrazit řetězec Hello, resources!.

Podle těchto pokynů nakonfigurujte C++ WinUI projekt, který je buď zabalen s externím umístěním, nebo je rozbalen.

1. V Visual Studio vytvořte novou aplikaci C++ Console project. Pojmenujte project DynamicDependenciesTest.

   

   Po vytvoření project byste měli mít konzolovou aplikaci Hello, World! C++.

2. Dále nainstalujte balíček NuGet Windows App SDK do svého project.

   1. V Průzkumník řešení klikněte pravým tlačítkem na uzel References a zvolte Manage NuGet Packages.
   2. V okně NuGet Správce balíčků vyberte kartu Browse a vyhledejte Microsoft.WindowsAppSDK.

3. Teď jste připraveni použít rozhraní API bootstrapperu (viz Použití modulu runtime Windows App SDK pro aplikace zabalené s externím umístěním nebo bez balení) k inicializaci modulu runtime Windows App SDK ve vaší aplikaci. To vám umožní používat rozhraní API Windows App SDK v aplikaci.

   1. Na začátek souboru DynamicDependenciesTest.cpp přidejte následující soubory 'include'. Hlavička mddbootstrap.h je k dispozici prostřednictvím balíčku NuGet Windows App SDK.

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

   1. Dále přidejte tento kód na začátek vaší main metody, abyste zavolali funkci MddBootstrapInitialize pro inicializaci bootstrapperu a pro zpracování případných chyb. Tento kód určuje, na které verzi Windows App SDK je aplikace závislá při inicializaci bootstrapru.

   Důležité

   Níže uvedený kód budete muset upravit tak, aby vyhovoval vaší konkrétní konfiguraci. Podívejte se na popisy parametrů funkce MddBootstrapInitialize, abyste mohli zadat jednu z verzí Windows App SDK, kterou jste nainstalovali.

   const UINT32 majorMinorVersion{ 0x00010005 }; 
   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. Nakonec přidejte tento kód, který zobrazí řetězec Hello, World! a zavolá funkci MddBootstrapShutdown, aby deinicializovala bootstrapper.

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

   1. Konečný kód by měl vypadat takto.

   #include <iostream> 
   #include <windows.h> 
   #include <MddBootstrap.h>
   
   int main() 
   { 
       // Take a dependency on Windows App SDK Stable.
       const UINT32 majorMinorVersion{ 0x00010005 }; 
       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. Klikněte na Spustit bez ladění (nebo Spustit s laděním) pro sestavení a spuštění vaší aplikace.