我們很高興地宣布 .NET Community Toolkit 8.1 版正式發(fā)布！這個新版本包括呼聲很高的新功能、bug 修復(fù)和對 MVVM 工具包源代碼生成器的大量性能改進(jìn)，使開發(fā)人員在使用它們時的用戶體驗比以往更好！?

就像在我們之前的版本中一樣，我們非常感謝 Microsoft 使用該工具包的團(tuán)隊以及社區(qū)中的其他開發(fā)人員收到的所有反饋，這些反饋已經(jīng)并將繼續(xù)對我們?nèi)绾卧O(shè)計所有新功能和改進(jìn)并確定其優(yōu)先級產(chǎn)生巨大影響。我們非常感謝每一位做出貢獻(xiàn)并不斷幫助 .NET Community Toolkit 變得更好的人！
?

.NET 社區(qū)工具包中有什么？

?

正如我們在之前的公告帖子中所做的那樣，讓我們首先簡要回顧一下 .NET Community Toolkit 包含的內(nèi)容。它由幾個獨(dú)立的庫組成：

• CommunityToolkit.Common
• CommunityToolkit.Mvvm?(又名“Microsoft MVVM Toolkit”)
• CommunityToolkit.Diagnostics
• CommunityToolkit.HighPerformance

這些庫還廣泛用于 Windows 附帶的多個收件箱應(yīng)用程序，例如 Microsoft Store 和照片應(yīng)用程序！

有關(guān) .NET Community Toolkit 歷史的更多詳細(xì)信息，請訪問我們之前的8.0.0公告帖子的鏈接。

以下是 .NET Community Toolkit 新 8.1 版中包含的主要更改的部分。

?

自定義屬性?[ObservableProperty]

?

正如我們在8.1.0預(yù)覽版1公告博客文章中提到的，對于 MVVM 工具包源代碼生成器，我們最需要的功能之一（請參閱#208、#217、#228）是支持對[ObservableProperty]使用自定義屬性。有幾個提議的設(shè)計來支持這一點(diǎn)，我們最終決定利用 C# 中的現(xiàn)有語法?“property”:?來讓開發(fā)人員標(biāo)記屬性以傳播到生成的屬性。有幾個優(yōu)勢：

• 它利用內(nèi)置的 C# 語法，使該功能感覺“原生”并且不需要額外的屬性
• 它解決了注解屬性只能針對屬性，不能針對字段的問題

也就是說，使用 MVVM Toolkit 8.1，現(xiàn)在支持以下場景:

[ObservableProperty] 
[property: JsonPropertyName("responseName")] 
[property: JsonRequired] 
private string? _name; 

這將在幕后生成以下屬性：

[JsonPropertyName("responseName")] 
[JsonRequired] 
public string? Name 
{ 
    get => _name; 
    set 
    { 
        if (!EqualityComparer<string?>.Default.Equals(_name, value)) 
        { 
            OnPropertyChanging("Name"); 
            OnNameChanging(value); 
 
            _name = value; 
 
            OnPropertyChanged("Name"); 
            OnNameChanged(value); 
        } 
    } 
} 
 
partial void OnNameChanging(string? value); 
partial void OnNameChanged(string? value);

可以看到生成的屬性有我們指定的兩個屬性！這允許完全靈活地為生成的屬性添加注釋，同時使用內(nèi)置的 C# 語法并且對該功能支持的屬性類型沒有限制。

注意：生成的代碼略有不同，包括此處未顯示的其他性能優(yōu)化。

您可以在鏈接找到我們關(guān)于新源代碼生成器的所有文檔。

?

MVVM 工具包分析器

?

此版本的 MVVM 工具包也是第一個引入專用分析器的版本。它能夠幫助開發(fā)人員以最佳方式使用 MVVM 工具包。也就是說，MVVM 工具包將不再只是針對使用錯誤的功能發(fā)出診斷（例如，以報錯的方式），它現(xiàn)在還會顯示改進(jìn)代碼和避免常見錯誤的建議！

