Sdílet prostřednictvím

Poznámky k vydání stabilního kanálu pro Windows App SDK 1.2

Stabilní kanál poskytuje verze sady Windows App SDK, které jsou podporovány aplikacemi v produkčních prostředích. Aplikace, které používají stabilní verzi sady Windows App SDK, je možné publikovat také do Microsoft Storu.

důležité odkazy:

Nejnovější stabilní verze kanálu:

Stažení sady Windows App SDK

Poznámka:

Rozšíření sady Visual Studio SDK pro Windows App SDK (VSIX) již nejsou k dispozici jako samostatný soubor ke stažení. Jsou k dispozici ve Visual Studio Marketplace ve Visual Studio.

Verze 1.2.5 (1.2.230313.1)

Toto je servisní verze sady Windows App SDK, která obsahuje kritické opravy chyb pro vydání verze 1.2.

  • Opravili jsme problém, který způsoboval padání aplikací při ukončení práce s kompozicemi.
  • Opravili jsme problém, který způsoboval, že aplikace pokračovaly v spouštění animací, i když je obrazovka vypnutá.
  • Opravili jsme problém, který způsoboval selhání vstupu myši a dotykového ovládání ve webovém zobrazení2, když došlo současně ke vstupu myši a klávesnice. Další informace najdete v tématu Problém GitHubu č. 3266.

Verze 1.2.4 (1.2.230217.4)

Toto je servisní verze sady Windows App SDK, která obsahuje kritické opravy chyb pro vydání verze 1.2.

  • Opravili jsme problém, který způsoboval, že samostatné aplikace nemohly nastavit nastavení nástroje Řízení uživatelských účtů. Další informace najdete v tématu Problém s GitHubem č. 3376.
  • Opravili jsme problém, který způsoboval, že push oznámení vracela nepřesný expirační čas u PushNotificationChannel::ExpirationTime. Další informace najdete v GitHub issue #3300.
  • Opravili jsme problém, který způsoboval, že se záporná čísla při předávání dvojité hodnoty jako parametru do funkce x:Bind považovala za neplatná.
  • Několik oprav pro aktualizaci WinUI VSIX. Mezi tyto aktualizace patří zjednodušení šablony projektu dipAwareness v souboru app.manifest, odebrání šablon UWP, aktualizace lokalizovaných souborů zdrojů, přidání ID telefonu pro odblokování odesílání do obchodu a odebrání oznámení o autorských právech a licence. Další informace najdete v tématu Problémy GitHubu #5659, #3205, #3323, #3322, #3143.

Verze 1.2.3 (1.2.230118.102)

Toto je servisní verze sady Windows App SDK, která obsahuje kritické opravy chyb pro vydání verze 1.2.

  • Opravili jsme problém, který způsoboval chybové ukončení aplikací WinUI 3 při zavření více oken.
  • Opravili jsme problém způsobující pád aplikace při jejím zavření, když se volají dvě nebo více referencí na rozhraní ThreadPoolTimer. Další informace najdete v tématech Problémy GitHubu č. 7260 a #7239.
  • Opravili jsme problém, který způsoboval, že všechny jednoprojektové aplikace MSIX běžely s plnou důvěryhodností. Další informace naleznete na GitHub issue #7766.

Verze 1.2.2 (1.2.221209.1)

Toto je servisní verze sady Windows App SDK, která obsahuje kritické opravy chyb pro vydání verze 1.2.

  • Opravili jsme problém, který způsoboval, že se balíčky pro ukládání a načítání bokem (např. z instalačního programu, NuGetu a bootstrapperu) nepodařilo nainstalovat, pokud je už nainstalovaný druhý. Další informace najdete v tématu Problém s GitHubem č. 3168.
  • Opravili jsme problém, který způsoboval chybějící efekty elasticity a křivky animace při posouvání pomocí touchpadu. Další informace najdete v tématu Problém s GitHubem č. 7874.
  • Opravili jsme problém v ListView, který způsoboval únik paměti.
  • Opravili jsme problém, který způsoboval, že šablona tlačítka po najetí myší nerespektovala vlastnost Popředí. Další informace najdete viz Problém GitHubu č. 7208.
  • Opravili jsme problém, který způsoboval nepotřebnou výjimku, když v MediaElementu nebyla žádná mediaPlaybackItem.
  • Opravili jsme problém, který způsoboval, že se bílý rámeček zobrazoval v MediaPlayerElement při přechodech obsahu.
  • Opravili jsme další problémy, které způsobovaly, že App.UnhandledException nechytá výjimky z jiných vláken. Další informace najdete v tématech Problémy GitHubu č. 1259 a #5221.

