React Native розробка
Розмір тексту: 16

УРОК 2 ІЗ 108

Expo: середовище, запуск і типи runtime

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

Середовище Expo та перший запуск

ID: M01-L02 · Тиждень: 1 · Передумови: M01-L01, базовий TypeScript і terminal.

Час: 60–75 хв на пояснення й налаштування, 75–90 хв на практику. Перший native build може потребувати додаткового часу. Контекст: Expo SDK 57, проєкт у labs/field-notes, root route src/app/index.tsx. Залежності та конкретні версії описані в технічній базі.

Що ти зможеш після уроку

  • Пояснити різницю між Metro, JavaScript bundle і native build.
  • Створити навчальний проєкт із зафіксованого шаблону, врахувавши правило без автоматичних Git commits.
  • Запустити власний development build на iOS Simulator і Android Emulator.
  • Змінити стартовий екран та визначити, чи потрібне оновлення JS, чи нова native збірка.

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

Чому одного dev server недостатньо

На web dev server віддає сторінку браузеру, який уже вміє виконувати JavaScript та показувати HTML. У мобільному середовищі спочатку потрібен встановлений застосунок. Він містить native компоненти, JS engine та native бібліотеки. Уже цей застосунок під час розробки отримує JavaScript від Metro.

Уяви дві частини: встановлена оболонка має конкретні native можливості; твій JS визначає поведінку екранів. Зміна тексту кнопки змінює JS. Додавання native бібліотеки змінює можливості оболонки й зазвичай потребує нової збірки.

Схема має два входи до застосунку: код екранів приходить через Metro, native частина — через компіляцію. Вона спрощує production pipeline, який розглянемо окремо. Expo development builds.

Expo Go і development build

Expo Go — готовий застосунок із заздалегідь включеними native модулями. Він корисний для сумісних коротких експериментів. Власний development build містить native можливості саме твого проєкту, тому це основний шлях у курсі.

Для SDK 57 не припускаємо, що версія Expo Go, доступна сьогодні у store конкретного пристрою, сумісна зі starter проєктом. Якщо обираєш цей додатковий шлях, перевір SDK support і доступність відповідної версії. Для обов'язкової практики використай development build. Порівняння середовищ.

Development build також має dev меню та засоби підключення до Metro. Production build налаштовується для користувачів: залежність від твого запущеного laptop dev server у ньому не потрібна. До production дійдемо в M15.

Що підготувати на комп'ютері

Твій поточний workspace знаходиться на macOS, тому основна інструкція використовує локальні симулятори обох платформ. Для іншого комп'ютера порядок встановлення відрізнятиметься.

ІнструментДля чогоОрієнтир baseline
Node.jsCLI, package manager і Metro на комп'ютеріПідтримуваний Node 22 LTS patch, не нижче 22.13.x
XcodeКомпіляція iOS і SimulatorSDK 57 документує мінімум Xcode 26.4
Android StudioAndroid SDK, emulator, інструменти налагодженняAndroid SDK 36 і сумісний emulator image
JDKJVM для Android build toolingJDK 17 за інструкцією Expo
GitНаявний локальний репозиторій для безпечного scaffoldБез commit і push

Версії не потрібно обирати незалежно за принципом «найновіші». SDK, React Native та native toolchain мають бути сумісними. Перед встановленням перечитай Expo SDK 57 reference і технічну базу, якщо від часу написання минуло кілька місяців.

Перевір доступні інструменти:

node --version
npm --version
git --version
xcodebuild -version
java -version

Ці команди не встановлюють відсутні інструменти. Якщо xcodebuild указує на Command Line Tools замість повного Xcode, відкрий Xcode, заверши перше налаштування й звір selection за офіційною інструкцією iOS Simulator. Не копіюй чужий шлях Xcode, якщо у тебе інший application name.

У Android Studio відкрий SDK Manager, установи потрібні SDK Platform і build tools, а в Device Manager створи emulator. На Apple Silicon обирай сумісний ARM system image. ANDROID_HOME, PATH і selected JDK налаштовуй за Android environment guide; це конфігурація твого комп'ютера, а не React компонента.

Спочатку запусти Simulator та Emulator з їхніх застосунків. Якщо віртуальний пристрій ще не створено, Metro не створить його замість тебе.

Створення проєкту без автоматичного commit

Працюй із кореня цього репозиторію. Генератор Expo може ініціалізувати Git і створити стартовий commit. Ми зафіксували версію генератора і використовуємо документовану в його source code гілку: всередині наявного Git репозиторію з CI=1 Git initialization пропускається. Це перевірка вихідного коду генератора, а не результат його запуску у цьому workspace. Expo create-expo git utility.