第一個分析器涵蓋了使用[ObservableProperty]屬性時的一個常見錯誤。參照這個例子：

[ObservableProperty]
private string? name;

[RelayCommand]
public async Task LoadUserAsync()
{
    User user = await _userService.FetchUserAsync();

    name = user.Name; // Whoops! Assigning to the field!
}

開發(fā)人員不小心分配給一個字段（而不是生成的屬性），然后被卡在 UI 上。UI 上沒有顯示該更改，也沒有明確說明為什么會這樣，這一情景已經(jīng)被多次提出。新的分析器將在這些情況下提供幫助，它將標(biāo)記支持可觀察屬性的字段的所有賦值，并顯示診斷建議引用生成的屬性。你不會再收到莫名其妙的屬性丟失的通知。

第二個新分析器旨在幫助減少使用 MVVM 工具包的應(yīng)用程序中的二進(jìn)制文件大小。正如我們在8.0.0 公告帖子中提到的，MVVM 工具包包含多個屬性（例如[ObservableObject]），這些屬性允許生成器將實現(xiàn) INotifyPropertyChanged 和 INotifyPropertyChanging 接口所需的所有代碼（也可選擇使用其他幫助程序）注入現(xiàn)有類。

這僅適用于無法繼承的情況：如果您不屬于這種情況，您應(yīng)該選擇繼承 ObservableObject，從而減小的二進(jìn)制文件大小，因為編譯器不必在每個過程中一遍又一遍地復(fù)制那些相同的助手類型。請參閱這個例子：

[ObservableObject]
public partial class MyViewModel
{
    [ObservableProperty]
    private string? name;
}

這里，MyViewModel 不是從任何類型繼承而來，因此它應(yīng)該繼承 ObservableObject 而不是使用[ObservableObject]屬性，以此改進(jìn)二進(jìn)制大小。新的分析器將標(biāo)記所有與此類似的場景并建議改用繼承。這將特別有助于初學(xué)者，他們可能不了解兩種不同方法的細(xì)微差別并且可能不知道如何選擇。在這些情況下，現(xiàn)在分析器可以提供幫助。

?

MVVM 工具包源代碼生成器優(yōu)化

?

正如我們提到的，這個新版本還包括對 MVVM 工具包的主要性能優(yōu)化，以進(jìn)一步改善開發(fā)人員的用戶體驗，尤其是優(yōu)化了開發(fā)人員在處理非常大的解決方案時的體驗。我們花了很多時間改進(jìn)我們所有生成器的架構(gòu)，并與 Roslyn 團(tuán)隊的工程師交談，以確保我們正在盡可能地發(fā)揮它們的性能。

以下只是我們在這方面所做的一部分改進(jìn)：

