Windows 應用程式 SDK 1.5 的預覽通道版本資訊

重要

預覽通道已經不支援使用在生產環境，且使用預覽版本的應用程式無法發布到 Microsoft Store。

預覽通道包含 Windows 應用程式 SDK 版本，其中包括處於開發後期階段的預覽通道功能。 預覽版本不包含實驗性功能和 API，但在下一個穩定版本之前仍可能會發生重大變更。

重要連結：

• 如果想要將現有應用程式從舊版的 Windows 應用程式 SDK 升級至較新版本，請參閱將現有專案更新至最新版本的 Windows 應用程式 SDK。
• 如需預覽版本相關文件，請參閱 Windows 應用程式 SDK 預覽與實驗通道的安裝工具。

最新預覽通道版本：

• Windows 應用程式 SDK 的最新預覽通道版本資訊

最新穩定通道版本：

• Windows 應用程式 SDK 的最新穩定通道版本資訊

1.5 版 Preview 1 (1.5.0-preview1)

這是預覽通道為 1.5 版發布的最新版本。

在現有的 Windows 應用程式 SDK 1.4 版 (來自穩定通道) 應用程式中，您可以將 Nuget 套件更新為 1.5.0-preview1 (請參閱在 Visual Studio 使用 NuGet 套件管理員安裝與管理套件中的更新套件一節)。

如需更新的執行階段和 MSIX，請參閱 Windows 應用程式 SDK 的下載項目。

XAML Islands 執行階段和關閉更新

• 以 XAML Islands 為基礎的 WinAppSDK 1.4 和 WinAppSDK 1.5 應用程式在關閉任何執行緒的最後一個 XAML 視窗時，會有不同的行為。
  • 在 WinAppSDK 1.4，執行緒的最後一個 XAML 視窗關閉時，XAML 執行階段一律會退出執行緒的事件迴圈。
  • 而在 WinAppSDK 1.5：
    • 如果是 WinUI 桌面應用程式，預設行為仍然和 WinAppSDK 1.4 一樣。
    • 如果您將 XAML 用於 DesktopWindowXamlSource (「XAML Islands」) API，現在的預設行為是 XAML 不會自動退出執行緒的事件迴圈。
    • 在兩種模式，您都可以設定 Application.DispatcherShutdownMode 屬性來變更行為。
  • 如需更多資訊，請在文件仍提供期間參閱文件了解 Application.DispatcherShutdownMode 屬性。
• 以 XAML Islands 為基礎的 WinAppSDK 1.4 和 WinAppSDK 1.5 應用程式在 XAML 執行階段的存留期方面，有不同的行為。
  • 在 WinAppSDK 1.4，如果特定執行緒的所有 WindowsXamlManager 和 DesktopWindowXamlSource 物件都已關閉，或在執行緒上執行的 DispatcherQueue 已關閉 (XAML 執行階段在 DispatcherQueue.FrameworkShutdownStarting 階段關閉)，執行緒的 XAML 執行階段就會關閉。
  • 在 WinAppSDK 1.5，在執行緒上執行的 DispatcherQueue 關閉 (XAML 執行階段在 DispatcherQueue.FrameworkShutdownStarting 階段關閉)，執行緒的 XAML 執行階段才會關閉。
  • 如需更多資訊，請在文件仍提供期間參閱文件了解 WindowsXamlManager 類別。

WinUI 地圖控制項

WinUI Maps 控制項的初始版本已經發布了！ 此控制項由 WebView2 和 Azure Maps 驅動，可提供下列功能：

• 以地圖按鈕或觸控方式移動與縮放。
• 將地圖樣式變更為衛星、地形或街道檢視。
• 以程式設計方式將可互動釘選與開發人員可自定義的圖示新增至地圖。
• 開發人員可自訂地圖初次載入時的置中位置。
• 開發人員可控制要隱藏或顯示移動、縮放和地圖樣式的按鈕。

注意

若要使用 Maps 控制項，您需要 Azure 地圖金鑰。 如要建立金鑰，請參閱 Azure 地圖文件中建立 Web 應用程式的頁面。

Maps 控制項是全新功能，如有意見，歡迎告知我們，以便評估日後調整方向！

WinAppSDK 提供的其他新功能

• 已新增 PublishSingleFile 部署模型的支援功能。 如需 PublishSingleFile 詳細資訊，請參閱單一檔案部署文件。

