Versionsanteckningar för stabil kanal för Windows App SDK 1.2

Den stabila kanalen innehåller versioner av Windows App SDK som stöds för användning av appar i produktionsmiljöer. Appar som använder den stabila versionen av Windows App SDK kan också publiceras till Microsoft Store.

Viktiga länkar:

• Om du vill uppgradera en befintlig app från en äldre version av Windows App SDK till en nyare version kan du läsa Uppdatera befintliga projekt till den senaste versionen av Windows App SDK.

Senaste stabila kanalversionen:

• Senaste viktig information om stabil kanal för Windows App SDK-

Nedladdningar för Windows App SDK

Version 1.2.5 (1.2.230313.1)

Det här är en serviceversion av Windows App SDK som innehåller kritiska felkorrigeringar för 1.2-versionen.

• Ett problem som gjorde att appar kraschade under kompositionsavstängningen har åtgärdats.
• Ett problem har åtgärdats som gör att appar fortsätter att köra animeringar även när skärmen är avstängd.
• Ett problem har åtgärdats som gjorde att mus- och pekindata misslyckades i WebView2 när mus- och tangentbordsindata inträffade samtidigt. Mer information finns i GitHub-problem #3266.

Version 1.2.4 (1.2.230217.4)

Det här är en serviceversion av Windows App SDK som innehåller kritiska felkorrigeringar för 1.2-versionen.

• Ett problem har åtgärdats som gjorde att fristående appar inte kunde ange UAC-inställningar. Mer information finns i GitHub-problem #3376.
• Ett problem har åtgärdats som gjorde att push-meddelanden returnerade en felaktig förfallotid med PushNotificationChannel::ExpirationTime. Mer information finns i GitHub-problem #3300.
• Ett problem har åtgärdats som gjorde att negativa tal ansågs vara "ogiltiga" när en dubbel som en parameter skickas till en x:Bind-funktion.
• Flera korrigeringar för att uppdatera WinUI VSIX. Dessa uppdateringar inkluderade att förenkla projektmallen dipAwareness i app.manifest, ta bort UWP-mallarna, uppdatera lokaliserade resursfiler, lägga till telefon-ID för att medgöra butiksinlämning och ta bort upphovsrättsmeddelandet och licensen. Mer information finns i GitHub-problem #5659, #3205, #3323, #3322, #3143.

Version 1.2.3 (1.2.230118.102)

Det här är en serviceversion av Windows App SDK som innehåller kritiska felkorrigeringar för 1.2-versionen.

• Ett problem har åtgärdats som gjorde att WinUI 3-appar kraschade när flera fönster stängdes.
• Ett problem som orsakade en krasch när appen stängdes har åtgärdats vid anrop av två eller flera referenser till gränssnittet ThreadPoolTimer. Mer information finns i GitHub-problem #7260 och #7239.
• Ett problem har åtgärdats som gjorde att alla enkelprojekt-MSIX-appar kördes med fullständig tillit. Mer information finns i GitHub-problem #7766.

Version 1.2.2 (1.2.221209.1)

Det här är en serviceversion av Windows App SDK som innehåller kritiska felkorrigeringar för 1.2-versionen.

• Ett problem har åtgärdats som gjorde att Store- och sido-inladdningspaketen (t.ex. från installationsprogram, NuGet och bootstrapper) inte kunde installeras om det andra redan var installerat. Mer information finns i GitHub-problem #3168.
• Ett problem som orsakade saknade elasticitetseffekter och animeringskurvor vid rullning med en pekplatta har åtgärdats. Mer information finns i GitHub-problem #7874.
• Ett problem har åtgärdats i ListView som orsakar minnesläckor.
• Ett problem har åtgärdats som gjorde att knapplösningen inte respekterade förgrundsegenskapen efter muspekarsvep. Mer information finns i GitHub-problem #7208.
• Ett problem som orsakade ett onödigt undantag när det inte finns någon MediaPlaybackItem i ett MediaElement har åtgärdats.
• Ett problem har åtgärdats som gjorde att en vit ram visas i MediaPlayerElement vid innehållsövergångar.
• Ytterligare problem som gjorde att App.UnhandledException inte kunde fånga upp undantag från andra trådar har åtgärdats. Mer information finns i GitHub-problem #1259 och #5221.

Version 1.2.1 (1.2.221116.1)

Det här är en serviceversion av Windows App SDK som innehåller en kritisk felkorrigering för 1.2-versionen.

Åtgärdat problem som orsakade en krasch vid start i C++ WinUI 3-appar när du lade till en WebView2- eller TextBox-kontroll. Mer information finns i GitHub-problem #7911 & #3117.

nya och uppdaterade funktioner och kända problem för version 1.2

I följande avsnitt beskrivs nya och uppdaterade funktioner och kända problem för 1.2.

Widgetar från tredje part i Windows

Widgetkortet introducerades först i Windows 11 och begränsades till att visa inbyggda widgetar. Widgetar är små UI-containrar som visar text och grafik på widgetkortet och som är associerade med en app som är installerad på enheten. Med Windows App SDK kan du som tredjepartsutvecklare nu skapa widgetar för dina paketerade Win32-appar och testa dem lokalt på Windows 11-widgetkortet.