• 為 Roslyn 4.3 添加了多目標(biāo)（#428，#462）：如果支持，MVVM 工具包源代碼生成器現(xiàn)在將使用 Roslyn 4.3 目標(biāo)，這樣他們就可以在主機(jī)支持的情況下選擇加入一些更優(yōu)化的 API。這一功能在引用 MVVM 工具包時會自動啟用。
• 使用 ForAttributeWithMetadataName<T>（#436）：我們將生成器切換到新的高級 Roslyn API 以匹配屬性，這大大提高了生成器觸發(fā)特定屬性的性能。比如現(xiàn)在[ObservableProperty]就在用這個。
• 將診斷移入診斷分析器（#433，#434）：我們將幾乎所有診斷都移動到診斷分析器，這些診斷分析器在進(jìn)程外運(yùn)行并且獨(dú)立于源生成器。這樣能夠顯著減少鍵入時的overhead，因為所有診斷邏輯現(xiàn)在都在單獨(dú)的進(jìn)程中運(yùn)行，并且不會降低 IntelliSense 的速度。
• 停止在增量提供程序中使用符號(?#435?)：我們更新了所有增量提供程序以不再傳播符號。這可以減少內(nèi)存使用，因為傳播符號會導(dǎo)致 Roslyn 不必要地根編譯對象。
• 更多性能優(yōu)化（#447、#460、#469、#487、#489）：我們徹底檢查了所有增量模型和增量管道，以顯著提高性能并減少內(nèi)存分配。

?

IObservable<T>?信使擴(kuò)展

?

另一個功能需求，尤其是由那些在應(yīng)用程序中大量使用響應(yīng)式 API 開發(fā)人員提出，是尋求一種方法來橋接 MVVM 工具包中的功能。界面的新擴(kuò)展?IObservable<T>?extensions?現(xiàn)在支持此功能。它們可以按如下方式使用：

IObservable<MyMessage> observable = Messenger.CreateObservable<MyMessage>();

就像這樣！此擴(kuò)展將創(chuàng)建一個對象 IObservable<T>?，該對象可用于訂閱消息并對其做出動態(tài)反應(yīng)。還支持通過單獨(dú)的重載指定不同的標(biāo)記。這面這個示例展示了新 API 的端到端使用：

var token = 
    Messenger 
    .CreateObservable<MyMessage>() 
    .Where(...) 
    .Subscribe(m => Console.WriteLine($"Hello {m.Username}!")); 

?

.NET 7和 C# 11支持

?

.NET Community Toolkit 工具包的新發(fā)布版本還將 .NET 7 TFM 添加到高性能包中，新版本中還包括一些變動，主要對新的 C# 11語言功能進(jìn)行了改善，比如?ref?fields?就是一個典型。

以下類型現(xiàn)在不再處于預(yù)覽狀態(tài)，以及更新使用了新的 ref?安全規(guī)則：

• Ref<T>
• ReadOnlyRef<T>
• NullableRef<T>
• ReadOnlyNullableRef<T>

下面這種場景可以使用這些規(guī)則:

public static bool TryGetElementRef(out NullableRef<T> reference) 
{ 
    // Logic here... 
} 

也就是說，使用?NullableRef<T>?類型規(guī)則可以有效地讓方法具有 out?ref?T?參數(shù), 而這在 C# 中是無法通過表達(dá)式做到的. 我們還計劃擴(kuò)展這些類型的 API 淺層面，從而允許這些類型通過使用 Unsafe 類型，提供一種易于使用的替代 GC-ref 算法的方法，這在視覺上也更類似于傳統(tǒng)的指針?biāo)惴ā?/p>

此外，所有不在預(yù)覽模式中的 ref?struct?類型都已被更新，使用內(nèi)部的 ref?字段實現(xiàn)更好的性能。這些類型包括：

• Span2D<T>
• ReadOnlySpan2D<T>
• RefEnumerable<T>
• ReadOnlyRefEnumerable<T>
• SpanEnumerable<T>
• ReadOnlySpanEnumerable<T>

?

其他變化

?

新版本中包含更多內(nèi)容！?您可以在?GitHub release page?發(fā)布頁面中查看完整的變更日志。

您可以在?GitHub repo?找到所有的源代碼，也能在?MS Learn?上找到一些手寫文檔， 還能在 .NET API 瀏覽器網(wǎng)站中找到完整的 API 參考文檔。如果您想為新版本的改善貢獻(xiàn)自己的力量, 請隨時提問題或聯(lián)系我們，讓我們知道您的體驗！

如果您想了解有關(guān) MVVM 工具包的更多信息，您還可以觀看最近?.NET Conf 2022?中的視頻。

新版本中有整套可用的 Toolkit-s 生態(tài)系統(tǒng)，其中有大量有用的 API 可用于構(gòu)建 .NET 應(yīng)用程序。祝您編碼愉快!??文章來源地址http://www.zghlxwxcb.cn/news/detail-440834.html

到了這里，關(guān)于宣布推出 .NET 社區(qū)工具包 8.1！的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！