УРОК 2 ІЗ 108
Expo: середовище, запуск і типи runtime
Середовище 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.js | CLI, package manager і Metro на комп'ютері | Підтримуваний Node 22 LTS patch, не нижче 22.13.x |
| Xcode | Компіляція iOS і Simulator | SDK 57 документує мінімум Xcode 26.4 |
| Android Studio | Android SDK, emulator, інструменти налагодження | Android SDK 36 і сумісний emulator image |
| JDK | JVM для Android build tooling | JDK 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 found | Development build створено до встановлення модуля | Звір dependency, config і перебудуй потрібну платформу |
| Android build не знаходить SDK | Не налаштовано Android environment | Звір SDK path та env за офіційною інструкцією; cache clear тут не вирішує проблему |
| iOS build падає до bundling | Xcode, pods або native config | Прочитай першу змістовну native помилку, перевір Xcode selection і SDK compatibility |
| Телефон не відкриває bundle | Network 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.
Критерії приймання:
- Екран відкривається на iOS Simulator та Android Emulator; фактично перевірені платформи зазначені окремо.
- Зміна тексту доходить до обох без native rebuild.
- Ти можеш показати root layout, стартовий route і Metro terminal.
- У журналі є одна локалізована помилка або опис перевірки, якщо setup пройшов одразу.
- Немає автоматично створених тобою Git commits.
Якщо одна платформа тимчасово недоступна, запиши конкретний blocker і продовжуй компонентні drills на доступній. До завершення модуля повернись до другої. Не записуй обидві платформи як успішні за результатом лише однієї.
Додатково: запусти development build на фізичному Android або iPhone за офіційними device інструкціями та порівняй доступ до Metro.
Самоперевірка
- Що робить Metro, а що Xcode/Gradle?
- Чому
expo installне означає автоматичне додавання native module до вже встановленого app? - Чи однакові Expo Go та development build?
- Чому template pin не замінює lockfile?
- Чому
CI=1у цій конкретній scaffold команді важливий для нашого правила Git?
Відповіді та підказки
- Metro готує та віддає JS/assets у dev workflow. Xcode/Gradle компілюють native частину й створюють app для встановлення. Помилку слід шукати у відповідному шарі.
- Установлення змінює залежності на комп'ютері. Native executable на пристрої лишається старим до нового build.
- Expo Go має визначений набір native можливостей; development build включає потрібні проєкту modules і конфігурацію.
- Template pin визначає стартові файли та declared ranges. Lockfile фіксує resolved dependency tree конкретного встановлення.
- У перевіреній версії генератора це умова пропуску 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; запуск на пристроях у межах написання цього уроку не виконувався.
Від читання — до результату.
Зміни код і запусти в браузері. Це відкрите демо: запуск коду не завершує урок автоматично.
Завантажуємо вправи…
ЗНАННЯ СТАЮТЬ НАВИЧКОЮ ЧЕРЕЗ ПРАКТИКУ
Готовий закріпити результат?
Прочитай матеріал і виконай завдання з уроку. Після цього відзнач свій маленький успіх.
Увійти, щоб пройти тести й зберегти прогрес