Dela via

De senaste versionsanteckningarna för stabil kanal för Windows App SDK

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:

Nedladdningar för Windows App SDK

Obs

Windows App SDK Visual Studio Extensions (VSIX) distribueras inte längre som en separat nedladdning. De är tillgängliga på Visual Studio Marketplace i Visual Studio.

Version 1.8

I en befintlig Windows App SDK-app kan du uppdatera Nuget-paketet till 1.8.250907003 (se avsnittet Uppdatera ett paket i Installera och hantera paket i Visual Studio med Hjälp av NuGet Package Manager).

Du hittar den uppdaterade körmiljön och MSIX i Nedladdningar för Windows App SDK.

Version 1.8.2 (1.8.251003001)

Det här är den senaste tjänstversionen för version 1.8 av Windows App SDK.

Uppdaterad ONNX Runtime

onnxruntime.dll Uppdaterade till 1.23.1 och introducerade flera förbättringar av ONNX Runtimes Python- och C++-API:er, med fokus på förbättrad hantering av enhet och minnesinformation, stöd för synkroniseringsström och tensorkopieringsfunktioner. Den lägger till nya Python-bindningar för enhets-/minnestyper, exponerar mer detaljerade sessionsdata/utdatametadata och tillhandahåller ett Python-tillgängligt tensorkopierings-API. Ändringarna omstrukturerar också och utökar C++-API:et för bättre hantering av ström- och minnesinformation.

Viktiga förbättringar är:

  • Python-bindningar för OrtMemoryInfoDeviceType, OrtDeviceMemoryType och expanderade OrtDevice för att exponera minnestypen genom en ny mem_type-metod. OrtMemoryInfo Python-klassen stöder nu både äldre och nya V2-konstruktorer och exponerar ytterligare egenskaper som enhetsminnestyp och leverantörs-ID.
  • Utökade Python-objektet InferenceSession för att ge åtkomst till imput/utdata OrtMemoryInfo och OrtEpDevice objekt via nya egenskaper och metoder
  • Introducerade Python-bindningar för OrtSyncStream, inklusive skapande via OrtEpDevice.create_sync_stream() och hämtning av enhetsspecifika OrtMemoryInfo via OrtEpDevice.memory_info().
  • Omstrukturerade C++-API:et för att generalisera SyncStream hanteringen, vilket möjliggör obevakade strömmar och förbättrad typsäkerhet.
  • Lade till en ny python-nivåfunktion copy_tensors och motsvarande C++-bindning, vilket möjliggör effektiv kopiering av tensordata mellan OrtValue-objekt, om du vill använda en synkroniseringsström.
  • Ändrade returtypen för OrtValue.data_ptr metoden i Python-bindningen från int64_t till uintptr_t för bättre plattformsoberoende kompatibilitet.
  • Mindre förbättringar av felmeddelanden och enhetstyphantering i Python API (t.ex. för OrtDevice).
  • Åtgärdat gränsfall vid hantering av minnesinformation
  • Lösta mindre problem för att förbättra stabilitet och tillförlitlighet

Felkorrigeringar

  • Åtgärdade distributionshanterarkod för att rapportera det faktiska felet HRESULT för ökad tydlighet vid felsökning.

Version 1.8.1 (1.8.250916003)

Språkmodelltextgenerering

LanguageModel är nu tillgängligt med Phi Silica för att generera textsvar på generella användarfrågor med inbyggd innehållsmoderering. Phi Silica, Microsofts mest kraftfulla NPU-anpassade lokala språkmodell, är optimerad för effektivitet och prestanda på Windows Copilot+-datorer och erbjuder fortfarande många av funktionerna i stora språkmodeller (LLM).

Mer information finns i Kom igång med Phi Silica i Windows App SDK och API ref för Phi Silica i Windows App SDK .

Microsoft Windows ML

Med Windows ML kan utvecklare köra ONNX AI-modeller lokalt på Windows-datorer på en delad systemomfattande kopia av ONNX Runtime med hjälp av dynamiskt installerade maskinvaruspecifika körningsproviders.

Viktiga fördelar:

  • Hämta de senaste EP:er dynamiskt – Laddar och hanterar automatiskt de senaste hårdvaruspecifika utförandeleverantörerna
  • Delad ONNX Runtime – Använder systemomfattande runtime-miljö i stället för att paketera sin egen, vilket minskar appens storlek
  • Mindre nedladdningar/installationer – Du behöver inte ha stora EPs och ONNX Runtime i din app
  • Brett maskinvarustöd – Körs på alla Windows 11-datorer (x64 och ARM64) med valfri maskinvarukonfiguration

