Как запустить приложение React Native — на телефоне и эмуляторе

React Native приложение можно запустить несколькими способами: через Expo Go на телефоне, через Android Emulator, через iOS Simulator на Mac или на реальном устройстве по USB. Для новичка самый быстрый способ — Expo Go.

Способы запуска React Native

React Native можно запускать разными способами, и каждый решает свою задачу. Для обучения обычно хватает Expo Go, но эмуляторы и реальное устройство помогают быстрее увидеть проблемы платформы, сети и производительности.

Лучше попробовать хотя бы два варианта: Expo Go для быстрого старта и эмулятор или реальное устройство для проверки поведения. Так быстрее становится понятно, где учебный комфорт, а где реальные ограничения платформы.

Способ 1 — Expo Go

• Установите Expo Go из App Store или Google Play.
• Запустите проект командой npx expo start.
• Отсканируйте QR-код телефоном.
• Держите телефон и компьютер в одной Wi-Fi сети.

npx expo start

Если сеть не пропускает локальное подключение, используйте tunnel. Он медленнее, но часто помогает в общественных сетях.

npx expo start --tunnel

Способ 2 — Android Emulator

Для эмулятора нужен Android Studio. Установите Android SDK, создайте виртуальное устройство в Device Manager и запустите его. Потом в терминале Expo нажмите клавишу a.

npx expo start
# затем нажмите a

Способ 3 — iOS Simulator

iOS Simulator доступен только на macOS через Xcode. Запустите Expo и нажмите i. Если Xcode не установлен, iOS Simulator не откроется.

npx expo start
# затем нажмите i

Способ 4 — реальный Android по USB

• Включите режим разработчика на телефоне.
• Включите USB debugging.
• Подключите телефон кабелем.
• Разрешите отладку на экране телефона.
• Запустите проект и нажмите a.

Диагностика проблем запуска

Если приложение не открылось, не стоит сразу переписывать код. Сначала нужно понять, где сбой: в сети, Expo, SDK, эмуляторе, USB-подключении или самом проекте. Такой порядок экономит много времени.

Ошибки запуска часто повторяются от проекта к проекту. Если вы научитесь проверять сеть, версию SDK, способ подключения и чистый новый проект, дальнейшая разработка React Native станет спокойнее.

Частые ошибки

npx expo start --clear

Как выбрать способ запуска

Для первого дня обучения берите Expo Go на реальном телефоне. Для регулярной разработки удобнее добавить Android Emulator, потому что его проще держать рядом с редактором. iOS Simulator нужен, если вы проверяете iOS-поведение и работаете на Mac.

• Expo Go — самый быстрый старт.
• Android Emulator — удобен для ежедневной отладки Android.
• iOS Simulator — нужен для iOS и доступен только на macOS.
• USB-устройство — хорошо показывает реальные проблемы телефона.

LAN, Local и Tunnel

Expo может предлагать разные режимы подключения. LAN быстрый, если телефон и компьютер в одной сети. Tunnel помогает, когда сеть закрывает локальные подключения, но он медленнее. Local нужен, когда приложение запускается на эмуляторе на той же машине.

Перед тем как искать ошибку в коде

• Перезапустите dev-сервер с —clear.
• Проверьте, что открыли правильный проект.
• Убедитесь, что телефон видит компьютер в сети.
• Обновите Expo Go, если проект требует свежий SDK.
• Посмотрите ошибку в терминале Metro, а не только на экране телефона.

Как быстро понять, где проблема запуска

При запуске React Native важно отделить проблему проекта от проблемы устройства. Если приложение не открывается на телефоне, это ещё не значит, что код сломан: часто виноваты сеть, Expo Go, SDK или эмулятор.

Сначала проверьте самый короткий путь: новый чистый проект и Expo Go в одной сети. Если чистый проект открывается, проблема в вашем коде или зависимостях. Если нет — смотрите сеть, устройство, эмулятор и версию SDK.

Проверка по шагам

• сначала запустите npx expo start —clear;
• проверьте, что телефон и компьютер в одной Wi-Fi сети;
• если QR не открывается, включите tunnel-режим;
• если ошибка только на эмуляторе, проверьте Android Studio и SDK;
• если ошибка только на iOS, проверьте Xcode и версию simulator.

Какой способ выбрать для обучения

Для первых уроков проще всего Expo Go на реальном телефоне. Когда начнёте часто отлаживать интерфейс, добавьте Android Emulator. iOS Simulator имеет смысл подключать, если у вас Mac и вы уже проверяете поведение под iOS.

Что записывать в заметки

Сохраняйте точный текст ошибки, версию Expo SDK, модель устройства и способ запуска. Это сэкономит время, когда через месяц похожая проблема повторится.

Добавляйте к заметке команду, которой запускали проект, и что именно уже пробовали: перезапуск dev-сервера, смену сети, обновление Expo Go, очистку кэша. Такая история помогает не ходить по кругу при следующей ошибке.