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

УРОК 1 ІЗ 108

Мобільний React і відмінності від React DOM

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

M01-L01. Від React у браузері до мобільного застосунку

ID: M01-L01 · Тиждень: 1 · Передумови: компоненти React, props, hooks, TypeScript, базова робота з Git та npm. Попередні уроки курсу не потрібні.

Час: 50–60 хв на читання, схеми й прогнозування; 75–90 хв на самостійну практику. Контекст коду: навчальний застосунок Field Notes на базі з TECH_BASELINE.md. Код нижче — попередній огляд майбутнього src/app/index.tsx; середовище і його root layout створюємо в M01-L02. Залежності: react, react-native, react-native-safe-area-context. Тут їх не встановлюємо.

Перевірка матеріалу: приклади опрацьовано редакторськи за офіційними API; запуск на iOS/Android не виконувався (runtime_validation: not_run).

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

  • Пояснити, що з твого досвіду React переноситься без зміни, а що потребує нової моделі.
  • Розрізнити React, React Native, Expo, Metro та операційну систему за їхніми обов'язками.
  • Передбачити наслідки відсутності браузерного DOM, мобільної клавіатури, зміни стану застосунку та дозволів.
  • Відділити спільну бізнесову логіку від поведінки, яку перевіряють на кожній платформі.
  • Описати маленьку мобільну функцію через спостережувані сценарії, а не лише JSX.

Проблема у застосунку

Уяви, що ти вже написав у React сторінку журналу місць. Є заголовок, три картки, поле пошуку та кнопка додавання. Тепер користувач хоче такий журнал на телефоні: записати думку в парку, повернутися після телефонного дзвінка, прочитати нотатку без мережі.

Компонентна структура залишається знайомою. Проте сторінка в браузері й екран у застосунку мають різні умови життя. На телефоні клавіатура займає значну частину екрана. Система може прибрати процес із пам'яті. Запит дозволу на геолокацію може завершитися відмовою. Фізичний жест повернення є частиною очікуваного досвіду.

Перший крок у React Native — зрозуміти ці умови. Інакше можна отримати акуратний компонент, який добре виглядає на одному screenshot, але незручно поводиться під час звичайного користування.

Наскрізний проєкт курсу — Field Notes, особистий журнал місць і нотаток. У першому модулі дані живуть у пам'яті. Поступово ми додамо навігацію, форми, збереження, API, синхронізацію та можливості пристрою. Повний контракт розвитку описує PROJECT_SPEC.md.

Як це працює

React описує інтерфейс, renderer створює його для певного середовища

React відповідає за компоненти, їхню пам'ять і оновлення. У web renderer react-dom оновлює DOM. React Native використовує інший renderer і платформні можливості: компоненти на кшталт View і Text описують мобільний інтерфейс. Це визначає офіційний вступ до core components.

Схема читається так: ті самі принципи оновлення компонентів можуть працювати з різними середовищами. Коли користувач вводить текст або натискає кнопку, ми оновлюємо state; наступний опис UI потрапляє до відповідного renderer. Це навчальна схема, вона не показує внутрішній порядок потоків, layout чи commit. Сучасну архітектуру розбиратимемо окремо; для перших екранів не потрібна історична модель «усе їздить через bridge».

Твоя інтуїція щодо чистого render, композиції, props і локального state корисна відразу. Якщо NoteCard отримує назву через props, вона не повинна знати, де ця назва зберігається. Якщо фільтр є похідним від списку та запиту, не потрібно заводити третій state лише тому, що застосунок мобільний.

Назви сучасної архітектури, які зустрічатимуться в документації

Hermes — JavaScript engine, який виконує наш JS у застосунку. Він входить до узгодженої React Native бази. Наявність JavaScript engine не означає наявність браузерного DOM: середовище дає інший набір APIs. Using Hermes

New Architecture — назва сучасної внутрішньої архітектури RN. Fabric — її система відображення UI. JSI, JavaScript Interface, — інтерфейс взаємодії JavaScript engine з native C++ кодом. Для першого екрана достатньо розрізняти: Hermes виконує JS, Fabric відповідає за rendering, JSI забезпечує відповідну взаємодію. Детальний render pipeline і native modules вивчатимемо в M12. Fabric, New Architecture: JSI

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

Знайомий JSX описує інші елементи

<div> і <View> можуть бути контейнерами, але це аналогія за призначенням. Вона не переносить CSS cascade, браузерні події чи DOM APIs.

Знайомий web інструментПочаткова мобільна відповідністьМежа аналогії
divViewContainer з мобільними layout props; браузерний DOM node відсутній
p, spanTextТекст має бути всередині Text; вкладений текст має власні правила
inputTextInputВведення пов'язане з системною клавіатурою та платформними props
buttonPressable з TextСемантику, feedback і доступність задаємо явно
Контейнер із прокручуваннямScrollViewПотрібний обмежений розмір viewport; великий список розбиратимемо пізніше

Таблиця — орієнтир для пошуку API. Не треба автоматично замінювати кожен HTML tag одним компонентом. Спочатку визначаємо роль: це текст, контейнер, дія чи поле? Від ролі вибираємо компонент і його поведінку.

