Українська
Контрольна точка
Що має працювати
Виконайте ці команди в корені репозиторію. Кожна має завершитися успішно:
powershell
dotnet buildpowershell
dotnet format Chatex.slnx --verify-no-changespowershell
docker compose up --detach --waitpowershell
dotnet ef --versionpowershell
./Run.ps1Порівняйте свій репозиторій з еталоном: файли global.json, Directory.Build.props, Directory.Packages.props, compose.yaml, dotnet-tools.json і Run.ps1 мають бути ідентичними до файлів у D:\Work\Chatex-Reference, наприклад:
powershell
git diff --no-index Directory.Build.props D:\Work\Chatex-Reference\Directory.Build.propsВідсутність виводу означає відсутність відмінностей. Файли .csproj поки відрізняються: в еталонних уже є посилання на пакети з пізніших тем.
Типові помилки
Таблиця 2.3. Типові помилки під час створення рішення
| Симптом | Причина | Виправлення |
|---|---|---|
A compatible .NET SDK was not found | не встановлено жодного SDK лінійки 10.0 від 10.0.403 і вище | встановіть .NET 10 SDK; перевірте за допомогою dotnet --list-sdks |
error NU1008: Projects that use central package version management should not define the version on the PackageReference items | у PackageReference є атрибут Version | видаліть атрибут; версія має бути в Directory.Packages.props |
error NU1010: The PackageReference items … do not have corresponding PackageVersion | на пакет є посилання, але його версії немає в Directory.Packages.props | додайте для нього рядок PackageVersion |
error ENDOFLINE від dotnet format --verify-no-changes | файли з кінцями рядків CR LF | виконайте dotnet format Chatex.slnx |
папки bin/ чи obj/ з’являються в git status | .gitignore відсутній або не в корені репозиторію | завантажте його, як у кроці 6 |
port is already allocated під час запуску контейнера | база даних еталонної версії або інший PostgreSQL займає порт 5432 | зупиніть його: ./Run.ps1 db-stop у папці еталона |
Питання для самоперевірки
- Чому репозиторій фіксує версію SDK у
global.json? Що дозволяєrollForward: latestFeature? - Як проєкти рішення забезпечують напрямок рівнів? Чому Chatex.Api усе одно може використовувати типи з Chatex.Data?
- Як налаштування з
Directory.Build.propsпотрапляє в кожен проєкт? - Що змінює
Nullableу значенніstringіstring?? - Чому попередження вважають помилками? Яку проблему це запобігає в команді?
- Чим відрізняються правила аналізаторів
CA…від правил стилюIDE…? Де вимикають правило і що має супроводжувати таку зміну? - Яку проблему розв’язує централізоване керування пакетами? Де записано версію пакета, а де – посилання на нього?
- Чому PostgreSQL працює в контейнері, а не як системна служба? Де зберігаються його дані і як їх видалити?
- Чому
dotnet-efвстановлено як локальний інструмент? - Що перевіряє
Invoke-StepуRun.ps1після кожної програми і чому ця перевірка необхідна?
Вправи
- Нова команда. Додайте команду
psqlдоRun.ps1, що відкриває інтерактивний сеансpsqlу контейнері бази даних (docker compose exec postgres psql -U postgres -d chatex). Не забудьте додати її доValidateSetі до$Commands. - Аналізатори в дії. Додайте до Chatex.Core клас із методом
public string Upper(string s) => s.ToUpper();і зберіть проєкт. Збирання провалюють три правила аналізаторів (CA1304,CA1311,CA1822). Прочитайте, що каже кожне з них, а потім виправте код замість того, щоб вимикати правила. (Підказка: операції з рядками, що залежать від культури комп’ютера, і члени, які не використовують даних екземпляра.) Потім видаліть цей клас. - Зламайте аудит. У тимчасовій копії репозиторію додайте пакет
System.Text.Jsonверсії8.0.0доDirectory.Packages.props, послайтеся на нього з Chatex.Core і виконайтеdotnet restore. Прочитайте помилкуNU1903: на яку вразливість вона посилається? Потім скасуйте зміну.