Ми раді повідомити про офіційний запуск версії 8.2 інструментарію .NET Community Toolkit! Ця нова версія містить покращення швидкості роботи як під час виконання, так і в генераторах вихідного коду MVVM Toolkit, нові засоби для усунення помилок, що підвищують вашу результативність, нові функції на основі запитів користувачів та багато іншого!

Що входить до інструментарію .NET Community Toolkit?

Інструментарій .NET Community Toolkit містить наступні бібліотеки:

• CommunityToolkit.Common

• CommunityToolkit.Mvvm (також відомий як “Microsoft MVVM Toolkit”)

• CommunityToolkit.Diagnostics

• CommunityToolkit.HighPerformance

Ці компоненти також широко використовуються в деяких програмах для роботи з вхідними повідомленнями, які постачаються з Windows, зокрема у Microsoft Store і програма “Photos”!

Для більш детальної інформації про історію розвитку інструментарію .NET Community Toolkit, ось посилання на попередній пост з анонсом версії 8.0.0.

 

Перелік основних змін, які включені в нову версію 8.2 інструментарію .NET Community Toolkit.

Користувацькі атрибути для [RelayCommand]

Продовжуючи роботу, виконану у випуску 8.1.0, і як було запропоновано на GitHub, новий випуск 8.2.0 набору інструментів MVVM Toolkit містить підтримку користувацьких атрибутів при використанні [RelayCommand]. Знову ж таки, було використано нативне field: і property: C#, щоб вказати цільові значення користувацьких атрибутів. Завдяки цьому ви тепер маєте повний контроль над атрибутами для всіх згенерованих членів, коли використовуєте [RelayCommand] для створення команди MVVM.

Наприклад, це особливо корисно, коли ви використовуєте модель подання, яка має підтримувати серіалізацію JSON, і вам потрібно явно ігнорувати згенеровану властивість. Ви можете використовувати підтримку нового  field: і property: наступним чином:

Після цього будуть створені наступні елементи:

Як і слід було очікувати, згенерована властивість DoWorkCommand має вказаний атрибут над нею! І, звичайно ж, підтримуються атрибути з будь-якою кількістю конструкторів та іменованих параметрів. Ви також можете використовувати просто field:, property:  поле:або будь-яку їх комбінацію

Ви можете знайти всі документи про нові генератори вихідних кодів тут, а якщо ви віддаєте перевагу відеоверсії, Джеймс Монтемагно також зробив кілька відео про них, наприклад, це.

Нові змінені перехоплення [ObservableProperty]

Відносно поширеним сценарієм у MVVM є наявність деякої властивості “вибраний елемент”, яка представляє, наприклад, поточного вибраного користувача або вкладену модель представлення. Коли значення цієї властивості змінюється, нерідко доводиться вносити певні корективи до старого та нового екземплярів. Наприклад, встановити якусь “вибрану” властивість, або підписатися на подію, і так далі.

Раніше це був сценарій, де використання [ObservableProperty] не було ідеальним, оскільки воно не мало необхідної інфраструктури, щоб легко впровадити таку логіку для виконання необхідних змін стану для старих і нових значень, що встановлюються. Щоб виправити це, починаючи з версії 8.2 MVVM Toolkit, для всіх полів [ObservableProperty] генеруються два нові змінені перехоплення властивостей.

 

Наприклад, розглянемо наступний код:

Тепер буде згенеровано такий код:

Зверніть увагу на два нові методи “OnPropertyNameChanging” і “Changed”, що генеруються, тепер вони також приймають попереднє значення. Ці два методи є простими у використанні перехопленнями для додавання коду, який спрацьовує при кожній події зміни властивості й може змінювати як старе, так і нове значення, що встановлюється. Наприклад, ви можете використовувати їх наступним чином:

І це все, що вам потрібно! Вибрана модель перегляду тепер завжди буде коректно повідомлятися як вибрана. Вам більше не потрібно повертатися до використання ручної властивості у подібних сценаріях, [ObservableProperty] тепер має вбудовану підтримку і для цього!