Mer information om widgetar finns i Översikt över widgetar.

Om du vill komma igång med att utveckla widgetar för din app kan du läsa utvecklingsdokumenten för Widget-tjänsteleverantörer och Widgets-designen för krav, vägledning och metodtips.

Förutsättningar för den här versionen är:

• Utvecklarläge aktiverat på utvecklingsdatorn.
• Utvecklingsdatorn kör en version av Windows från Dev Channel of Windows Insider Preview (WIP) som är större än eller lika med 25217 med widgetsboard version 521.20060.1205.0 eller senare.

Kända begränsningar vid utveckling av widgetar:

• Widgetar från tredje part kan bara testas lokalt på enheter som registrerats i WIP för den här förhandsversionen.
• Widgetar kan bara skapas för paketerade Win32-appar. Widgetar för progressiva webbappar (PWA) planeras att stödjas som en del av Microsoft Edge 108.

Visningsinformation

Windows-skrivbordsappar kan nu stödja HDR (High Dynamic Range) och Auto Color Management (ACM) via klassen DisplayInformation i Windows App SDK. Med klassen DisplayInformation kan du övervaka visningsrelaterad information för en programvy. Detta inkluderar händelser som gör det möjligt för klienter att övervaka ändringar i programvyn som påverkar vilka skärmar vyn finns på, samt ändringar i skärmar som kan påverka programvyn.

WinUI 3

WinUI 3-appar kan spela upp ljud och video med medieuppspelningskontrollerna MediaPlayerElement och MediaTransportControls . Mer information om hur och när du ska använda mediekontroller finns i Mediaspelare.

WinUI 3 har uppdaterats med de senaste kontrollerna, formaten och beteendena från WinUI 2.8. Dessa uppdateringar omfattar tillägg av InfoBadge-kontrollen , förbättringar av tillgänglighet och högkontrastläge samt felkorrigeringar mellan kontroller. För mer information, se versionsinformationen för WinUI 2.7 och WinUI 2.8.

Åtgärdade problem:

• Akrylbakgrundsmaterial med DesktopAcrylicController stöds nu i Windows 10-appar. Mer information finns i problem 7112 på GitHub.
• Åtgärdade olika problem som gjorde att routningen av App.UnhandledException misslyckades. Mer information finns i problem 5221 på GitHub. När det gäller de återstående problemen dokumenteras lösningar på följande GitHub-problem och kommer att lösas i en framtida 1.2-version:
  • UnhandledExceptionEventArgs.Exception i App_UnhandledException kan bara hämtas en gång och bör cachelagras
  • Do_Abi_* händelse-/motringningshanterare ska omsluta anrop med RoReportUnhandledError
• Ett problem har åtgärdats som gjorde att ListView-formatmallar regresserades och ändrades från Windows App SDK 1.1. Mer information finns i problem 7666 på GitHub.
• Ett fel som orsakade att den felaktiga Mica-fallfärgen visades när appen var inaktiv har åtgärdats. Mer information finns i problem 7801 på GitHub.

Kända begränsningar:

• När du skapar ett nytt WinUI 3-projekt med Visual Studio 2022 17.4.0 refererar det till en förhandsversion av Windows App SDK. Använd NuGet Package Manager för att uppdatera referensen till den här versionen.
• Det går inte att ange MediaPlayerElement.Source till relativ URI (ms-appx/ms-resource) i opacketerade appar. Den rekommenderade lösningen är att konvertera den relativa ms-appx:/// URI till en fullt resolverad file:/// URI.

Trimning för appar som utvecklats med .NET

.NET-utvecklare kan nu publicera trimmade Windows App SDK-appar. Med CsWinRT 2.0 är de C#/WinRT-projektioner som distribueras i Windows App SDK nu trimmade. Om du publicerar appen trimmad kan du minska appens diskfotavtryck genom att ta bort all oanvänd kod från trimmade binärfiler. Appar kan också se en förbättring av startprestanda. Med en grundläggande Hello World-app har vi sett en minskning av diskavtrycket med ~80% och en prestandaförbättring vid start med ~7% när den trimmade versionen publiceras. Med WinUI-galleriet har vi sett en förbättring på ~45% diskfotavtryck.

Mer information om hur du aktiverar trimning, trimningsbegränsningar (till exempel reflektion mot trimmade typer) och trimningsvarningar finns i Trimma fristående distributioner och körbara filer. Utvecklare bör noggrant testa sina appar efter trimning för att säkerställa att allt fungerar som förväntat. Mer information finns i problem 2478 på GitHub.

Stöd för Visual Studio Arm64

Redan i Project Reunion (nu Windows App SDK) 0.5 kunde appar som utvecklats med Windows App SDK köras på Arm64. Från och med Visual Studio 17.3 Preview 2 kan du utveckla interna program med Windows App SDKpp SDK på Arm64-enheter.

Information om hur du kommer igång med att utveckla på en Arm64-enhet finns i Windows på Arm och Arm64 Visual Studio.