Verze 1.2.1 (1.2.221116.1)

Toto je servisní verze sady Windows App SDK, která obsahuje opravu kritických chyb pro vydání verze 1.2.

Opravili jsme problém, který způsoboval chybové ukončení při spuštění v aplikacích C++ WinUI 3 při přidávání ovládacího prvku WebView2 nebo TextBox. Další informace najdete v tématu Problémy GitHubu č. 7911 a #3117.

nové a aktualizované funkce a známé problémy pro verzi 1.2

Následující části popisují nové a aktualizované funkce a známé problémy verze 1.2.

Poznámka:

Visual Studio 2019 a .NET 5 už nejsou podporované pro vytváření aplikací v jazyce C# (viz Windows App SDK 1.2 přechod na C# WinRT 2.0). Budete potřebovat Visual Studio 2022 a jednu z následujících verzí sady .NET SDK: 6.0.401 (nebo novější), 6.0.304, 6.0.109. Po vydání bude sada Windows App SDK 1.2 podporovat i .NET 7.

Pokud chcete aktualizovat verzi sady .NET SDK, nainstalujte nejnovější verzi sady Visual Studio 2022 nebo navštivte soubory ke stažení .NET. Při aktualizaci balíčku NuGet bez požadované verze sady .NET SDK se zobrazí chyba typu Tato verze sady WindowsAppSDK vyžaduje rozhraní .NET 6 nebo novější a WinRT.Runtime.dll verze 2.0 nebo vyšší. Chcete-li aktualizovat projekt z .NET 5.0 na .NET 6.0, otevřete soubor projektu a změňte "TargetFramework" na net6.0 a "Cílová verze operačního systému" na odpovídající hodnotu (například net6.0-windows10.0.19041.0).

Widgety třetích stran ve Windows

Panel widgetů byl poprvé představen ve Windows 11 a byl omezen na zobrazování integrovaných widgetů. Widgety jsou malé kontejnery uživatelského rozhraní, které zobrazují text a grafiku na panelu widgetů a jsou přidružené k aplikaci nainstalované na zařízení. Se sadou Windows App SDK teď jako vývojáři třetích stran můžete vytvářet widgety pro zabalené aplikace Win32 a testovat je místně na panelu widgetů pro Windows 11.

Další informace o widgetech najdete v přehledu widgetů.

Pokud chcete začít s vývojem widgetů pro vaši aplikaci, podívejte se na poskytovatele služeb widgetů, kteří dokumentaci k vývoji a Widgets navrhují základy pro požadavky, pokyny a osvědčené postupy.

Mezi požadavky pro tuto verzi patří:

  • Vývojářský režim je povolený na vývojovém počítači.
  • Na vývojovém počítači běží verze Windows z vývojářského kanálu Windows Insider Preview (WIP), která je větší nebo rovna 25217 s panelem widgetů verze 521.20060.1205.0 nebo vyšší.

Známá omezení při vývoji widgetů:

  • Widgety třetích stran je možné testovat pouze místně na zařízeních zaregistrovaných v WIP pro tuto verzi Preview.
  • Widgety lze vytvářet pouze pro zabalené aplikace Win32. Widgety pro progresivní webové aplikace (PWA) se plánují podporovat jako součást Microsoft Edge 108.

Informace o displeji

Desktopové aplikace pro Windows teď můžou podporovat vysoký dynamický rozsah (HDR) a automatickou správu barev (ACM) prostřednictvím třídy DisplayInformation v sadě Windows App SDK. Třída DisplayInformation umožňuje monitorovat informace související se zobrazením pro zobrazení aplikace. To zahrnuje události, které klientům umožňují sledovat změny v zobrazení aplikace, které ovlivňují zobrazení, na kterých se zobrazení nachází, a také změny v displejích, které můžou ovlivnit zobrazení aplikace.