У native екрані немає браузерного document.querySelector() для керування цими елементами. Ref може дати доступ до можливостей конкретного компонента, наприклад фокусування TextInput, проте це не довільний DOM API. Для зміни показаної назви так само використовуємо state/props.

React Native та Expo мають різні обов'язки

React Native дає мобільні компоненти, renderer і APIs. Expo додає інструменти, бібліотеки й workflow для створення та розвитку застосунку. Expo Router задає маршрути; Metro готує JavaScript та assets для development. Операційна система керує вікном застосунку, клавіатурою, життєвим циклом і дозволами. Для цього курсу Expo зменшує кількість стартових налаштувань; native можливості та development builds вивчаємо поступово. Expo: Create a project

Коли кнопка має неправильний текст, починаємо з компонента. Коли Metro не знаходить import, дивимося на шлях і залежність. Коли доступ до камери заборонено, потрібна модель permissions. Розуміння меж інструментів допомагає не шукати всі проблеми в одному місці.

Спільний код не гарантує однакової поведінки

Одна функція перевірки назви може працювати для iOS та Android. Проте набір клавіш, системні меню, доступний простір і поведінка повернення залежать від платформи. React Native має Platform і файли з платформними суфіксами для ситуацій, де справді потрібна окрема реалізація. Деталі наведено в Platform-Specific Code.

Не починай із двох повністю окремих екранів. Спершу сформулюй різницю: «На Android після вибору тексту нижня кнопка зміщується». Потім відтвори її й обери вузьке рішення. Розділення за платформами має пояснювати спостережувану потребу.

Застосунок має життя поза видимим екраном

Foreground означає активний видимий застосунок. Background означає, що користувач пішов на домашній екран або в інший застосунок. У RN AppState дозволяє спостерігати відповідні переходи; на iOS також є стан inactive, наприклад під час переходу чи переривання. У M05 використаємо це в поведінці даних. AppState

Перехід у фон не дорівнює завершенню процесу. Система може лишити пам'ять, обмежити виконання, призупинити застосунок або пізніше прибрати процес. Suspension — призупинене виконання; process termination — процес уже завершений. Точні правила залежать від платформи. Після завершення дані лише в пам'яті не є джерелом відновлення. Android: Processes and app lifecycle, Apple: Managing your app's life cycle

Для практики це означає: натиснути Home і повернутися недостатньо, щоб довести збереження. Field Notes у M01 може показати ту саму чернетку після короткого перемикання, але після нового виконання почне з початкових значень. У M08 зробимо persistence явною частиною контракту.

Приклад із поясненням

Це повний мінімальний екран, який можна вставити в src/app/index.tsx після M01-L02. Root layout з SafeAreaProvider вже має бути налаштований за тим уроком. Встановлення додаткових пакетів тут немає.

// src/app/index.tsx
import { StyleSheet, Text, View } from 'react-native';
import { SafeAreaView } from 'react-native-safe-area-context';

const places = ['Поділ', 'Стрийський парк', 'Старе місто'];

export default function HomeScreen() {
  return (
    <SafeAreaView style={styles.screen}>
      <Text style={styles.title}>Field Notes</Text>
      <Text style={styles.subtitle}>Місця, до яких хочеться повернутися</Text>
      <View style={styles.list}>
        {places.map((place) => (
          <View key={place} style={styles.card}>
            <Text style={styles.place}>{place}</Text>
          </View>
        ))}
      </View>
    </SafeAreaView>
  );
}

const styles = StyleSheet.create({
  screen: { flex: 1, backgroundColor: '#F4F6F8', paddingHorizontal: 20 },
  title: { fontSize: 30, fontWeight: '700', marginTop: 16 },
  subtitle: { fontSize: 16, color: '#475569', marginTop: 8 },
  list: { gap: 12, marginTop: 24 },
  card: { padding: 16, borderRadius: 12, backgroundColor: '#FFFFFF' },
  place: { fontSize: 18, color: '#0F172A' },
});

Очікуваний результат: заголовок, пояснення і три картки одна під одною. SafeAreaView бере безпечні відступи для системних областей через підключений provider. Ми використовуємо компонент із react-native-safe-area-context, відповідно до Expo safe-area-context; його механіку докладніше вивчимо в M02.

Статичний масив тут навмисно маленький. Назви унікальні й не змінюються, тому key={place} придатний саме для цього прикладу. У журналу, де можна додавати однакові назви, буде окремий id. У JSX немає HTML. Проте map, return, props і компонування функцій залишилися знайомими.

StyleSheet збирає стилі в іменовані об'єкти. Числа в layout мають мобільну модель розмірів, яку розберемо в M01-L04. Не потрібно заучувати кожен рядок зараз: спробуй пояснити призначення компонента, а невідомий API познач питанням.

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

Перед запуском у M01-L02 запиши три прогнози. Що відбудеться, якщо поміняти порядок places? Чи створить React Native браузерні div? Чи прокручуватиметься довгий список автоматично?

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

