Zpráva k vydání stabilního kanálu pro Sadu Windows App SDK 0.8

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:

• Pokud chcete upgradovat existující aplikaci ze starší verze sady Windows App SDK na novější verzi, přečtěte si téma Aktualizace stávajících projektů na nejnovější verzi sady Windows App SDK.

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

• Nejnovější poznámky k vydání stabilní verze kanálu pro Sadu Windows App SDK

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 0.8

Nejnovější dostupná verze rodokmenu 0.8.x stabilního kanálu sady Windows App SDK je verze 0.8.12.

Poznámka:

Sada Windows App SDK byla dříve známa názvem kódu Project Reunion. Některé prostředky sady SDK ve verzi 0.8 a starší stále používají název kódu. Některé části dokumentace nadále používají Project Reunion při odkazování na existující aktivum nebo zadanou dřívější verzi.

Verze 0.8.12

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

Poznámka:

Pro vývojáře v jazyce C# je vyžadována jedna z následujících verzí sady .NET SDK: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (nebo novější). Pokud chcete aktualizovat verzi sady .NET SDK, přejděte na .NET Ke stažení nebo aktualizujte na nejnovější verzi sady Visual Studio. Bez požadované verze sady .NET SDK se při aktualizaci balíčku NuGet zobrazí chyba typu: Tato verze sady WindowsAppSDK vyžaduje WinRT.Runtime.dll verze 1.6 nebo vyšší.

Opravy chyb (0.8.12)

• Vyřešili jsme problém, kdy aplikace s SwapChainPanel nebo WebView2 nepředvídatelně padaly v důsledku narušení přístupu.

Verze 0.8.11

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

Poznámka:

Pro vývojáře v jazyce C# je vyžadována jedna z následujících verzí sady .NET SDK: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (nebo novější). Pokud chcete aktualizovat verzi sady .NET SDK, přejděte na .NET Ke stažení nebo aktualizujte na nejnovější verzi sady Visual Studio. Bez požadované verze sady .NET SDK se při aktualizaci balíčku NuGet zobrazí chyba typu: Tato verze sady WindowsAppSDK vyžaduje WinRT.Runtime.dll verze 1.6 nebo vyšší.

Opravy chyb (0.8.11)

• Opravili jsme regresi, která způsobovala, že při výběru textu pomocí myši došlo k události ztráty fokusu.

Verze 0.8.10

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

Poznámka:

Pro vývojáře v jazyce C# je vyžadována jedna z následujících verzí sady .NET SDK: 5.0.213, 5.0.407, 6.0.104, 6.0.202 (nebo novější). Pokud chcete aktualizovat verzi sady .NET SDK, přejděte na .NET Ke stažení nebo aktualizujte na nejnovější verzi sady Visual Studio. Bez požadované verze sady .NET SDK se při aktualizaci balíčku NuGet zobrazí chyba typu: Tato verze sady WindowsAppSDK vyžaduje WinRT.Runtime.dll verze 1.6 nebo vyšší.

Opravy chyb (0.8.10)

• Opravili jsme problémy, které někdy způsobovaly chybové ukončení aplikací během operace přetažení.

Poznámka:

Sada Windows App SDK 0.8.9 nebyla vydána. Verze vydaná přímo po verzi 0.8.8 je 0.8.10.

Verze 0.8.8

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

Poznámka:

Pro vývojáře v jazyce C# je vyžadována jedna z následujících verzí sady .NET SDK (nebo novější): 6.0.202, 6.0.104, 5.0.407, 5.0.213. Pokud chcete aktualizovat verzi sady .NET SDK, přejděte na .NET Ke stažení nebo aktualizujte na nejnovější verzi sady Visual Studio. Bez požadované verze sady .NET SDK se při aktualizaci balíčku NuGet zobrazí chyba typu: Tato verze sady WindowsAppSDK vyžaduje WinRT.Runtime.dll verze 1.6 nebo vyšší.

Opravy chyb (0.8.8)

• Opravili jsme problémy s dotykovým vstupem v Textovém poli týkající se softwarové klávesnice a obecné interakce. Tyto problémy také ovlivnily klávesové zkratky. Další informace najdete v tématu problém 6291 na GitHubu.
• Opravili jsme problém, kdy se okno aplikace někdy zobrazovalo jako neaktivní, když je aktivní.
• Opravili jsme problém s výkonem způsobeným spuštěním UIA (automatizace uživatelského rozhraní) v externích procesech.
• Opravili jsme problém se stabilitou aplikací se vstupem pera.
• Opravili jsme problém, kdy se vykreslování ikon png v nabídce výrazně zpozdilo kvůli UIA.