Nya API:er för 1.8.1

Den här versionen innehåller följande nya API:er jämfört med föregående 1.8-version:

Microsoft.Windows.AI.MachineLearning

    ExecutionProvider
    ExecutionProviderCatalog
    ExecutionProviderCertification
    ExecutionProviderReadyResult
    ExecutionProviderReadyResultState
    ExecutionProviderReadyState
    MachineLearningContract

Microsoft.Windows.AI.Text

    LanguageModel
        CreateContext
        GenerateEmbeddingVectors
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync
        GetUsablePromptLength
        GetVectorSpaceId

Kända problem

  • C#-utvecklare måste manuellt referera till NuGet-paketet System.Numerics.Tensors version 9.0.0 eller senare för att kunna använda Microsoft.ML.OnnxRuntime.Tensors. Utan den här NuGet-paketreferensen får du följande körningsfel när du anropar API:erna Microsoft.ML.OnnxRuntime.Tensors : Could not load file or assembly 'System.Numerics.Tensors, Version=9.0.0.0.

Version 1.8.0 (1.8.250907003)

Api:er för Windows AI

Windows App SDK innehåller nu en uppsättning API:er för artificiell intelligens (AI) som kan användas med en lokal språkmodell för att utföra en mängd olika uppgifter på Copilot+-datorer. Dina appar kan nu svara intelligent på frågor, identifiera text i bilder, beskriva innehållet i bilder, ta bort objekt från bilder med mera.

Information om ansvarsfulla utvecklingsmetoder som används vid skapandet av Windows AI-API:er, som också kan användas när du skapar AI-stödda funktioner, finns i Vägledningen utveckla ansvarsfull generativ AI-program och -funktioner i Windows .

Rapportering av storleksgräns för Windows AI-fråga

Gör att program kan avgöra om en indata överskrider den tillåtna storleken för ett Text Summarizer-anrop. Om indata är för stora returnerar API:et ett index som anger den aktuella gränsen, vilket gör det möjligt för utvecklare att justera indata i enlighet med detta. Den här gränsen baseras på antal token i stället för byte eller teckenlängd och kan variera över tid på grund av flera faktorer. Därför bör program behandla gränsen som dynamisk och kan komma att ändras.

Windows AI Textomskrivartjänst

** Möjliggör omskrivning av text med specifika tonlägen. Det avslappnade alternativet omformulerar innehåll för att låta mer informellt och konversationsrikt, med naturliga, spontana fraser samtidigt som mening och format bevaras. Det formella alternativet omvandlar text till en polerad, professionell version, som upprätthåller den ursprungliga strukturen och detaljerna med exakt språk som lämpar sig för formell kontext. Alternativet Allmänt behåller den ursprungliga tonen och avsikten, vilket säkerställer att innebörden förblir oförändrad.

Textinformation – konversationssammanfattning

Phi Silica har nu en sammanfattande konversationsfunktion som gör att du kan sammanfatta vad personer har sagt via e-post, chatt eller tråd. Mer information finns i Phi Silica .

Alternativ för konversationssammanfattning

Gör det möjligt för utvecklare att ange önskat utdataspråk för konversationssammanfattning. På så sätt kan program generera sammanfattningar på ett målspråk, förbättra lokaliseringen och användarupplevelsen.

Radera Windows AI-objekt

Objektradering kan användas för att ta bort objekt från bilder. Modellen tar både en bild och en gråskalemask som anger objektet som ska tas bort, raderar det maskerade området från bilden och ersätter det borttagna området med bildens bakgrund.

Decimaldatatyp

