Angular для React-розробника
Розмір тексту: 16

УРОК 2 ІЗ 90

00.2 Середовище без випадкових версій

20 хв читання та практикиТвій наступний крок

00.2 Середовище без випадкових версій

TeamFlow поки не потребує сервера чи бази даних. Нам потрібні Node.js, npm, редактор і браузер. Після цього уроку ти запустиш готовий Angular-приклад, тести та production-збірку, а потім створиш власну копію для вправ.

Попередній урок — 00.1. Тут не потрібно розуміти синтаксис компонента: сьогодні перевіряємо інструменти й робочий цикл.

Сайт курсу й навчальний практикум — два окремі застосунки. Сайт показує тексти та приклади; у практикумі ти змінюєш власний код. Позначка виконання в браузері допомагає тримати маршрут; коректність практики перевіряємо запуском і тестами.

Якщо ти ще не відкрив сайт, з кореня репозиторію виконай наведений блок. Дужки ізолюють його робочу папку й налаштування shell; set -eu зупиняє блок на помилці або невизначеній змінній, а pipefail не приховує збій команди в конвеєрі. Після завершення термінал залишиться в початковій папці:

(
  set -eu
  set -o pipefail
  cd site
  npm ci
  npm start
)

Адреса сайту — http://127.0.0.1:4173. Залиш цей термінал працювати й відкрий другий у корені репозиторію для наступних команд практикуму. Його адреса буде на порту 4200. Markdown у редакторі також доступний, якщо тобі зручніше читати саме так.

Яку версію використовуємо

База першого практикуму — Angular 22.2.4, Angular CLI 22.2.6 і TypeScript 6.0.x. Перевірки курсу виконано на Node 24.22.1. Точні залежності записані в package-lock.json; пояснення вибору й дата перевірки є в технологічній базі.

В Angular є вимоги до сумісності Node.js і TypeScript. Новіша версія окремого інструмента не обов’язково підходить до поточного проєкту. За потреби зміни середовища звіряй офіційну таблицю сумісності.

У терміналі перевір:

node --version
npm --version

Для найпростішого повторення використовуй Node 24.22.1. Якщо керуєш версіями через nvm, у папці практикуму можна виконати nvm install, а потім nvm use: файл .nvmrc містить потрібну версію. Якщо nvm не встановлений, обери свій звичний менеджер або офіційне встановлення Node.js. Не потрібно міняти спосіб керування Node лише заради Angular.

Запускаємо еталон

Наступні команди виконуються з кореня цього репозиторію:

(
  set -eu
  set -o pipefail
  cd labs/01-first-component
  npm ci
  npm start
)

npm ci встановлює дерево залежностей із lockfile й перевіряє узгодженість із package.json. Це зручно для повторюваного навчального середовища. Команда замінює наявний node_modules у цій папці; вихідний код не змінює. Деталі поведінки описані в документації npm ci.

npm start запускає сервер розробки. Відкрий адресу, яку надрукує термінал, зазвичай http://localhost:4200. Ти маєш побачити TeamFlow, ціль у п’ять задач, поточний прогрес і кнопки зміни стану. Натисни «Завершити завдання»: лічильник і відсоток мають змінитися. Для зупинки сервера натисни Ctrl+C у цьому терміналі.

У другому терміналі, у папці labs/01-first-component, виконай:

npm test -- --watch=false
npm run build
npm exec -- ng version

Перша команда запускає тести один раз. Друга збирає застосунок для production. Третя показує версії Angular-інструментів. Angular CLI — це командний інтерфейс Angular, програма з командами на кшталт serve, build і test. У нашому випадку вона встановлена локально як залежність практикуму. Глобальна інсталяція CLI не потрібна: npm scripts знаходять локальний виконуваний файл. Про призначення CLI є офіційна інструкція налаштування.

Dev server і production build вирішують різні задачі. Перший швидко показує зміни під час розробки. Другий готує вихідні файли для розміщення. Тому працююча сторінка під npm start ще не замінює перевірку збірки.

Робоча копія для вправ

Зупини dev server. З кореня репозиторію створи нову копію без установлених залежностей та результатів збірки:

(
  set -eu
  set -o pipefail
  test -f labs/01-first-component/package.json
  mkdir -p practice
  mkdir practice/01-first-component
  rsync -a --exclude=node_modules --exclude=dist --exclude=.angular labs/01-first-component/ practice/01-first-component/
  cd practice/01-first-component
  npm ci
  npm start
)

Команди в дужках зупиняються на першій помилці й не змінюють каталог термінала. Подальші команди запускай із practice/01-first-component.

Ці команди підходять для поточного macOS-середовища. Якщо rsync недоступний на іншій системі, скопіюй папку через файловий менеджер, пропустивши node_modules, dist і .angular.

Далі всі зміни у вправах роби в practice/01-first-component. У labs/01-first-component залишиться короткий завершений приклад. practice/ ігнорується Git, тому твої експерименти не потраплять випадково в авторські коміти курсу. Якщо захочеш зберігати їхню історію, це можна організувати окремо.

