微軟宣布Windows社區(qū)工具包V7.1正式發(fā)布！

　　據(jù)了解 微軟公司在近日針對(duì)用戶推送了新的Windows社區(qū)工具包，在這次更新中包括了改進(jìn)和新功能。

　　如果您是 Toolkit 的新手，Windows Community Toolkit 是幫助程序、擴(kuò)展和自定義控件的集合。它簡(jiǎn)化并演示了為 Windows 構(gòu)建 UWP 和 .NET 應(yīng)用程序的常見(jiàn)開(kāi)發(fā)人員任務(wù)。該工具包是 .NET Foundation 的一部分。在開(kāi)始項(xiàng)目之前，您可以下載我們的示例應(yīng)用程序游樂(lè)場(chǎng)以發(fā)現(xiàn)和試用 Toolkit 組件。

　　此更新包括身份驗(yàn)證助手、Microsoft Graph 控件、在 XAML 中向應(yīng)用添加陰影的最簡(jiǎn)單方法、新的 RichSuggestBox 控件等等！我們甚至預(yù)覽了對(duì) MVVM Toolkit 庫(kù)的源生成器支持。

　　今年我們也有很多令人興奮的消息。請(qǐng)務(wù)必在我們上一篇關(guān)于WinUI 3 版本的文章中了解我們正在使用Windows 應(yīng)用程序 SDK做什么（當(dāng)時(shí)它仍被稱為 Project Reunion）。我們將來(lái)會(huì)有更多的更新——WinAppSDK 剛剛發(fā)布了他們的1.0 Preview 1 版本，以便他們達(dá)到他們的 1.0 版本，請(qǐng)繼續(xù)關(guān)注這里的更新。 我們還擴(kuò)大了我們的組織以使用 MAUI 社區(qū)工具包，并將很快將我們的 .NET 特定庫(kù)拆分為他們自己的 .NET 社區(qū)工具包，請(qǐng)?jiān)诖颂庨喿x所有相關(guān)內(nèi)容。

　　與往常一樣，請(qǐng)務(wù)必在此處閱讀我們的發(fā)行說(shuō)明。在下面查看有關(guān)這些更改和新功能的更多詳細(xì)信息。

　　Microsoft Identity Authentication Helpers、OneDrive Storage 和 Microsoft Graph Controls – 🏆 Shane Weaver

　　我們的 Microsoft Graph 產(chǎn)品是 7.1 的新功能和改進(jìn)，已脫離其先前的預(yù)覽階段，并通過(guò)新的幫助程序和提供程序進(jìn)行了徹底檢查和簡(jiǎn)化，以使用 Microsoft Identity 進(jìn)行身份驗(yàn)證和調(diào)用 Graph API。我們從社區(qū)收到了很多很好的反饋，我們希望這些反饋能幫助開(kāi)發(fā)人員開(kāi)始運(yùn)行、驗(yàn)證用戶身份和調(diào)用 Microsoft Graph API！

　　此外，請(qǐng)務(wù)必查看我們的完整 ContosoNotes 示例 ，其中展示了如何利用這些 API 并為用戶在其應(yīng)用程序和設(shè)備上創(chuàng)造出色的體驗(yàn)。

　　身份驗(yàn)證提供程序

　　在此版本中，我們引入了各種新的身份驗(yàn)證包：

　　*.Msal 包中可用的 MsalProvider 是 .NET Standard 2.0，可跨多個(gè)系統(tǒng)工作。此提供程序更適合支持跨平臺(tái)或復(fù)雜的身份驗(yàn)證方案。對(duì)于 UWP 應(yīng)用，請(qǐng)嘗試使用 WindowsProvider 以獲得更輕量級(jí)的包。

　　圖形驅(qū)動(dòng)控件和 OneDrive 助手

　　接下來(lái)，我們將以兩個(gè)新包的形式重新介紹我們的 Graph 控件和助手：

　　*.Graph 包包括 Graph 支持的擴(kuò)展和幫助程序，用于與 .NET Graph SDK 交互并向 Graph API 發(fā)出經(jīng)過(guò)身份驗(yàn)證的請(qǐng)求：