Команда навмисно містить guard: у папці без репозиторію scaffold не почнеться. Не прибирай умову та CI=1 і не замінюй зафіксований генератор на latest, поки не перевіриш його Git поведінку.

# Виконувати з кореня папки курсу, де вже є .git.
if [ "$(git rev-parse --is-inside-work-tree 2>/dev/null)" = "true" ]; then
  CI=1 npx create-expo@5.0.3 labs/field-notes \
    --template expo-template-default@57.0.29 \
    --no-install \
    --yes
else
  printf '%s\n' 'Відкрий корінь наявного Git репозиторію курсу.'
fi

Якщо labs/field-notes уже існує, зупинись і перевір його вміст; повторна генерація не є способом продовжити урок. Команда потребує мережі та завантажує npm packages. --no-install спочатку створює файли, а встановлення dependencies робимо окремим кроком.

cd labs/field-notes
npm install
npx expo install expo-dev-client

expo install підбирає сумісні з Expo SDK версії підтримуваних пакетів. Не встановлюй довільний react-native@latest у цей проєкт. Збережи package-lock.json: template pin не фіксує всі транзитивні залежності, а lockfile описує фактично отримане dependency tree. Expo CLI install.

Шаблон містить strict TypeScript, Router і приклади. Ми не видаляємо його автоматично через reset script. Для M01 достатньо замінити два файли нижче; інший демонстраційний route можна поки залишити.

Простий root layout

Повністю заміни labs/field-notes/src/app/_layout.tsx:

import { Stack } from 'expo-router';
import { SafeAreaProvider } from 'react-native-safe-area-context';

export default function RootLayout() {
  return (
    <SafeAreaProvider>
      <Stack screenOptions={{ headerShown: false }} />
    </SafeAreaProvider>
  );
}

Stack надає контейнер екранів, подробиці в M03. Зараз важливо, що index.tsx є стартовим route. SafeAreaProvider дає дочірнім екранам інформацію про безпечні відступи біля системних панелей і вирізів. Сам provider не додає padding — це робить SafeAreaView у наступному прикладі. Не імпортуємо застарілий core SafeAreaView із react-native. Safe area в Expo.

Повністю заміни labs/field-notes/src/app/index.tsx:

import { StyleSheet, Text, View } from 'react-native';
import { SafeAreaView } from 'react-native-safe-area-context';

export default function HomeScreen() {
  return (
    <SafeAreaView style={styles.screen}>
      <View style={styles.card}>
        <Text style={styles.title}>Field Notes</Text>
        <Text style={styles.body}>Мій перший native екран</Text>
      </View>
    </SafeAreaView>
  );
}

const styles = StyleSheet.create({
  screen: { flex: 1, padding: 24, backgroundColor: '#f3f4f6' },
  card: { padding: 20, gap: 12, backgroundColor: '#ffffff', borderRadius: 16 },
  title: { fontSize: 28, fontWeight: '700', color: '#111827' },
  body: { fontSize: 18, color: '#374151' },
});

Очікувана поведінка: світлий екран, біла картка з двома рядками. Тут уже є кілька RN API; у наступних уроках розберемо їх докладно. Не потрібно знати весь Router, щоб запустити один route. Expo Router notation.

Перші native builds

Із папки labs/field-notes, коли Simulator уже доступний:

npx expo run:ios

Дочекайся встановлення та відкриття iOS застосунку. Команда може залишитися працювати, бо обслуговує Metro; це нормальний dev server. Після перевірки першого екрана зупини його через Ctrl+C у цьому terminal. Потім для Android з доступним emulator виконай:

npx expo run:android

Ці команди будують і встановлюють native застосунок; якщо native directories ще немає, Expo готує її через prebuild. Початковий build значно повільніший за зміну рядка у TSX. Local iOS Simulator не вимагає платного Apple Developer membership. Фізичний iPhone має додатковий signing workflow; EAS device distribution і локальне signing не мають однакових умов. Local development, iOS device development.

Дочекайся встановлення Android застосунку й перевір екран. Обидва development builds тепер встановлені. Можна лишити один Metro, запущений другою командою, або зупинити його через Ctrl+C і запустити явно. Наступного дня зазвичай достатньо:

npx expo start --dev-client

Відкрий встановлений development build, а в меню Metro обери потрібний device. На фізичному телефоні врахуй мережеву доступність laptop: «працює на simulator» ще не означає «телефон бачить dev server».