Блок відмовиться працювати з уже наявною папкою, тому повторний запуск не перезапише твої вправи. Для нової спроби обери іншу назву; наявну практику продовжуй без копіювання.

Редактор і перша діагностика

Відкрий репозиторій у звичному редакторі. Для VS Code встанови офіційне розширення Angular Language Service. Воно допомагає знаходити помилки в шаблонах і переходити до оголошень; підтримка інших редакторів залежить від їхніх інтеграцій. Можливості описані в Angular Language Service.

Не потрібно одразу встановлювати десятки розширень. Коли почнемо змінювати шаблон, перевіримо, що редактор бачить саме Angular-проєкт і його tsconfig.json.

СимптомЩо перевірити спочатку
npm не знаходить package.jsonПоточну папку: команди практикуму запускаються всередині нього
Помилка про unsupported enginenode --version і сумісність із базою курсу
Порт 4200 зайнятийЧи залишився попередній dev server; зупини його або виконай npm start -- --port 4201
Встановлення не доходить до компіляціїПершу мережеву помилку, доступ до registry та локальні налаштування npm
Сторінка не показує змінЧи редагуєш копію, з якої зараз запущений сервер

При помилці не починай зі стирання lockfile. Він потрібен, щоб ми працювали з однаковими версіями. Спочатку знайди першу змістовну помилку й визнач, на якому етапі вона виникла: встановлення, компіляція, запуск чи дія в браузері.

Практика

У власній копії відкрий src/app/app.html і зміни один видимий текст, наприклад назву вступного підпису. Переконайся, що браузер показав зміну. Потім запусти тести та збірку в цій копії.

Критерії виконання: ти можеш назвати папку запущеного застосунку, показати змінений текст, зупинити сервер і пояснити три команди: встановлення, тестування, збірка. Якщо тест залежав від зміненого тексту й упав, прочитай його очікування до будь-якого виправлення.

<details> <summary>Підказки до практики</summary>

Обери звичайний статичний підпис, не вираз у фігурних дужках і не назву методу. Перевір, що термінал із сервером відкритий саме в practice/01-first-component. Якщо зміна не з’явилася, звір адресу браузера з адресою в цьому терміналі.

</details> <details> <summary>Розв’язок і пояснення перевірки</summary>

У practice/01-first-component/src/app/app.html знайди один звичайний текстовий підпис і заміни його власним, наприклад «Мій перший Angular-практикум». Не змінюй вирази з {{ ... }}, назви атрибутів чи обробників: задача перевіряє робочий цикл, а не синтаксис шаблону. Збережи файл і переконайся, що новий підпис видно в браузері.

У другому терміналі з папки practice/01-first-component запусти npm test -- --watch=false, потім npm run build. Якщо впав тест, прочитай очікуваний і фактичний текст. Зміна свідомо вибраного статичного підпису може вимагати узгодити його текстове очікування, але не виправдовує видалення перевірки поведінки. Після успішної перевірки зупини сервер через Ctrl+C.

Ти пройшов повний цикл: змінив вихідний файл, побачив результат, перевірив його тестами й зібрав застосунок. Еталон у labs/ залишився доступним для порівняння.

</details>

Перевір себе

  1. Чому команди запускаються всередині практикуму, а не з кореня курсу?
  2. Навіщо зберігати lockfile, якщо всі залежності вже перелічені в package.json?
  3. Dev server працює. Що ще треба запустити перед висновком, що приклад перевірений?
  4. Ти змінив файл у practice/, але браузер не оновився. Яку просту причину варто перевірити?
<details> <summary>Відповіді з поясненнями</summary>
  1. Саме практикум містить package.json, npm scripts і конфігурацію Angular workspace. Корінь курсу організовує матеріали.
  2. Lockfile фіксує розв’язане дерево, включно з транзитивними залежностями. Самого переліку прямих пакетів недостатньо для однакового встановлення.
  3. Тести та production build. Перевірка в браузері показує конкретний сценарій, а ці команди перевіряють інші частини робочого процесу.
  4. Сервер міг залишитися запущеним з еталонного labs/, тоді як ти редагуєш копію. Звір термінал і шлях перед пошуком складнішої проблеми.
</details>

Якщо сторінка відкривається, тести й збірка завершуються успішно, а власна копія реагує на редагування, середовище готове.

Назад: як учитися · Далі: TypeScript для Angular

СПРОБУЙ ВЛАСНОРУЧ

Від читання — до результату.

Зміни код і запусти в браузері. Це відкрите демо: запуск коду не завершує урок автоматично.

Завантажуємо вправи…

ЗНАННЯ СТАЮТЬ НАВИЧКОЮ ЧЕРЕЗ ПРАКТИКУ

Готовий закріпити результат?

Прочитай матеріал і виконай завдання з уроку. Після цього відзнач свій маленький успіх.

Увійти, щоб пройти тести й зберегти прогрес