　　擴(kuò)展 – 在任何 IProvider 實(shí)例上調(diào)用 GetClient（） 或 GetBetaClient（） 以按需訪問(wèn)預(yù)先配置的 GraphServiceClient。

　　OneDriveStorageHelper 和 UserExtensionStorageHelper – 用于在基于圖形的存儲(chǔ)位置（例如 OneDrive 或圖形用戶對(duì)象上的打開(kāi)擴(kuò)展）中存儲(chǔ)設(shè)置和文件數(shù)據(jù)的新幫助程序。

　　同時(shí)，*.Graph.Uwp 包具有用于增強(qiáng)基于圖形的 UWP 應(yīng)用程序的用戶控件和幫助程序：

　　控件 – LoginButton、PeoplePicker 和 PersonView（GraphPresenter 仍處于試驗(yàn)階段。）

　　ProviderStateTrigger – 用于檢測(cè)全局身份驗(yàn)證提供程序何時(shí)登錄的 StateTrigger。

　　ElementExtensions.IsVisibleWhen – FrameworkElement 上的擴(kuò)展，用于聲明元素可見(jiàn)性行為以響應(yīng)身份驗(yàn)證更改。

　　附加陰影 – 🏆 Chris Blackman和Michael Hawker

　　移到 DropShadowPanel 上，你好 Attached Shadows！附加陰影可以更輕松地將這種出色的深度效果添加到您的應(yīng)用程序中，現(xiàn)在無(wú)需修改您的布局！他們甚至在 Microsoft Store 應(yīng)用程序中使用！

　　DropShadowPanel 是 Toolkit 中最流行的控件之一，但它的大問(wèn)題是它需要環(huán)繞要顯示陰影的內(nèi)容。這使得在開(kāi)發(fā)后期添加陰影變得棘手，因?yàn)樗鼤?huì)影響您對(duì)整個(gè)元素的布局。

　　現(xiàn)在有了附加的陰影，你可以把它們?nèi)鲈谌魏涡枰�的地方。它們甚至可以�?yīng)用于樣式以一次更新應(yīng)用程序中的多個(gè)元素！它們甚至與我們上次發(fā)布的新 XAML 動(dòng)畫系統(tǒng)掛鉤，因此一切都可以無(wú)縫協(xié)作！

　　此版本中有兩種類型的附加陰影：AttachedCardShadow 和 AttachedDropShadow。在此處閱讀我們的文檔，其中概述了最好在何處使用每種類型的陰影。

　　使用 Win2D 的 AttachedCardShadow

　　AttachedCardShadow 是一個(gè)基于矩形的陰影（支持圓角），可以直接應(yīng)用于元素而無(wú)需任何其他配置。如果您不介意它需要的 Win2D 依賴項(xiàng)，它應(yīng)該是您新的首選陰影選項(xiàng)。

　　使用組合的 AttachedDropShadow

　　AttachedDropShadow 支持透明圖像、形狀和文本的遮罩陰影。它使用組合層，因此可以與任何 UWP 應(yīng)用一起使用。它繼承了 DropShadowPanel 的實(shí)現(xiàn)，但它的工作方式有點(diǎn)不同。請(qǐng)務(wù)必查看我們的文檔和示例以了解更多信息。

　　RichSuggestBox – 🏆 Tung Huynh

　　RichSuggestBox 是一個(gè) RichEditBox，它提供了能夠從建議列表中選擇標(biāo)記的附加功能，例如“@”在聊天消息中提及某人或標(biāo)記要包含在注釋中的文檔。它提供了與我們的 TokenizingTextBox 控件提供的類似模式，但它不僅僅用于一組固定元素，它還允許更多自由格式的文本輸入散布元數(shù)據(jù)。

　　WinUI 2.7 和其他改進(jìn)！

　　我們已更新為基于新 WinUI 2.6 和 2.7 更新的控制包，其中還包括更新的樣式。隨著時(shí)間的推移，我們將繼續(xù)使用新的設(shè)計(jì)指南更新我們的控件樣式。

　　🏆 Rosario Pulella 和 🏆 Darren Batchelor更新了對(duì) WinUI 2.6 的 依賴

　　更新 顏色拾取 由 🏆羅伯特Looyengoed 和 TabbedCommandBar 通過(guò) 🏆耀西Askharoun 使用WinUI控件基地。