Det nya Decimal stödet erbjuder en numerisk datatyp med hög precision med bas-10 som är ovärderlig för finansiella och vetenskapliga beräkningar, vilket undviker imprecision och avrundningsfel som är inneboende i flyttalsdatatyper. Det är strukturerat som ett 96-bitars (12 byte) osignerat heltal, skalat med en variabel effekt på 10, vilket möjliggör exakt representation av decimalvärden. Detta möjliggör decimalstöd för programmeringsspråk som saknar decimaldatatyper och ger samverkan med språk som stöder decimaltecken (t.ex. C#, Python).

NuGet-metapaket

NuGet-paketet för Windows App SDK har konverterats till ett NuGet-metapaket. Varje komponent som bidrar till Windows App SDK är nu ett NuGet-komponentpaket och anges som ett beroende av metapaketet. På så sätt kan utvecklare välja antingen metapaket eller välja specifika komponentpaket för sina program. Med hjälp av enskilda komponentpaket kan utvecklare endast inkludera de API:er och funktioner som krävs för deras appar. Standardupplevelsen fungerar som om WindowsAppSDKSelfContained hade angetts som True, men paketet Microsoft.WindowsAppSDK.Runtime kan refereras till för att använda distribution av ramverkspaket.

Microsoft.Windows.SDK.BuildTools.MSIX Refactor

MSIX-publiceringsstödet har tagits med i ett fristående nuget-paket, som kan underhållas och användas separat av Windows App SDK och andra projekt. Dessutom har flera funktionsluckor med Single-Project lösningar åtgärdats, inklusive generering av MSIX-paket och MSIX-uppladdningspaket.

Lagringsväljare

API:et Microsoft.Windows.Storage.Pickers i Windows App SDK ger en moderniserad fil- och mappväljare för skrivbordsprogram. Det här API:et baseras på den befintliga API-designen för Windows.Storage.Pickers, men med viktiga förbättringar för skrivbordsscenarier. Det nya API:et Microsoft.Windows.Storage.Pickers åtgärdar två kritiska begränsningar för UWP-fil- och mappväljarna i appar som utvecklats med Windows App SDK/WinUI:

  • Stöd för upphöjd process: De befintliga API:erna för Windows.Storage.Pickers fungerar inte när programmet körs som administratör. Det nya API:et aktiverar val av fil och mapp i förhöjt läge.
  • Förenklad användning i WinUI 3: Om du använder befintliga UWP-väljare i WinUI 3 måste du initiera ett fönsterhandtag för fönsterassociation. De nya plockarna eliminerar detta krav genom att acceptera ett WindowId direkt i konstruktorn, vilket gör dem enklare att använda.

Andra viktiga ändringar

  • Före Windows App SDK 1.8 krävde paketerade appar som körs i AppContainer inte funktionen packageManagement på grund av ett problem med automatisk initiering av DeploymentManager. Det problemet har nu lösts, och i sin tur krävs funktionen packageManagement nu för AppContainer-baserade appar.
  • De experimentella WinML-API:erna har tagits bort från den här versionen och kommer att ingå i en framtida version.

Felkorrigeringar

  • Åtgärdade ett problem där hovringseffekterna av andra fönster för appen kunde flimra när minst ett fönster hade ExtendsContentIntoTitleBar inställt på sant.
  • NavigationView: Ett fel har åtgärdats där inställningen SelectedItem som null inte korrekt rensade markeringstillståndet i komprimerat läge.
  • TabView: Åtgärdade ett problem där att stänga en flik skulle flytta tangentbordsfokus till knappen "Lägg till flik" i stället för den nyligen valda fliken.
  • SplitButton: Fast inkonsekvens i användargränssnittet där SplitButton-kontrollen verkade kortare än standardknappkontroller
  • TabView: Åtgärdat problem Med TabView-avstånd i WinUI blir utfyllnad mellan rubriktexten och flikens vänstra/högra kanter ojämna när du ställer in egenskapen TabWidthMode för en TabView till SizeToContent.

Nya API:er för 1.8.0

Microsoft.Windows.AI.Foundation
 
    AIFoundationContract
    EmbeddingVector

Microsoft.Windows.AI.Imaging
 
    ImageObjectRemover
    ImageObjectRemoverContract

Microsoft.Windows.AI.Text
 
    ConversationItem
    ConversationSummaryOptions
    InputKind
    LanguageModelEmbeddingVectorResult
    TextRewriter
        RewriteAsync
 
    TextRewriteTone
    TextSummarizer
        IsPromptLargerThanContext
        SummarizeConversationAsync

Microsoft.Windows.Foundation
 
    DecimalContract
    DecimalHelper
    DecimalValue

Microsoft.Windows.Storage.Pickers
 
    FileOpenPicker
    FileSavePicker
    FolderPicker
    PickerLocationId
    PickerViewMode
    PickFileResult
    PickFolderResult
    StoragePickersContract

Microsoft.Windows.Widgets.Feeds.Providers
 
    FeedManager
        TryRemoveAnnouncementById
 
    IFeedManager3

Nya API:er jämfört med 1,8-preview1

Microsoft.Windows.AI.Text
 
    TextRewriteTone
        Concise

Microsoft.Windows.Foundation
 
    DecimalContract
    DecimalHelper
    DecimalValue

Arkiv över utgivningsanteckningar för stabila kanal-versioner

Expandera för länkar till arkiverade releasenoter för stabila kanalen