Meddelanden

AppNotificationBuilder introducerades som ett alternativ till XML-nyttolast för att skapa och definiera appmeddelanden.

Information om användning finns i AppNotificationBuilder-specifikationen på GitHub.

Se även Snabbstart: Appaviseringar i Windows App SDK för ett exempel på hur du skapar ett Windows-skrivbordsprogram som skickar och tar emot lokala appaviseringar.

Omfattande förändring:

När du skickar push-meddelanden måste appar använda Azure-objekt-ID:t i stället för Azure App-ID:t när de anropar en kanalbegäran. Mer information om hur du hittar ditt Azure-objekt-ID finns i Snabbstart: Push-meddelande i Windows App SDK .

Åtgärdat problem:

PushNotificationManager.IsSupported utför en kontroll av förhöjt läge. Den returnerar false om appen är upphöjd.

Kända begränsningar (meddelanden):

• I AppNotificationScenarioUrgent stöds endast för Windows-versioner 19041 och senare. Du kan använda AppNotificationBuilder.IsUrgentScenarioSupported för att kontrollera om funktionen är tillgänglig under körning.
• I AppNotificationButtonhint-toolTip stöds och hint-buttonStyle endast för versioner 19041 och senare. Du kan använda IsButtonStyleSupported och IsToolTipSupported för att kontrollera om funktionen är tillgänglig vid körning.
• I MediaPlayerElement kan egenskapen Source inte anges med en ms-appx- eller ms-resource-URI när den används i XAML-markering för en uppackad app. Alternativt kan du ange källan med hjälp av en fil-URI eller ange från kod.

Fönster

Fullständig anpassning av namnlisten är nu tillgänglig i Windows 10, version 1809 och senare via klassen AppWindowTitleBar . Du kan ange AppWindowTitleBar.ExtendsContentIntoTitleBar till true för att utöka innehållet till området med namnlisten. Du kan också använda SetDragRectangles för att definiera dragningsområden, förutom andra anpassningsalternativ.

Om du har använt egenskapen AppWindowTitleBar.IsCustomizationSupported för att kontrollera om du kan anropa AppWindowTitleBar-API :erna, returneras true den nu på Windows App SDK Windows 10-versioner som stöds (1809 och senare).

Kända begränsningar (fönster):

Grundläggande anpassningar av namnlister stöds inte i Windows 10. Dessa inkluderar BackgroundColor, InactiveBackgroundColor, ForegroundColor, InactiveForegroundColor och IconShowOptions. Om du anropar dessa egenskaper kommer de att ignoreras utan notis. Alla andra AppWindowTitleBar-API :er fungerar i Windows 10, version 1809 och senare. För textningsknappens färg-API:er (bland annat) och Höjd måste ExtendsContentIntoTitleBar anges till true, annars ignoreras de också tyst.

Åtkomstkontroll

Introducerade security.accesscontrol.h med funktionen GetSecurityDescriptorForAppContainerNames för att underlätta och effektivisera namngivna objektdelning mellan paketerade processer och allmänna Win32-API:er. Den här metoden tar en lista över paketfamiljenamn (PFN) och åtkomstmasker och returnerar en säkerhetsbeskrivning. Mer information finns i specifikationen GetSecurityDescriptorForAppContainerNames på GitHub.

Andra begränsningar och kända problem

• Enhetstester kan misslyckas med ett REGDB_E_CLASSNOTREG fel i utdatafönstret Tester i Visual Studio. Som en lösning kan du lägga till <WindowsAppContainer>true</WindowsAppContainer> i projektfilen.
• .NET PublishSingleFile stöds inte.
• Standardvärdena Bootstrapper och Undocked RegFree WinRT auto-initializer anges (nu) endast för projekt som skapar en körbar fil (OutputType=Exe eller WinExe). Detta förhindrar att automatiska initierare läggs till i DLL:er för klassbibliotek och andra icke-körbara filer som standard.
  • Om du behöver en automatisk initiering i en icke-körbar fil (t.ex. en DLL-test som läses in av en allmän körbar fil som inte initierar Bootstrapper) kan du uttryckligen aktivera en automatisk initialiserare i projektet via <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize> eller <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.
• Microsoft.WindowsAppRuntime.Release.Net.dll är alltid den binära Arm64-filen och fungerar inte för x86- och x64-appar. När du uttryckligen anropar Bootstrap-API:et använder du inte sammansättningen Microsoft.WindowsAppRuntime.Release.Net.dll. Som en lösning kan du inkludera versionskonstanter i den här källfilen som distribueras med NuGet-paketet: '.. \include\WindowsAppSDK-VersionInfo.cs' eller använd den automatiska initieraren.

Relaterade ämnen

• Senaste versionsinformation för förhandskanalen för Windows App SDK
• Senaste versionsinformation för experimentella kanalen för Windows App SDK
• Installera verktyg för Windows App SDK
• Skapa ditt första WinUI 3-projekt (Windows App SDK)
• Använda Windows App SDK i ett befintligt projekt
• Distributionsöversikt