　　新 MetadataControl 通過(guò) 🏆文森特Gromfeld

　　🏆 Chris Blackman和 《 🦙 /》 Michael Hawker 的新 ConstrainedBox 控件（也在 Microsoft Store 應(yīng)用程序中使用�。�

　　SmoothScrollIntoView延伸 通過(guò) 🏆維杰尼爾默爾

　　AutoSelectBehavior 通過(guò) 🏆朱利安Brianceau

　　上一個(gè)版本 由 🏆 Emiliano Magliocca 安裝

　　ListDetailsView使用兩個(gè)窗格視圖通過(guò)🏆 費(fèi)邊紹特

　　ControlSizeTrigger視覺(jué)狀態(tài)觸發(fā)器🏆 Daniel Paulino

　　KeyDownTriggerBehavior by 🏆 Sébastien Lachance

　　在地平線上

　　MVVM 源生成器 ［預(yù)覽］ – 🏆 Sergio Pedri

　　MVVM 工具包現(xiàn)在支持 源生成器（預(yù)覽版）。這使庫(kù)更靈活、更易于使用， 甚至更高效！

　　以下是一些正在運(yùn)行的源生成器屬性的小示例。在 左側(cè) 是使用MVVM工具包，你今天會(huì)原來(lái)手寫的例子。在 右邊 的是你如何使用新的屬性自動(dòng)生成完全相同的代碼！

　　您已經(jīng)可以看到 Source Generators 可以使您免于編寫額外的“樣板”類型代碼的影響！🤯

　　這一全新功能的開(kāi)發(fā)與 MVVM 工具包的原始核心原則相同：模塊化和“點(diǎn)菜”。這意味著源生成器支持與 MVVM 工具包捆綁在一起，但仍然是完全可選的：您可以在任何地方自由使用它，根據(jù)需要混合和匹配，或者完全忽略它；這完全取決于你！

　　以下是新功能的細(xì)分：

　　在 ［ObservableProperty］屬性創(chuàng)建從僅僅場(chǎng)和注釋創(chuàng)建觀察特性的超緊湊的方式。 ［AlsoNotifyChangeFor］ 還可用于為另一個(gè)依賴屬性引發(fā)更改通知。

　　在 ［ICommand接口］ 屬性將讓你在一個(gè)視圖模型注釋的方法和生成所有相應(yīng)的命令屬性。這包括對(duì)通用命令和異步命令的支持：只需注釋返回任務(wù)的異步方法即可！

　　您還可以使用［INotifyPropertyChanged］、 ［ObservableObject］、 ［ObservableRecipient］或 ［ObservableValidator］注釋一個(gè)類， 以注入使用這些 MVVM 助手所需的所有樣板代碼，同時(shí)仍然從其他基類繼承！您還可以使用它來(lái)混合繼承自 ObservableRecipient ，然后添加 ［ObservableValidator］ 屬性以組合來(lái)自兩個(gè)類的所有 API。

　　在新功能和性能改進(jìn)方面，未來(lái)還有更多計(jì)劃！

　　介紹 Toolkit 實(shí)驗(yàn)室 🧪

　　隨著 Windows 社區(qū)工具包的發(fā)展，我們提高了代碼質(zhì)量和用于審查引入的新功能的過(guò)程的標(biāo)準(zhǔn)。這有助于我們的社區(qū)知道他們?cè)谖覀兊拿總�(gè)版本中都獲得了高質(zhì)量的項(xiàng)目，但它可能會(huì)減慢我們的創(chuàng)新步伐。

　　創(chuàng)新一直是工具包的生命。快速原型化想法、收集社區(qū)反饋和運(yùn)送人們需要的東西對(duì) Toolkit 的工作方式起到了重要作用。為此，我們推出了“社區(qū)工具包實(shí)驗(yàn)室”。

　　實(shí)驗(yàn)室將是我們可以在正常代碼庫(kù)和交付周期之外的安全空間中孵化和開(kāi)發(fā)新功能的地方。在不必?fù)?dān)心在 Toolkit 中發(fā)布完全充實(shí)的想法和功能所需的文檔、示例和測(cè)試之前，開(kāi)始編寫代碼和與他人協(xié)作會(huì)更容易。

