Sdílet prostřednictvím


Poznámky k vydání stabilní verze pro Windows App SDK 1.3

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.3.3 (1.3.230724000)

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

  • Opravili jsme problém, kdy při zavření dialogového okna někdy přestala fungovat myš.
  • Opravili jsme problém s nasazením, který bránil instalaci aplikací kvůli neshodě verzí balíčků v systému. Další informace najdete v GitHub issue č. 3740.
  • Opravili jsme problém, který ovlivňoval umístění místní nabídky ve Windows App SDK 1.3.
  • Opravili jsme problém, který způsoboval, že některé aplikace WinUI3 v některých situacích spadly při zavírání, protože XAML se vypnul příliš brzy.
  • Opravili jsme problém, kdy se ikony písem správně nezrcadlily u jazyků psaných zprava doleva. Další informace najdete v tématu Problém s GitHubem č. 7661.
  • Opravili jsme problém, který způsoboval pád aplikace při vypnutí, když byly prostředky odstraněny ve špatném pořadí. Další informace najdete v problému GitHub č. 7924.

Verze 1.3.2 (1.3.230602002)

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

  • Opravili jsme chybu při nastavování chráněného kurzoru.
  • Opravili jsme problém s výkonem xamlMetadataProvider během spouštění aplikace. Další informace najdete v GitHub problému č. 8281.
  • Opravili jsme problém s hypertextovými odkazy a dotykovým ovládáním v RichTextBlocku. Další informace najdete v tématu Problém s GitHubem č. 6513.
  • Opravili jsme problém s posouváním a touchpady ve WebView2. Další informace najdete v issue GitHubu č. 7772.
  • Opravili jsme problém, kdy aktualizace sady Windows App SDK někdy vyžadovala restartování sady Visual Studio. Další informace najdete v tématu Problém s GitHubem č. 3554.
  • Opravili jsme hlučnou výjimku při ukončení, když běžíme v ladicím programu.

Verze 1.3.1 (1.3.230502000)

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

  • Opravili jsme problém, který způsoboval chybové ukončení aplikací při nastavování systemBackdrop, pokud byl obsah null. Další informace viz na GitHubu problém č. 8416.
  • Opravili jsme problém, který způsoboval chybové ukončení aplikací při nastavování názvu okna v xaml, což je nová funkce přidaná ve verzi 1.3.0. Další informace najdete v tématu Problém s GitHubem č. 3689.
  • Opravili jsme problém, kdy se při změně obsahu nesprávně zaostřilo okno.
  • Opravili jsme problém s vytvářením projektů C++ pomocí šablon projektů sady Windows App SDK 1.3.
  • Aktualizované šablony na Webu Visual Studio Marketplace

Nové a aktualizované funkce a známé problémy pro verzi 1.3

Následující části popisují nové a aktualizované funkce a známé problémy pro verzi 1.3.

V existující aplikaci Windows App SDK 1.2 můžete balíček NuGet aktualizovat na verzi 1.3.230331000 (viz část Aktualizace balíčku v části Instalace a správa balíčků v sadě Visual Studio pomocí Správce balíčků NuGet).

Aktualizovanou verzi runtime a MSIX najdete v tématu Nejnovější soubory ke stažení sady Windows App SDK.

XAML rozhraní API pro pozadí

Díky vlastnostem vestavěným v okně XAML jsou teď v aplikaci WinUI 3 snadněji použitelná pozadí Mica a Akrylové pozadí. Další informace o vlastnostech Xaml Backdrop najdete v dokumentaci k parametrům systémového pozadí a rozhraní API pro Mica Backdrop .

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Okno.AppWindow

Nahrazením několika řádků často používaného kódu teď můžete používat rozhraní AppWindow API přímo z okna prostřednictvím Window.AppWindow.

Nové funkce ze sady Windows App SDK

  • ApplicationModel.DynamicDependency: PackageDependency.PackageGraphRevisionId, který nahrazuje zastaralé MddGetGenerationId.
  • Správce prostředí: EnvironmentManager.AreChangesTracked vás informuje, zda lze ve vaší aplikaci sledovat změny ve správci prostředí.
  • Nová událost DebugSettings.XamlResourceReferenceFailed je nyní vyvolána, když nelze vyřešit odkazované vyhledávání StaticResource/ThemeResource. Tato událost poskytuje přístup k trasování, které podrobně popisuje, kde framework hledal tento klíč, aby vám lépe umožnil ladit selhání při vyhledávání klíčů Static a ThemeResource. Další informace najdete v tématu Trasování problémů s hledáním prostředků XAML specifikace API rozhraní na GitHubu.

Další aktualizace

Známý problém

Kvůli nedávné změně kompilátoru XAML může existující projekt, který upgraduje na verzi 1.3, zaznamenat chybu sestavení, například následující v sadě Visual Studio:

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

Příčinou je Visual Studio, které používá mezipaměťovou úlohu kompilátoru XAML DLL z verze 1.2, ale řídí ji nekompatibilní logikou MSBuild z verze 1.3, jak je vidět v textu chyby výše. Alternativním řešením je vypnout Visual Studio, restartovat ho a znovu načíst řešení.