Примітка: MVVM Toolkit автоматично визначить, чи використовуєте ви будь-який з цих методів, щоб максимально оптимізувати кодову структуру. Крім того, виклики методів, які не реалізовані, будуть просто видалені компілятором Roslyn, тому вся ця функція є повністю платною!

Фіксери коду MVVM Toolkit

У попередньому випуску MVVM Toolkit було додано два нових діагностичних аналізатора, які видають попередження при некоректному доступі до поля, позначеного [ObservableProperty], а також при оголошенні типу з [ObservableProperty] і подібними атрибутами, коли доступне використання наслідування. У версії 8.2 ці два аналізатори також містять вбудовані засоби для виправлення коду!

Тобто, коли будь-який з них видає попередження, ви можете просто навести курсор на лампочку IntelliSense, вибрати виправлення коду й автоматично застосувати всі необхідні зміни, щоб повернути ваш код до правильного вигляду! Вони також підтримують групові виправлення, тому ви можете виправити всі помилки одним клацанням!

Тут ви можете побачити новий інтерфейс виправлення коду у Visual Studio з попереднім переглядом змін, а також опціями застосування виправлення до потрібного вам діапазону

Оптимізація генератора вихідного коду MVVM Toolkit

Як і кожен випуск, MVVM Toolkit 8.2 також включає деякі покращення продуктивності генераторів вихідних кодів. Цього разу основна увага була приділена оптимізації інкрементних конвеєрів, щоб мінімізувати використання пам’яті й гарантувати, що жодні непотрібні об’єкти не залишаться активними під час паралельних виконань. Ось деякі зміни, які було зроблено для покращення цього:

• Перенесено решту діагностик до аналізаторів (#581): ще дві діагностики з MVVM Toolkit було перенесено до діагностичного аналізатора, який можна запускати паралельно та поза процесом. Це вилучає деякі символи Roslyn з інкрементального конвеєра та покращує загальну продуктивність генератора.

• Попередня обробка символів на початку роботи аналізаторів (#587): усі необхідні символи аналізатора тепер обробляються під час початкового налаштування зворотного виклику, що пришвидшує його виконання у кожному екземплярі компіляції.

Інші зміни та покращення

• Виправлено помилку збірки з VB.NET проєктів (#592): MVVM Toolkit спричиняв помилки збірки з VB.NET проєктів через деякі некоректні властивості MSBuild. Наразі це виправлено.

• Виправлено перенаправлені параметри подвійних атрибутів (#603): перенаправлені атрибути через [ObservableProperty] некоректно відображали цілі значення типів float та double у тип int. Тепер вони передаватимуться коректно зі збереженням початкового типу.

• Виправлено генератори вихідного коду, що обробляють вкладені/загальні типи (#606): виправлено проблему, яка призводила до збою декількох генераторів вихідного коду при використанні Roslyn 4.0 та загальних типів.

• Додано API ArrayPoolBufferWriter.DangerousGetArray() (#616): цей новий API дозволяє легко взаємодіяти між ArrayPoolBufferWriter та старими API, які вимагають масив T[] як параметр (на відміну від Span/Memory).

• Вилучено System.Linq з CommunityToolkit.Diagnostics (#622): за результатами дослідження, проведеного у runtime/#82607, з пакунка Diagnostics повністю вилучено всі посилання на System.Linq. Це покращує підтримку обрізання у збірці та дозволяє заощаджувати більший розмір двійкових файлів у опублікованих збірках (особливо з NativeAOT).

• Підтримка часткових методів з [RelayCommand] (#633): атрибут [RelayCommand] тепер працюватиме коректно, якщо його буде додано над визначенням або частиною реалізації часткового методу.

• Додано підтримку відкритих узагальнених типів у ToTypeString (#639): розширення Type.ToTypeString() тепер коректно обробляє відкриті узагальнені типи. Наприклад, typeof(List<>).ToTypeString() тепер повертатиме “System.Collections.Generic.List<>”.

• Додано [MemberNotNull] у встановлювачах [ObservableProperty] (#646): коли це застосовано (тобто коли атрибут є доступним і тип властивості не можна занулити), генератор [ObservableProperty] також генеруватиме необхідні анотації про можливість занулення, щоб гарантувати, що встановлення створеної властивості коректно позначить поля як ініціалізовані. Це розв’язує проблему полів, які показували попередження про недопустимість, навіть якщо згенеровану властивість було встановлено.

• Повні XML-документи для згенерованих членів (#653): усі згенеровані типи та члени тепер оформлено у вигляді повних XML-документів, тож перевірка коду, створеного генераторами вихідного коду MVVM Toolkit, має бути дещо простішою, ніж раніше.

Примітка: у старих версіях Roslyn існує відома проблема з генераторами вихідних кодів, через яку IntelliSense може іноді працювати некоректно для згенерованих елементів (див. #493 і пов’язану з ним проблему відстеження у Roslyn). Ця проблема має бути в основному виправлена в VS 2022 17.6 і вище (або, коли використовується Roslyn 4.6, в тому числі через інші IDE, такі як VS Code і Rider). Якщо ви зіткнулися з цією проблемою, переконайтеся, що ви оновили свій інструментарій до останньої доступної версії.

Інші зміни

Ви можете переглянути повний список змін до цього випуску на сторінці релізу на GitHub.

Почніть вже сьогодні!

Ви можете знайти весь вихідний код у репозиторії GitHub, деякі рукописні документи на MS learn та повні посилання на API на вебсайт браузера .NET API. Якщо ви хочете зробити свій внесок, не соромтеся залишати проблеми або звертатися до команди, щоб повідомити про свій досвід! Щоб стежити за обговоренням у Twitter, використовуйте хештег #CommunityToolkit. Всі ваші відгуки дуже допомагають формувати напрямок розвитку цих бібліотек, тому обов’язково діліться ними!

 

Вдалого кодування!

Анонс .NET Community Toolkit 8.1! Покращені, швидші генератори вихідного коду MVVM, підтримка .NET 7 та багато іншого!

З радістю повідомляємо про офіційний запуск версії 8.1 інструментарію .NET Community Toolkit! Ця нова версія містить нові функції, які були дуже запитувані, виправлені помилки та значні покращення продуктивності генераторів вихідного коду MVVM Toolkit, щоб покращити UX для розробників при їх використанні як ніколи!

 

Що входить до складу .NET Community Toolkit? 

Як і в інших анонсах, розпочнемо з невеликого огляду того, що входить до складу інструментарію .NET Community Toolkit. Він складається з декількох незалежних бібліотек:

Ці бібліотеки також широко використовуються у деяких програмах для роботи з поштою, які входять до складу Windows, зокрема у Microsoft Store та програмі “Фотографії”! 

Для більш детальної інформації про історію .NET Community Toolkit, ось посилання на попередній пост з анонсом 8.0.0.

 

Нижче наведено перелік основних змін, які включено до нового випуску 8.1 інструментарію .NET Community Toolkit.

Користувацькі атрибути для [ObservableProperty] (Властивість, що спостерігається) 

Як вже згадувалося у блозі з анонсом 8.1.0 Preview 1, однією з найбільш запитуваних функцій (див. #208, #217, #228) для генератора вихідного коду MVVM Toolkit була підтримка використання користувацьких атрибутів для [ObservableProperty]. Було запропоновано декілька проєктів для підтримки цієї можливості, і зрештою було вирішено використати наявну властивість: синтаксис у C#, який дозволяє розробникам позначати атрибути для поширення їх на згенеровані властивості. Це дає кілька переваг:

1. Він використовує вбудований синтаксис C#, що робить властивість “рідною” і не потребує додаткових атрибутів

2. Це розв’язує проблему анотування атрибутів, які можуть бути спрямовані лише на властивості, а не на поля

 

Тобто, у MVVM Toolkit 8.1 тепер підтримується наступний сценарій:

Це призведе до створення наступної властивості за замовчуванням:

Ви можете побачити, як згенерована властивість має два атрибути, які було вказано! Таким чином, ви можете гнучко створювати анотації для згенерованих властивостей, використовуючи вбудований синтаксис C# і без обмежень на типи атрибутів, які підтримуються цією функцією. 

Примітка: згенерований код дещо відрізняється і включає додаткові оптимізації продуктивності, не показані тут.

Ви можете знайти всі документи про нові генератори коду тут, а якщо ви віддаєте перевагу відеоверсії, Джеймс Монтемагно також зняв кілька відео про них, наприклад, це.

Аналізатори MVVM Toolkit 

Цей випуск MVVM Toolkit також є першим, в якому представлені спеціальні аналізатори, що допомагають розробникам використовувати MVVM Toolkit найкращим чином. Тобто, MVVM Toolkit більше не буде просто видавати діагностику для функцій, які використовуються неправильно (тобто таким чином, що призведе до помилки), тепер він також буде показувати рекомендації щодо покращення коду та уникнення поширених помилок! 

Перший аналізатор розглядає поширену помилку при використанні атрибута [ObservableProperty]. Розглянемо такий приклад:

Розробники неодноразово стикалися з такою проблемою, коли випадково присвоювали значення полю (а не згенерованій властивості), а потім стикалися з тим, що інтерфейс не відображав зміни, без чіткого пояснення, чому це сталося. Новий аналізатор допоможе у цих випадках, і він позначатиме всі присвоєння полів, що підтримують видиму властивість, показуючи діагностику, яка запропонує посилатися на створену властивість замість неї. Більше жодних загадкових сповіщень про відсутність властивості!

Другий новий аналізатор має на меті допомогти зменшити розмір двійкових файлів у додатках, що використовують MVVM Toolkit. Як вже згадувалося в анонсі 8.0.0, MVVM Toolkit включає декілька атрибутів (таких як [ObservableObject]), які дозволяють генераторам вставляти весь код, необхідний для реалізації інтерфейсів INotifyPropertyChanged та INotifyPropertyChanging (опціонально з додатковими допоміжними засобами) у вже наявні класи. Це особливо корисно у випадках, коли клас вже успадковується від іншого типу, ніж ObservableObject: ви можете використовувати атрибут і мати доступ до тих самих допоміжних функцій, не переробляючи логіку самостійно.

Однак це стосується лише тих випадків, коли успадкування неможливе: якщо ж це не так, краще просто успадкувати від ObservableObject і скористатися перевагами зменшеного розміру двійкового файлу, оскільки компілятору не доведеться копіювати ті самі допоміжні функції знову і знову у кожному типі. Розглянемо цей приклад:

Тут MyViewModel не успадковує від жодного типу, тому їй краще успадкувати від ObservableObject, а не використовувати атрибут [ObservableObject], щоб отримати вигоду від покращення бінарного розміру. Новий аналізатор позначатиме всі сценарії, подібні до цього, пропонуючи використовувати успадкування. Це особливо допоможе новачкам, які можуть не розуміти нюансів двох різних підходів і не знати, як зробити вибір. У таких випадках аналізатор тепер буде поруч, щоб допомогти.

Оптимізація генератора вихідних кодів MVVM Toolkit 

Як вже згадувалося, цей новий випуск також містить значні оптимізації продуктивності MVVM Toolkit, щоб ще більше покращити UX для розробників, особливо при роботі над дуже великими проєктами.

Ось лише деякі з покращень у цьому напрямку:

1. Додано багатоцільове орієнтування для Roslyn 4.3 (#428, #462): генератори вихідних кодів MVVM Toolkit тепер використовуватимуть орієнтир на Roslyn 4.3, якщо він підтримується, щоб вони могли підключатися до деяких оптимізованих API, якщо хост це підтримує. Ця функція автоматично вмикається при зверненні до MVVM Toolkit.

 

2. Використання ForAttributeWithMetadataName (#436): було переключено генератори на новий високорівневий API Roslyn для зіставлення атрибутів, що значно покращує продуктивність генераторів, які спрацьовують за певними атрибутами. Наприклад, [ObservableProperty] тепер використовує цю можливість.

3. Перенесено діагностику в діагностичні аналізатори (#433, #434): було перенесено майже всю діагностику в діагностичні аналізатори, які виконуються поза процесом і незалежно від генераторів вихідних кодів. Це значно зменшує накладні витрати при наборі коду, оскільки вся логіка діагностики тепер виконується в окремому процесі й не може сповільнювати роботу IntelliSense.

4. Припинено використання символів у інкрементних провайдерах (#435): було оновлено всі інкрементні провайдери, щоб більше не поширювати символи. Це може зменшити використання пам’яті, оскільки розповсюдження символів може призвести до того, що Roslyn надмірно викорінюватиме об’єкти компіляції.

5. Більше оптимізацій продуктивності (#447, #460, #469, #487, #489): було переглянуто всі інкрементальні моделі та інкрементальні конвеєри, що значно покращило продуктивність та зменшило виділення пам’яті.

Розширення месенджерів IObservable 

 

Ще однією запитуваною функцією, особливо розробниками, які інтенсивно використовують API у стилі Reactive у своїх додатках, була можливість об’єднати функціональність API месенджерів у MVVM Toolkit. Тепер це підтримується завдяки новим розширенням IObservable для інтерфейсу IMessenger. Їх можна використовувати наступним чином:

 

… Ось і все! Це розширення створить об’єкт IObservable, який можна використовувати для підписки на повідомлення і динамічної реакції на них. Також підтримується вказівка різних токенів за допомогою окремих перевантажень. Ось ще один приклад, що демонструє наскрізне використання нового API:

Підтримка .NET 7 та C# 11 

Цей новий випуск .NET Community Toolkit також додає .NET 7 TFM до пакета HighPerformance і містить кілька змін, що дозволяють скористатися новими можливостями мови C# 11, зокрема, посиланнями на поля (ref fields).

Наступні типи більше не знаходяться у попередньому перегляді й були оновлені для використання нових правил безпеки ref-полів:

Приклад, де вони можуть бути використані, наведено нижче:

Тобто, тип NullableRef фактично дозволяє методу мати параметр out ref T, який не може бути виражений в C# іншим чином. Планується також розширити поверхню API цих типів у майбутньому, щоб ці типи могли стати простою у використанні альтернативою GC-ref арифметиці з використанням типу Unsafe, яка також може бути візуально більш схожою на традиційну арифметику з вказівниками.

 

Крім того, всі типи ref-структур, яких ще не було у попередньому перегляді, було оновлено для внутрішнього використання полів ref для покращення продуктивності. До них відносяться:

Інші зміни 

У цьому новому випуску набагато більше змін!

Ви можете переглянути повний список змін на сторінці релізу на GitHub.

Розпочинайте прямо зараз! 

Ви можете знайти весь вихідний код у репозиторії GitHub, деякі рукописні документи на MS learn та повні посилання на API на вебсайті браузера .NET API. Якщо ви хочете зробити свій внесок, не соромтеся повідомляти про проблеми або ділитися з нами своїм досвідом! Щоб стежити за обговоренням у Twitter, використовуйте хештег #CommunityToolkit. Всі ваші відгуки дуже допомагають формувати напрямок розвитку цих бібліотек, тому обов’язково діліться ними!

Більше ресурсів 

Якщо ви хочете дізнатися більше про MVVM Toolkit, ви також можете переглянути це відео з нещодавньої конференції .NET Conf 2022, де показано, як можна використовувати MVVM Toolkit, новий генератор коду та всі нові функції в 8.1:

Існує ціла екосистема доступних Toolkit’ів з безліччю корисних API для створення .NET-додатків! Дізнайтеся більше про них у документації MS learn!

 

Вдалого кодування!

Source

Нові можливості в .NET MAUI Community Toolkit

 

Листопад був насиченим напрацюваннями для .NET MAUI Community toolkit: вийшло кілька випусків з безліччю дивовижних нових функцій (не кажучи вже про довгий список виправлень помилок). В останніх випусках з’явилися нові подання, макети, підтримка Tizen, підтримка .NET 7 і багато іншого. Ця стаття допоможе вам ознайомитися з усіма новими можливостями.

Що таке .NET Community Toolkit?

Для тих, хто не знайомий з .NET MAUI Community Toolkit, це створена спільнотою бібліотека, яка містить розширення, розширені елементи керування UI/UX, конвертери та поведінку, які допоможуть полегшити ваше життя як .NET MAUI розробника. Це безплатна бібліотека з відкритим вихідним кодом, створена для .NET MAUI розробників самими розробниками .NET MAUI.

 

Розгляньмо деякі важливі нові функції в останніх випусках інструментарію .NET MAUI Community Toolkit.

Подання розгортання

Подання “Розгортання” - це елемент керування контейнером, який дає змогу розгортати та згортати візуальний вміст при натисканні на заголовок. Елемент керування складається з двох частин, заголовка та вмісту. Вміст показується або приховується при натисканні на Expander.Header або при встановленні властивості IsExpanded, що прив’язується.

    

         Text=“Simple Expander (Tap Me)” FontSize=“16” FontAttributes=“Bold”/>

    

     BackgroundColor=“LightGray”>

        

             Text=“Item 1”/>

             Text=“Item 2”/>

        

    

 

 

Цей базовий DockLayout можна створити у XAML ось так:

     toolkit:DockLayout.DockPosition=“Top” Text=“Top” HeightRequest=“50” />

     toolkit:DockLayout.DockPosition=“Bottom” Text=“Bottom” HeightRequest=“70” />

     toolkit:DockLayout.DockPosition=“Left” Text=“Left” WidthRequest=“80” />

     toolkit:DockLayout.DockPosition=“Right” Text=“Right” WidthRequest=“90” />

     Text=“Center” />

 

 

StateContainer

StateContainer дозволяє дуже спростити динамічне відображення контенту на основі стану вашого додатка. Приклади варіюються від створення елементів керування завантаженням до накладання на екран або на частину екрана. Порожні стани можна створювати, коли немає даних для відображення, а стани з помилками можна відображати, коли виникає помилка.

 

Для детальної інформації перегляньте це відео.

 

Підтримка Tizen

Завдяки значному внеску команди Samsung тепер є підтримка Tizen для набору інструментів спільноти .NET MAUI. Це робить інструментарій спільноти .NET MAUI доступним для мільйонів телевізорів, телефонів та інших пристроїв Samsung, що працюють під управлінням Tizen.

 

Дізнатись більше можна за допомогою відео. 

 

Підтримка .NET 7 

Також було підготовлено випуск .NET MAUI Community Toolkit, побудований на .NET 7, що дозволяє всім тим, хто хоче скористатися перевагами .NET 7, зробити це за допомогою .NET MAUI Community Toolkit.

MAUI.Markup Toolkit

Окрім .NET MAUI Community Toolkit, також є MAUI.Markup Toolkit, який являє собою набір методів розширення Fluent C#, що дозволяє розробникам створювати свої додатки з використанням MVVM, Bindings, Resource Dictionaries і т.д. на C# без необхідності працювати в XAML.

Оновлений набір MAUI.Markup Toolkit додає методи розширення C# для App Themeing та ITextAlignment. Використовуючи генератори вихідних кодів, Maui.Markup автоматично генерує методи розширення для кожного елемента управління ITextAlignment, навіть якщо ви створюєте свій власний елемент управління! Також було додано підтримку .NET 7 для MAUI.Markup.

 

Версії

Існує декілька випусків .NET MAUI Community toolkit, які виходять одна за одною. Варто зробити огляд різних версій:

Версія 1.4.0 – додано Expander, DockLayout та StateContainer (і, звісно, багато виправлень!) - Примітки до випуску

Версія 2.0.0 – додано повну підтримку Tizen для всіх наших функцій, включно зі змінами з версії 1.4.0 - Примітки до випуску

Версія 3.0.0 – все з v1.4.0 та v2.0.0, але побудована на базі .NET 7 – Примітки до випуску

За допомогою цієї стратегії випуску версій планується розширити можливості якомога більшої кількості розробників: кожен, хто використовує .NET 6, може отримати всі функції, які було об’єднано до цього часу, включаючи підтримку Tizen, використовуючи версію 2.0.0. Для тих, хто використовує .NET 7, доступні всі функції, починаючи з версії 3.0.0.

 

Важливо відзначити, що в майбутньому .NET 7 стане ціллю для чудових нових можливостей .NET MAUI Community Toolkit!

Більше ресурсів

Якщо ви хочете дізнатися більше про .NET MAUI Community toolkit, ви можете переглянути це чудове оглядове відео з .NET Conf 2022, де Джеральд Верслуіс розповідає про історію створення Community toolkit, про можливості роботи з ним і як розпочати роботу!

Звісно, ви можете знайти весь вихідний код і приклад програми в репозиторії GitHub, а також ознайомитися з офіційною документацією.

 

Вдалого кодування!

Анонс .NET Community Toolkit v8.1.0 Preview 1

 

Пропонуємо вашій увазі попередню версію 1 майбутнього релізу .NET Community Toolkit 8.1! Ця перша офіційна попередня версія містить кілька дуже запитуваних нових функцій, виправлення помилок і, найголовніше, значне покращення продуктивності генераторів вихідних кодів MVVM Toolkit, завдяки чому користувацький інтерфейс розробника при їх використанні навіть у дуже великих проєктах стане кращим, ніж будь-коли!

Що входить до інструментарію .NET Community Toolkit? 

 

Щоб дати короткий огляд того, що мстить інструментарій .NET Community Toolkit, наведемо перелік бібліотек, з яких він складається:

Бібліотеки також широко використовуються у деяких програмах вхідних повідомлень, що постачаються з Windows, таких як Microsoft Store!

Для більш детальної інформації про історію розвитку інструментарію .NET Community Toolkit, ознайомтеся з посиланням на попередній пост з анонсом версії 8.0.0.

Ось перелік основних змін, які ви можете очікувати в цьому новому випуску.

Користувацькі атрибути для [ObservableProperty] 

Однією з найбільш запитуваних функцій (див. #208, #217, #228) для генератора вихідного коду MVVM Toolkit була підтримка використання користувацьких атрибутів для [ObservableProperty]. Було запропоновано декілька проєктів для підтримки цього, і врешті-решт було вирішено використати наявну властивість: синтаксис у C#, який дозволяє розробникам позначати атрибути для розповсюдження на згенеровані властивості. Це дає нам декілька переваг:

 

• Він використовує вбудований синтаксис C#, що робить функцію “рідною” і не потребує додаткових атрибутів
• Це розв’язувати проблему анотування атрибутів, які можуть бути спрямовані лише на властивості, а не на поля

 

Ви можете побачити, як згенерована властивість має два атрибути, які було вказано! Це забезпечує повну гнучкість в анотаціях для згенерованих властивостей, використовуючи вбудований синтаксис C# і без обмежень на типи атрибутів, які підтримуються цією функцією.

Анонс .NET MAUI Community Toolkit v1.3

Команда розробників рада оголосити про випуск .NET MAUI Community Toolkit версії 1.3, який зараз доступний на NuGet! Цей випуск містить функцію стилізації рядка стану, підтримку зображень Gravatar, попередньо створені анімації зникнення, підтримку SourceLink і численні виправлення помилок.

 

.NET MAUI Community Toolkit — це створена спільнотою бібліотека, яка містить розширення .NET MAUI, розширені елементи керування UI/UX, щоб полегшити ваше життя як розробника .NET MAUI.

Стиль рядка стану

У цьому випуску .NET MAUI Community Toolkit тепер ви отримуєте StatusBarBehavior, який дозволяє легко налаштувати колір і стиль рядка стану на iOS і Android за допомогою коду або в XAML. Це імплементовано як Behavior тобто ви  можете змінювати його на сторінках або навіть динамічно у відповідь на дії користувача або статус програми.

Є дві властивості, за допомогою яких можна керувати виглядом рядка стану:

- StatusBarColor: дозволяє вказати колір тла рядка стану.

- StatusBarStyle: дозволяє контролювати, чи буде вміст (текст і піктограми) у рядку стану світлим, темним або типовим для системи.

 

Примітка. Ці дві властивості є Bindable, тому ви також можете зв’язати ці значення з ваших ViewModels.

Ви можете прочитати більше про інші функції StatusBarBehavior та переглянути більше прикладів у наших документах. Gerald Versluis також підготував чудове відео, яке демонструє, як почати.

Джерело зображення Gravatar

Gravatar (всесвітньо визнаний аватар) — це зображення, яке можна використовувати як аватар, тобто зображення, яке представляє вас або ваших користувачів, наприклад, у публікації на форумі чи коментарі в блозі. Ви можете дізнатися більше про Gravatar або зареєструвати свій власний на вебсайті Gravatar.

За допомогою цього випуску .NET MAUI Community Toolkit ви можете легко відображати зображення Gravatar поруч з іменами людей або електронними адресами через GravatarImageSource.

Ви можете використовувати GravatarImageSource будь-де, де зазвичай використовуєте ImageSource, наприклад:

    

         Email=“youremail@here.com” />

    

 

 

Властивість Email визначає електронну адресу облікового запису Gravatar. Однак існують також властивості для визначення зображення за замовчуванням, якщо його Email не знайдено в Gravatar, а також вбудовані можливості кешування. Усі ці властивості підтримуються, BindableProperty що означає, що вони можуть бути цілями для зв’язування даних і стилю.

Дізнайтеся більше про інші функції GravatarImageSource та подивіться більше прикладів у наших документах.

 

Анімації

Цей випуск набору інструментів спільноти .NET MAUI розширює наявний AnimationBehavior можливості, додаючи  можливість FadeAnimation анімувати непрозорість VisualElement з початкової непрозорості на вказану нову прозорість, а потім повертатися до оригіналу.

 

Це дозволяє вказати анімацію в XAML, яка відповідає взаємодії користувача.

Text=“Click this Button”>

    

         EventName=“Clicked”>

            

                 Opacity=“0.2”/>

            

        

    

 

У наступних випусках розробники будуть розбудовувати анімації, щоб забезпечити анімацію перевертання, обертання, масштабування та струшування. Внески завжди вітаються, тому, якщо ви хочете допомогти, перегляньте розділ про внески нижче, щоб дізнатися, як це зробити.

Посилання на джерело

 

Source Link — це технологія, яка забезпечує першокласний досвід налагодження вихідного коду для двійкових файлів. У цьому випуску налаштували збірки на використання Source Link, що означає, що якщо ви ввімкнули Source Link у Visual Studio, ви можете очікувати ще кращого досвіду налагодження під час використання .NET MAUI Community Toolkit. Ви можете знайти більше інформації про Source Link і як його ввімкнути в цій публікації блогу.

Інші виправлення

Цей випуск також містить численні виправлення помилок і покращення якості коду. Перегляньте примітки до випуску, щоб отримати повний список змін.