Не використовуй prebuild --clean як універсальне лікування помилок. Генерація native directories може перезаписати ручні native зміни. У M12 розберемо, що зберігається в config plugin, а що потребує іншого ownership workflow. Continuous Native Generation.

Передбач результат

Зміни Мій перший native екран на власний текст. Перед збереженням дай відповідь: чи має Xcode повторно компілювати iOS застосунок?

Очікування: зміна TSX надходить через dev цикл, нова native бібліотека не з'явилася, повний native build не потрібний. Тепер уяви встановлення бібліотеки з новим native module: одного Metro restart недостатньо, бо встановлений застосунок ще не містить її native частини.

Типові помилки

СимптомМожлива причинаЯк перевірити і виправити
Змінив файл, екран старийІнший route, інший проєкт або старий MetroПеревір terminal cwd, route і чи клієнт підключений до правильного server
Native module ... not foundDevelopment build створено до встановлення модуляЗвір dependency, config і перебудуй потрібну платформу
Android build не знаходить SDKНе налаштовано Android environmentЗвір SDK path та env за офіційною інструкцією; cache clear тут не вирішує проблему
iOS build падає до bundlingXcode, pods або native configПрочитай першу змістовну native помилку, перевір Xcode selection і SDK compatibility
Телефон не відкриває bundleNetwork reachability або неправильний dev URLПеревір однакову мережу, firewall і адресу, відділи це від помилки React коду

Спочатку визнач шар помилки. Одна команда --clear не може виправити одночасно signing, недоступний emulator і неправильний import.

Практика

Створи журнал середовища, наприклад labs/field-notes/ENVIRONMENT.md: дата, Node/npm, Expo/RN/React із package.json, Xcode, JDK, emulator/simulator і результат кожного запуску. Не записуй secrets або account credentials.

Критерії приймання:

  1. Екран відкривається на iOS Simulator та Android Emulator; фактично перевірені платформи зазначені окремо.
  2. Зміна тексту доходить до обох без native rebuild.
  3. Ти можеш показати root layout, стартовий route і Metro terminal.
  4. У журналі є одна локалізована помилка або опис перевірки, якщо setup пройшов одразу.
  5. Немає автоматично створених тобою Git commits.

Якщо одна платформа тимчасово недоступна, запиши конкретний blocker і продовжуй компонентні drills на доступній. До завершення модуля повернись до другої. Не записуй обидві платформи як успішні за результатом лише однієї.

Додатково: запусти development build на фізичному Android або iPhone за офіційними device інструкціями та порівняй доступ до Metro.

Самоперевірка

  1. Що робить Metro, а що Xcode/Gradle?
  2. Чому expo install не означає автоматичне додавання native module до вже встановленого app?
  3. Чи однакові Expo Go та development build?
  4. Чому template pin не замінює lockfile?
  5. Чому CI=1 у цій конкретній scaffold команді важливий для нашого правила Git?

Відповіді та підказки

  1. Metro готує та віддає JS/assets у dev workflow. Xcode/Gradle компілюють native частину й створюють app для встановлення. Помилку слід шукати у відповідному шарі.
  2. Установлення змінює залежності на комп'ютері. Native executable на пристрої лишається старим до нового build.
  3. Expo Go має визначений набір native можливостей; development build включає потрібні проєкту modules і конфігурацію.
  4. Template pin визначає стартові файли та declared ranges. Lockfile фіксує resolved dependency tree конкретного встановлення.
  5. У перевіреній версії генератора це умова пропуску Git initialization всередині вже наявного repo. Окремо потрібна перевірка, що команда справді виконується всередині нього.

Підказка до practice: якщо setup застряг, зроби мінімальний діагноз із трьох рядків — команда, перша змістовна помилка, перевірений інструмент/версія. З таким записом можна продовжити в іншій сесії без повторного вгадування.

Повторення і наступний крок

  • Через день: без конспекту намалюй два шляхи до app — JavaScript і native build.
  • Через сім днів: поясни, які три зміни потребують rebuild, а які лише dev refresh; звір кожен приклад із типом залежності.
  • Через 21 день: повтори запуск із уже створеним app і перевір, чи журнал середовища досі актуальний.

Далі — базові компоненти. Середовище вже дає місце, де ти зможеш бачити поведінку кожного прикладу.

Джерела

Основні першоджерела наведені біля відповідних інструкцій. Додатково: Expo SDK 57 release, Expo create-expo CLI, технічна база, реєстр джерел. Baseline перевірено 2026-10-11; запуск на пристроях у межах написання цього уроку не виконувався.

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

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

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

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

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

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

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

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