Verze 0.8.7

Toto je servisní verze sady Windows App SDK, která obsahuje několik aktualizací výkonu pro aplikace C#/.NET. Abyste mohli aktualizovat na tuto verzi, budete muset odkazovat na nejnovější verzi balíčku Windows SDK. Uděláte to tak, že do souboru <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> přidáte vlastnost .csproj s verzí sady SDK, na kterou vaše aplikace cílí z vlastnosti TargetFramework. Například:

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

Tato verze projekce sady Windows SDK bude k dispozici v nadcházející servisní verzi .NET 6. Po této aktualizaci sady .NET SDK byste měli <WindowsSdkPackageVersion> odebrat vlastnost ze souboru projektu.

Pokud tuto vlastnost nenastavíte, zobrazí se podobná chyba: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

Verze 0.8.6

Toto je servisní verze sady Windows App SDK, která zahrnuje několik vylepšení výkonu pro aplikace C#/.NET pro vydání verze 0.8.0.

Pokud chcete aktualizovat na tuto verzi sady Windows App SDK, budete muset mít nainstalovanou nejnovější aktualizaci .NET SDK z prosince (viz Stažení rozhraní .NET a .NET 5 dosáhne konce podpory 10. května 2022). Pokud nemáte nainstalovanou minimální požadovanou verzi sady .NET SDK, zobrazí se chyba podobná této: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

Opravy chyb (0.8.6)

Podrobný seznam vylepšení výkonu najdete v poznámkách k vydání verze C#/WinRT 1.4.1.

Verze 0.8.5

Toto je servisní verze sady Windows App SDK, která obsahuje důležitější opravy chyb pro vydání verze 0.8.0.

Opravy chyb (0.8.5)

• Opravili jsme problém, který způsoboval chybové ukončení aplikací WinUI pomocí vstupu ukazatele .
• Opravili jsme problém, který způsoboval, že tlačítka záhlaví (min, max, close) neměla ve Windows 11 zaoblené rohy.
• Opravili jsme problém, který způsoboval, že se při najetí myší na tlačítko maximalizovat/obnovit ve Windows 11 neobjevovaly možnosti změny velikosti rozložení.
• Opravili jsme problém způsobující výjimku vedoucí ke zhroucení při vytváření objektu PointCollection. Další informace najdete v tématu problém 971 na GitHubu.

Omezení a známé problémy verze 0.8 platí také pro verzi 0.8.5, pokud není uvedeno jinak v následující části.

Verze 0.8.4

Toto je servisní verze sady Windows App SDK, která obsahuje důležitější opravy chyb pro vydání verze 0.8.0.

Opravy chyb (0.8.4)

• Opravy pro vlastní záhlaví tak, aby ContentDialog jej nezakrýval a aby tlačítka záhlaví byla zaoblená.
• Oprava chyby při zpracování obrázku při změně měřítka zobrazení
• Opravy chyb, kde uživatelské rozhraní zmizelo nebo bylo nesprávně oříznuto.

Omezení a známé problémy verze 0.8 platí také pro verzi 0.8.4, pokud není uvedeno jinak v následující části.

Verze 0.8.3

Toto je servisní verze sady Windows App SDK, která obsahuje důležitější opravy chyb pro vydání verze 0.8.0.

Opravy chyb (0.8.3)

Fokus klávesnice se ztrácel, když se okno po minimalizaci a obnovení, vyžadovalo kliknutí myší pro obnovení fokusu.

Omezení a známé problémy verze 0.8 platí také pro verzi 0.8.3, pokud není uvedeno jinak v následující části.

Verze 0.8.2

Toto je servisní verze sady Windows App SDK, která obsahuje důležitější opravy chyb pro vydání verze 0.8.0.

Opravy chyb (0.8.2)