Порядок у масиві визначає порядок JSX. View не стає DOM елементом. Звичайний View не додає прокручування: для цього потрібний відповідний контейнер і layout. Якщо прогноз не збігся, опиши спостереження, а не підганяй його під очікування.

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

СимптомПричинаЯк локалізувати та виправити
Помилка про текст поза TextРядок вставлений безпосередньо в ViewЗнайди текстовий вузол; обгорни його в Text
document недоступнийПеренесено браузерний кодЗ'ясуй потрібну дію; зміни UI через props/state або API компонента
На іншому пристрої все надто тісноОцінено лише один екран і стандартний шрифтЗапиши розміри, збільш текст у системі, визнач вузьку ділянку layout
Після повного перезапуску зникли записиuseState помилково сприйнято як сховищеВідділи тимчасові дані від persistence; у M01 це очікуване обмеження
Єдиний успішний web запуск вважається перевіркою nativeПеревірено інше середовищеЗалиши iOS/Android неперевіреними до фактичного запуску

Практика

Склади документ «Мобільний контракт Field Notes» у власній лабораторній папці. Обери функцію «додати назву місця» й опиши її шлях від наміру користувача до результату. Додай власну схему оновлення UI та таблицю десяти звичних web припущень: що переноситься, що змінюється і чому. Код поки не потрібний.

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

  1. Є happy path: відкрити екран, ввести назву, натиснути додавання, побачити запис.
  2. Є п'ять граничних ситуацій: пробіли, довга назва, клавіатура, відсутність мережі, повний перезапуск.
  3. Для кожної ситуації визначено очікувану поведінку першого модуля, а не бажання «працює добре».
  4. Позначено, що логіка перевірки назви спільна, а клавіатуру перевіряємо на обох платформах.
  5. Окремо записано, що дані M01 тимчасові й не потребують permissions.
  6. Власна схема показує подію, state, новий опис UI, renderer і native екран; позначено, де може з'явитися проблема.
  7. Таблиця має десять конкретних припущень і пояснені мобільні відповідники. Використай теми JSX, тексту, стилів, браузерних APIs, scrolling, клавіатури, Back, permissions, життєвого циклу й перевірки платформ.

Додаткове ускладнення: намалюй два стани — порожній журнал і журнал із трьома картками. Підпиши ролі елементів. Не витрачай час на ідеальні кольори: головне — визначити дію і результат.

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

  1. Чому досвід React корисний у React Native, хоча браузерний DOM відсутній?
  2. Чи означає View те саме, що div, у всіх деталях?
  3. Який інструмент шукатимеш першим, якщо Metro не знаходить файл?
  4. Чому локальний state не є гарантією збереження журналу?
  5. Що означає «працює на iOS та Android» для маленької форми?

Відповіді та розбір

  1. Принципи композиції та оновлення зберігаються: UI є результатом props/state, а render має бути передбачуваним. Іншим є середовище, у якому renderer створює UI.
  2. Спільна роль контейнера допомагає розпочати. Події, стилі й APIs треба перевіряти за контрактом View; DOM можливості з аналогії не випливають.
  3. Починаємо з шляху import, наявності файлу, регістру та встановленої залежності. Це питання підготовки коду, а не дозволу операційної системи.
  4. State живе в пам'яті поточного виконання. Для відновлення після нового запуску потрібне окреме сховище і процедура читання. Fast Refresh може приховати цю відмінність під час розробки.
  5. Це фактичне проходження описаних сценаріїв на обох платформах: текст, клавіатура, натискання, порожня назва, доступний простір. Одна спільна кодова база цього автоматично не доводить.

Підказки до практики відкривай поступово:

  • Перша: почни з «коли користувач робить X, він бачить Y».
  • Друга: для перезапуску запиши «відновилися початкові три записи, додані вручну зникли». Це точна вимога M01.
  • Третя: для довгої назви визнач «текст переноситься, картка росте», а для пробілів — «новий запис не створюється, видно пояснення».

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

Для таблиці можна почати з трьох рядків: «контейнер div → View, без браузерного DOM», «Home і повернення означає збереження → пам'ять могла лишитися, persistence ще не доведена», «одна кодова база означає перевірені платформи → кожний сценарій фактично перевіряємо на iOS та Android». Решту сформулюй через власні web звички й матеріал уроку. Схема може бути простим текстовим ланцюжком; важливі зв'язки, а не інструмент малювання.

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

  • Через 1 день: без тексту уроку намалюй ланцюжок «натискання → state → опис UI → renderer → екран».
  • Через 7 днів: поясни колезі за дві хвилини різницю React Native, Expo та Metro на одному багу.
  • Через 21 день: переглянь контракт Field Notes. Які початкові обмеження вже зняті, які лишаються? Підтвердь кожне прикладом.

Далі — M01-L02: середовище Expo. Там цей концептуальний екран отримає конкретний проєкт, версії та шлях запуску.

Джерела

Перевірено 2026-10-11; React Native 0.86 і Expo SDK 57 відповідно до технічної бази курсу.

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

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

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

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

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

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

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

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