　　將來(lái)，我們計(jì)劃建立一個(gè)集中的 Labs 存儲(chǔ)庫(kù)，用于提議、孵化和與社區(qū)合作的較小功能和控件。請(qǐng)留意未來(lái)有關(guān)這個(gè)新空間的更多信息。

　　我們將在我們的公共 DevOps 包提要中為 Toolkit Labs 提供一個(gè)專用的 NuGet 提要。您可以在我們的 Wiki 上找到有關(guān)這些類型的 預(yù)覽源的更多信息。

　　我們可能還有更大的想法，在實(shí)驗(yàn)室的旗幟下有自己的存儲(chǔ)庫(kù)，就像我們今天介紹的第一個(gè)。。。。。。

　　智能 API – 🏆 Amrutha Srinivasan

　　“智能 API”是一個(gè)項(xiàng)目，其目標(biāo)是讓開(kāi)發(fā)人員更容易在他們的應(yīng)用程序中利用機(jī)器學(xué)習(xí)，而無(wú)需 ML 專業(yè)知識(shí)！通過(guò)僅導(dǎo)入 NuGet 包并調(diào)用函數(shù)，我們希望開(kāi)發(fā)人員能夠構(gòu)建智能應(yīng)用體驗(yàn)，而無(wú)需處理在 Windows 上創(chuàng)建和使用機(jī)器學(xué)習(xí)模型的復(fù)雜性。

　　我們目前正在通過(guò)將兩個(gè)現(xiàn)有的最先進(jìn)模型包裝到 NuGet 包中來(lái)試驗(yàn)這個(gè)概念。它們使開(kāi)發(fā)人員能夠通過(guò)單個(gè)函數(shù)調(diào)用快速輕松地將圖像分類和對(duì)象檢測(cè)功能添加到他們的項(xiàng)目中。

　　在此處了解有關(guān)如何開(kāi)始使用智能 API 的更多信息。

　　凝視控制 – 🏆 Harish Kulkarni

　　這些新的凝視控件可以為主要輸入形式是使用眼睛的用戶提供支持。這些控件首先設(shè)計(jì)用于 Gaze 交互，高于其他形式的輸入。它們包括一個(gè) FilePicker、一個(gè)鍵盤和一個(gè)滾動(dòng)條。在此處了解更多信息或?yàn)樗麄兊膶Ｓ么鎯?chǔ)庫(kù)做出貢獻(xiàn)。

　　Windows 應(yīng)用 SDK 預(yù)覽（正式名稱為 Project Reunion）

　　正如您所希望的那樣，我們一直在提供適用于 WinUI 3 的 Toolkit 版本以及它們作為Windows App SDK 的一部分的版本。我們發(fā)布了一個(gè)工具包版本，它適用于 Windows App SDK 0.8.4 版本的帶有 .NET 的桌面應(yīng)用程序。在此處了解有關(guān)如何嘗試此操作的更多詳細(xì)信息，提醒這些基于 WinUI 3 的軟件包使用CommunityToolkit.WinUI.*作為根目錄，而不是Microsoft.Toolkit.UWP。我們將在未來(lái)提供有關(guān)即將發(fā)布的 1.0 版本支持的更多信息，并計(jì)劃發(fā)布包含我們 7.1 更改的更新。

　　今天就開(kāi)始吧！🎉

　　此版本中有大量修復(fù)、其他幫助程序和來(lái)自我們社區(qū)的全面改進(jìn)，因此請(qǐng)務(wù)必訪問(wèn)我們的發(fā)行說(shuō)明以了解所有詳細(xì)信息！

　　提醒一下，您可以按照我們的 docs.microsoft.com 教程開(kāi)始使用，或者通過(guò)從 Microsoft Store安裝Windows Community Toolkit Sample App（它也鏈接到每個(gè)文檔頁(yè)面）來(lái)預(yù)覽最新功能。如果您想做出貢獻(xiàn)，請(qǐng)加入我們的 GitHub并查看我們的 Wiki！要關(guān)注 Twitter 上的對(duì)話，請(qǐng)使用#CommunityToolkit主題標(biāo)簽或加入我們的UWP Community Discord頻道！

　　快樂(lè)編碼！《 🦙 /》