• Sada Windows App SDK a WinUI 3 se teď podporují v sadě Visual Studio 2022 Preview 2 a novějších verzích.
• U aplikací .NET se při předávání pole výčtů může zobrazit následující chyba: Object contains non-primitive or non-blittable data.
• Při psaní pomocí panelu rukopisu uvnitř textového pole program spadne.
• Ikony a obrázky se vždy načítají na základě hodnoty škálování 100%, nikoli na základě hodnoty měřítka monitoru.
• Uvolnění paměti EventSource<T> způsobí následné selhání obslužných rutin odhlášení odběru (další podrobnosti najdete v problému na GitHubu)
• Oprava zabezpečení – další podrobnosti najdete v cve-2021-34533 .
• SwapChainPanel.CompositionScaleChanged někdy vrací nesprávné hodnoty CompositionScale po změně měřítka zobrazení

Omezení a známé problémy verze 0.8 platí také pro verzi 0.8.2, pokud není uvedeno jinak v následující části.

Verze 0.8.1

Toto je servisní verze sady Windows App SDK, která obsahuje několik důležitých oprav chyb pro vydání verze 0.8.0.

Opravy chyb (0.8.1)

• Sada Windows App SDK nejde spustit na nejnovější verzi Windows Insider
• Chyba v EditableComboBox při zadávání hodnoty, která se nezobrazuje v rozevíracím seznamu
• WebView2 neumožňuje uživateli po přijetí prioritního zobrazení tabulátoru.
• Plně kvalifikovat obor názvů Windows.Foundation.Metadata.DefaultOverload ve vygenerovaném kódu WinUI, aby nedocházelo k nejednoznačnosti oboru názvů
  • Toto opravuje chyby #5108.
• Oprava zabezpečení – další podrobnosti najdete v cve-2021-34489 .

Omezení a známé problémy verze 0.8 platí také pro verzi 0.8.1, pokud není uvedeno jinak v následující části.

Stabilní verze 0.8.0

Nové funkce a aktualizace

Tato verze podporuje všechny funkce stabilního kanálu .

WinUI 3:

Tato verze obsahuje řadu oprav chyb a vylepšenou stabilizaci v systému WinUI 3. Toto jsou všechny nové změny ve WinUI 3 od vydání WinUI 3 – Project Reunion 0.5:

• Ovládací prvek Pivot byl přidán zpět a teď ho můžete použít v libovolné aplikaci WinUI 3.

• Všechny opravy chyb z Project Reunion v0.5.5, v0.5.6 a v0.5.7 jsou součástí této verze.

• Nové opravy chyb, mezi které patří:

  • Při kliknutí pravým tlačítkem myši v Textovém poli dojde k chybovému ukončení aplikace.
  • NavigationView způsobí pád v UWP, Reunion 0.5 Preview
  • Indikátor průběhu nezobrazuje rozdíl mezi možností Pozastaveno a Chyba
  • Pád aplikace RichEditBox při kopírování, vkládání nebo změně stylu textu
  • Tlačítka titulku okna jsou špatně umístěna, pokud SetTitleBar není nastavena nebo má hodnotu null.

  Úplný seznam chyb vyřešených v této verzi najdete v našem úložišti GitHubu.

• Rozhraní API ColorHelper.ToDisplayName už není k dispozici.

• Byly odebrány následující typy:

  • Microsoft.Graphics.IGeometrySource2D
  • Microsoft.Graphics.IGeometrySource2DInterop

  Použijte Windows.Graphics.IGeometrySource2D a Windows.Graphics.IGeometrySource2DInterop místo toho.

• Všechny typy v Microsoft.System oboru názvů byly přesunuty do Microsoft.UI.Dispatching oboru názvů, včetně třídy DispatcherQueue.

• Vlastnost AcrylicBrush.BackgroundSource byla odebrána, protože HostBackdrop není podporována jako BackgroundSource v systému WinUI 3.

Další informace o WinUI naleznete v tématu WinUI.

Pokud chcete zobrazit ovládací prvky a funkce WinUI 3 v akci, můžete naklonovat a sestavit aplikaci Galerie WinUI 3 z GitHubu nebo si ji stáhnout z Microsoft Storu.

Pokud chcete začít s vývojem pomocí WinUI, přečtěte si následující články:

• šablony WinUI 3 v sadě Visual Studio
• Vytvoření prvního projektu WinUI 3 (Windows App SDK)
• Vytvořte aplikaci C# .NET s interoperabilitou WinUI 3 a Win32
• Referenční rozhraní API WinUI 3

DWriteCore:

Tato verze DWriteCore obsahuje následující nové a aktualizované funkce. DWriteCore je zaveden a popsán v DWriteCore přehledu.

• DWriteCore teď podporuje podtržení – viz IDWriteTextLayout::GetUnderline a IDWriteTextLayout::SetUnderline.
• Podpora přeškrtnutí – viz IDWriteTextLayout::GetStrikethrough a IDWriteTextLayout::SetStrikethrough.
• Podpora svislého textu prostřednictvím idWriteTextLayout– viz Svislý text.
• Implementují se všechny metody IDWriteTextAnalyzer a IDWriteTextAnalyzer1 rozhraní.
• Funkce DWriteCoreCreateFactory, která je volná funkce, vytvoří objekt továrny, jenž se použije k následnému vytvoření jednotlivých objektů DWriteCore.

Poznámka:

DWriteCoreCreateFactory je funkčně stejný jako DWriteCreateFactory funkce exportované systémovou verzí DirectWrite. Funkce DWriteCore má jiný název, aby se zabránilo nejednoznačnosti v případě, že propojete obě DWriteCore.lib a DWrite.lib.

Pro referenční informace o rozhraní API DWriteCore a DirectWrite viz DWriteCore API Reference a DirectWrite API Reference.

MRTCore:

• Akce sestavení pro zdroje se automaticky nastaví, když přidáte zdroj do projektu, což snižuje potřebu ruční konfigurace projektu.

Omezení

• Tato verze se v současné době nepodporuje v kanálu Dev programu Windows Insider. Toto je opravené ve verzi 0.8.1.

• Desktopové aplikace (C# nebo C++): Tato verze se podporuje jenom v desktopových aplikacích (C++ nebo C#), které jsou zabalené pomocí MSIX. Pokud chcete sadu Windows App SDK používat v rozbalených desktopových aplikacích, musíte použít experimentální kanál verze.

Důležité

Pokud pracujete na aplikaci pro UWP, podívejte se na Migrace z UWP na Windows App SDK.

Známé problémy

• Nástroje WinUI 3, jako jsou Live Visual Tree, Live Property Explorer a Rychlé načítání ve verzi 0.8 a novější, vyžadují Visual Studio 2019 16.11 Preview 3 a novější.

• Aplikace aktuálně používající WinUI 3 a Windows App SDK 0.8 nemůžou používat knihovny tříd, které používají Project Reunion 0.5. Aktualizujte knihovny tříd tak, aby používaly sadu Windows App SDK 0.8.

• Aplikace .NET musí cílit na build 18362 nebo novější: TFM musí být nastaveno na net6.0-windows10.0.18362 nebo novější a projekt balíčkování musí být nastaven na 18362 nebo novější. Další informace najdete v tématu Problém s GitHubem č. 921.

• Při častém přepínání mezi světlým a tmavým režimem se může aplikace zhroutit.

• U aplikací .NET se při předávání pole výčtů může zobrazit následující chyba: Object contains non-primitive or non-blittable data.Toto je opraveno ve verzi 0.8.2.

• U aplikací .NET se v současné době nedá vyjádřit výslovný nesouhlas s indexovanými obrázky jako prostředkem aplikace pomocí uživatelského rozhraní sady Visual Studio. Pokud chcete tento problém obejít, přidejte do projektu adresář.Build.targets (viz Přizpůsobení sestavení – Visual Studio s pokyny) a následujícím způsobem odeberte image:

  • Pokud chcete odebrat konkrétní obrázky (mějte na paměti, že je potřeba relativní cesta):

    <Project>
    <ItemGroup>
        <Content Remove="..\Bitmap1.bmp" />
    </ItemGroup>
    </Project>
    

    • Odebrání obrázků na základě metadat:

    <Project>
    <ItemGroup>
        <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
    </ItemGroup>
    </Project>
    

    Oprava tohoto problému se plánuje v nadcházející verzi – v tomto okamžiku už nebudou potřeba výše uvedená alternativní řešení.

Související témata

• Poznámky k nejnovější verzi Preview kanálu pro Windows App SDK
• Nejnovější poznámky k verzi pro experimentální kanál Windows App SDK
• Nástroje pro instalaci sady Windows App SDK
• Vytvoření prvního projektu WinUI 3 (Windows App SDK)
• Použití sady Windows App SDK v existujícím projektu
• Přehled nasazení