錯誤修正

• 已修正 1.5-experimental2 版本中投影 DLL 無法產生的問題。 關於更多資訊，請參閱 GitHub 問題 #4152。
• 已修正 RichEditBox 文字格式化快顯示窗的省略符號按鈕無法正確顯示動作清單的問題。 關於更多資訊，請參閱 GitHub 問題 #9140。
• 已修正 ListView 無法正確處理鍵盤加速器的問題。 關於更多資訊，請參閱 GitHub 問題 #8063。
• 已修正使用 AccessKey 關閉視窗時的存取違規問題。 關於更多資訊，請參閱 GitHub 問題 #8648。
• 已修正 MenuBar 中的 MenuFlyoutItem 文字對齊受到影響的問題。 關於更多資訊，請參閱 GitHub 問題 #8755。
• 已修正反白文字無法在按右鍵時維持反白的問題。 關於更多資訊，請參閱 GitHub 問題 #1801。
• 已修正閒置視窗關閉時造成應用程式當機的問題。 關於更多資訊，請參閱 GitHub 問題 #8913。
• 已修正以滑鼠中鍵滑動並隨後立即按左鍵時導致應用程式停格的問題。 關於更多資訊，請參閱 GitHub 問題 #9233。

1.5.0-Preview1 的新 API

1.5-preview1 版與 Stable 1.4 版本相比，多了以下新 API：

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

Microsoft.UI.Input
 
    FocusNavigationReason
    FocusNavigationRequest
    FocusNavigationRequestEventArgs
    FocusNavigationResult
    InputFocusController
        DepartFocus
        NavigateFocusRequested
 
    InputFocusNavigationHost

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode

    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel

    DispatcherShutdownMode
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

Microsoft.UI.Xaml.Controls
 
    MapControl
    MapControlMapServiceErrorOccurredEventArgs
    MapElement
    MapElementClickEventArgs
    MapElementsLayer
    MapIcon
    MapLayer
    SelectorBar
    SelectorBarItem
    SelectorBarSelectionChangedEventArgs
    WebView2
        EnsureCoreWebView2Async
        EnsureCoreWebView2Async

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        GetForCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Web.WebView2.Core
 
    CoreWebView2
        FrameId

    CoreWebView2AcceleratorKeyPressedEventArgs
        IsBrowserAcceleratorKeyEnabled

    CoreWebView2BrowserExtension
    CoreWebView2BrowsingDataKinds
        ServiceWorkers

    CoreWebView2CustomSchemeRegistration
        CoreWebView2CustomSchemeRegistration (String)
        AllowedOrigins
        SchemeName

    CoreWebView2Environment
        GetProcessExtendedInfosAsync

    CoreWebView2EnvironmentOptions
        AreBrowserExtensionsEnabled
        CustomSchemeRegistrations

    CoreWebView2Frame
        FrameId

    CoreWebView2FrameInfo
        FrameId
        FrameKind
        ParentFrameInfo

    CoreWebView2FrameKind
    CoreWebView2MouseEventKind
        NonClientRightButtonDown
        NonClientRightButtonUp

    CoreWebView2NavigationKind
    CoreWebView2NavigationStartingEventArgs
        NavigationKind

    CoreWebView2NewWindowRequestedEventArgs
        OriginalSourceFrameInfo

    CoreWebView2ProcessExtendedInfo
    CoreWebView2Profile
        AddBrowserExtensionAsync
        Delete
        Deleted

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    EnsureReadyOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetRuntimeDisposition
    PackageVolume
    ProvisionPackageOptions
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

Microsoft.Windows.Widgets.Feeds.Providers
 
    CustomQueryParametersRequestedArgs
    CustomQueryParametersUpdateOptions
    FeedDisabledArgs
    FeedEnabledArgs
    FeedManager
    FeedProviderDisabledArgs
    FeedProviderEnabledArgs
    FeedProviderInfo
    IFeedManager
    IFeedProvider

相關主題

• Windows 應用程式 SDK 的最新穩定通道版本資訊
• Windows 應用程式 SDK 最新實驗通道版本資訊
• 安裝 Windows 應用程式 SDK 的工具 (機器翻譯)
• 建立您的第一個 WinUI 3 (Windows 應用程式 SDK) 專案
• 在現有的專案中使用 Windows 應用程式 SDK
• 部署概觀