WinUI 3

Aplikace WinUI 3 mohou přehrávat zvuk a video pomocí ovládacího prvku MediaPlayerElement a ovládacích prvků MediaTransportControls pro přehrávání médií. Další informace o tom, jak a kdy používat ovládací prvky médií, najdete v tématu Přehrávače médií.

WinUI 3 byl aktualizován nejnovějšími ovládacími prvky, styly a chováními z WinUI 2.8. Mezi tyto aktualizace patří přidání ovládacího prvku InfoBadge , vylepšení režimu přístupnosti a vysokého kontrastu a také opravy chyb napříč ovládacími prvky. Další podrobnosti najdete v poznámkách k vydání pro WinUI 2.7 a WinUI 2.8.

Opravené problémy:

Známá omezení:

  • Při vytváření nového projektu WinUI 3 pomocí sady Visual Studio 2022 17.4.0 bude odkazovat na verzi Preview sady Windows App SDK. Pomocí Správce balíčků NuGet aktualizujte odkaz na tuto verzi.
  • Nastavení MediaPlayerElement.Source na relativní identifikátor URI (ms-appx/ms-resource) selže v nebalených aplikacích. Doporučeným alternativním řešením je převést relativní identifikátor ms-appx:///URI na plně vyřešený identifikátor URI file:///.

Úprava aplikací vyvinutých pomocí .NET

Vývojáři .NET teď mohou publikovat zoptimalizované aplikace sady Windows App SDK. Pokud používáte CsWinRT 2.0, projekce C#/WinRT distribuované v sadě Windows App SDK jsou nyní optimalizovatelné. Publikování optimalizované verze vaší aplikace může zmenšit její velikost na disku tím, že odstraní veškerý nepoužitý kód z trimovatelných binárních souborů. Aplikace se také můžou setkat se zlepšením výkonu při spuštění. Při použití základní aplikace Hello World jsme zaznamenali zlepšení velikosti disku přibližně o 80% a zlepšení výkonu při startu o přibližně 7%, když byla publikována ve zmenšené podobě. S galerií WinUI jsme zaznamenali zlepšení využití disku, konkrétně snížení o přibližně 45%.

Další podrobnosti o tom, jak povolit oříznutí, omezení oříznutí (například odraz proti oříznutelným typům) a upozornění na oříznutí, najdete v tématu Oříznout samostatná nasazení a spustitelné soubory. Vývojáři by po optimalizaci měli důkladně otestovat svoje aplikace, aby zajistili, že všechno funguje podle očekávání. Pro více informací se podívejte na problém 2478 na GitHubu.

Podpora pro Visual Studio Arm64

Už ve verzi Projektu Reunion (nyní Windows App SDK) 0.5, když byly aplikace vyvinuté pomocí sady Windows App SDK, mohly běžet na Arm64. Počínaje sadou Visual Studio 17.3 Preview 2 můžete vyvíjet nativní aplikace pomocí sady Windows App SDKpp SDK na zařízeních s Arm64.

Pokud chcete začít s vývojem na zařízení Arm64, viz Windows na Arm a Arm64 Visual Studio.

Oznámení

AppNotificationBuilder je představen jako alternativa k XML payloadu pro vytváření a definování oznámení aplikací.

Informace o použití naleznete ve specifikaci AppNotificationBuilder na GitHubu.

Podívejte se také na rychlý start: Oznámení aplikací v sadě Windows App SDK , například jak vytvořit desktopovou aplikaci pro Windows, která odesílá a přijímá oznámení místních aplikací.

Kritická změna:

U nabízených oznámení při volání žádosti o kanál budou aplikace muset místo ID aplikace Azure používat ID objektu Azure. Podrobnosti o vyhledání ID objektu Azure naleznete v sekci Rychlý začátek: Oznámení push v sadě Windows App SDK.

Opravený problém:

PushNotificationManager.IsSupported provede kontrolu režimu se zvýšenými oprávněními. Pokud je aplikace spuštěna s vyššími oprávněními, vrátí false.

Známá omezení (oznámení):

Okenní systém

Úplné přizpůsobení záhlaví je nyní k dispozici ve Windows 10 verze 1809 a novější prostřednictvím třídy AppWindowTitleBar . Můžete nastavit AppWindowTitleBar.ExtendsContentIntoTitleBar na true pro rozšíření obsahu do oblasti záhlaví, a SetDragRectangles, abyste definovali oblasti přetažení (kromě dalších možností přizpůsobení).

Pokud jste používali vlastnost AppWindowTitleBar.IsCustomizationSupported k ověření, zda můžete volat rozhraní API AppWindowTitleBar, nyní vrací true v podporovaných verzích SDK Windows App pro Windows 10 (verze 1809 a novější)."

Známá omezení (vytváření oken):

Ve Windows 10 nejsou podporována základní přizpůsobení záhlaví. Patří sem BarvaPozadí, NeaktivníBarvaPozadí, BarvaPopředí, NeaktivníBarvaPopředí a MožnostiZobrazeníIkony. Pokud tyto vlastnosti vyvoláte, budou ignorovány tiše. Všechny ostatní AppWindowTitleBar API fungují ve Windows 10, verze 1809 a novější. Ve vztahu k API pro barvu tlačítka titulku (mimo jiné) a Height, je nutné nastavit ExtendsContentIntoTitleBar na true, jinak budou také tiše ignorovány.

Řízení přístupu

Zavedli jsme funkci security.accesscontrol.h s funkcí GetSecurityDescriptorForAppContainerNames , která usnadňuje a zjednodušuje sdílení pojmenovaných objektů mezi zabalenými procesy a obecnými rozhraními API win32. Tato metoda vezme seznam názvů rodin balíčků (PFN) a masky přístupu a vrátí popisovač zabezpečení. Další informace najdete ve specifikaci GetSecurityDescriptorForAppContainerNames na GitHubu.

Další omezení a známé problémy

Důležité

Když odkazujete na Windows App SDK 1.2 z projektu, může se zobrazit chyba podobná této: "Detekováno snížení verze balíčku: Microsoft.Windows.SDK.BuildTools z 10.0.22621.1 na 10.0.22000.194.", což je způsobeno nekompatibilními odkazy na balíček z projektu aplikace a balíčku Windows App SDK. Pokud chcete tento problém vyřešit, můžete aktualizovat odkaz v projektu na novější a kompatibilní verzi sady Microsoft.Windows.SDK.BuildTools.

  • Jednotkové testy mohou selhat s chybou REGDB_E_CLASSNOTREG v panelu Výstup testů ve Visual Studio. Alternativním řešením je přidat <WindowsAppContainer>true</WindowsAppContainer> do souboru projektu.
  • .NET PublishSingleFile se nepodporuje.
  • Výchozí nastavení autoicializátoru Bootstrapper a Undocked RegFree WinRT je (nyní) nastavená pouze pro projekty, které vytvářejí spustitelný soubor (OutputType=Exe nebo WinExe). Tím zabráníte přidávání automatických inicializátorů do knihoven DLL tříd a jiných nespustitelných souborů ve výchozím nastavení.
    • Pokud potřebujete automatický inicializátor v nespustitelném souboru (např. testovací knihovnu DLL načtenou obecným spustitelným souborem, který neinicializuje bootstrapper), můžete v projektu explicitně povolit automatický inicializátor prostřednictvím <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize> nebo <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.
  • Microsoft.WindowsAppRuntime.Release.Net.dll je vždy binární soubor Arm64 a nefunguje pro aplikace x86 a x64. Při explicitním volání rozhraní API bootstrap nepoužívejte sestavení Microsoft.WindowsAppRuntime.Release.Net.dll. Jako alternativní řešení můžete do tohoto zdrojového souboru zahrnout konstanty verzí distribuované s balíčkem NuGet: .. \include\WindowsAppSDK-VersionInfo.cs' nebo použijte automatický inicializátor.
  • Last updated on