For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/mobile/local-setup.md (or send Accept: text/markdown).

Запуск мобильного приложения

Подключите Expo к достижимому API разработки.

Задать вопрос об этом руководстве

1. Подготовьте компьютер, телефон и серверную часть

Завершите. Прежде чем начать, откройте репозиторий для мобильных устройств или монорепозиторий для всех платформ в своем редакторе. В разделе «Терминал» → «Новый терминал» в корне репозитория выполните приведенную ниже команду установки. Подождите, пока он закончится. Установите Expo Go на свой телефон, используя официальную страницу Expo, указанную ниже; его версия должна поддерживать версию Expo SDK, записанную в apps/mobile/package.json..

Бэкэнд — это веб-сервер, который обрабатывает вход в систему, данные рабочей области и запросы ИИ. Если ваша проверка содержит apps/web, сначала запустите веб-настройку в другом терминале и оставьте этот сервер включенным. Завершите настройку Postgres, прежде чем пытаться выполнить собственную регистрацию или вход в систему. Оформление заказа только для мобильных устройств не содержит apps/web: вместо этого подключите его к работающему, отдельно предоставленному бэкэнду. Запуск Expo запускает сервер предварительного просмотра экрана, а не серверную часть.

Подключите телефон и компьютер к одному Wi-Fi. Временно отключите VPN, если он блокирует локальные соединения. localhost телефона означает сам телефон. Используйте адрес частной сети вашего компьютера для физического телефона или устройства Android; Симулятор iOS на том же Mac может использовать http://localhost:3000,, а эмулятор Android обычно использует http://10.0.2.2:3000..

corepack pnpm install

2. Найдите и проверьте внутренний адрес.

В Windows запустите ipconfig в новом терминале PowerShell, найдите активный адаптер Wi-Fi и прочитайте адрес IPv4. В macOS откройте «Системные настройки» → «Wi-Fi» → «Сведения» → «TCP/IP» и прочитайте IP-адрес. В Linux откройте настройки сети и прочитайте адрес IPv4. Адрес может выглядеть как 192.168.1.25; ваш обычно будет другим.

Если адрес вашего компьютера 192.168.1.25, откройте http://192.168.1.25:3000 в браузере телефона во время работы веб-сервера. Подставьте свой фактический адрес. Прежде чем продолжить, домашняя страница должна загрузиться. Разрешите приложение Node в частных сетях, если об этом попросит брандмауэр Windows. Если не загружается, проверьте адрес, Wi-Fi, фаервол и работающий веб-сервер; Туннель Expo содержит только пакет предварительной версии и не делает доступным ваш отдельный API.

# Windows PowerShell only:
ipconfig

3. Создайте файл конфигурации мобильного приложения.

В проводнике редактора разверните «Приложения» → «Мобильные устройства», создайте новый файл с именем .env.local и вставьте в него приведенную ниже конфигурацию. Замените 192.168.1.25 адресом, который вы только что протестировали, или используйте предоставленный вами внутренний адрес HTTPS. Сохраните файл. Его полный путь — apps/mobile/.env.local; root .env не читается Expo автоматически.

Оставьте настройку покупки телефона выключенной для первого предварительного просмотра. EXPO_PUBLIC_ означает, что параметр включен в приложение для телефона, поэтому эти значения должны содержать только общедоступные URL-адреса, схемы и общедоступные настройки клиента. Не вставляйте сюда секреты AI-провайдера, базы данных или биллинга. Веб-сервер имеет собственный apps/web/.env.local; изменение файла Mobile не приводит к изменению сервера.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4. Запустите Expo и откройте предварительный просмотр.

Из корня репозитория выполните команду ниже. Дождитесь QR-кода и сообщения об ожидании в метро. Держите этот терминал и внутренний терминал открытыми. На Android откройте Expo Go и отсканируйте QR-код; на iPhone используйте камеру, отсканируйте код и откройте его в Expo Go. QR-код открывает приложение для разработки, а не вашу внутреннюю страницу.

Успех означает, что на вашем устройстве откроется экран входа в приложение. Если покупки отключены, это предварительный просмотр пользовательского интерфейса; завершите настройку веб-аутентификации на основе базы данных, прежде чем тестировать вход в систему, сохраненные рабочие области или чат. Если вашей целью является установленный симулятор, нажмите a в терминале Expo для Android или i для iOS. iOS Simulator требует macOS и Xcode; он не может работать в Windows.

corepack pnpm --filter @supastack/mobile start

5. Восстановление после ошибок предварительного просмотра и тестирование реальных потоков

Если Expo Go сообщает о несовместимом проекте, сравните поддерживаемый им SDK с apps/mobile/package.json и используйте совместимую версию с официальной страницы Expo. Не обновляйте версии зависимостей комплекта только для того, чтобы закрыть сообщение. Если требуемый собственный модуль недоступен, следуйте инструкциям «Мобильные сборки», чтобы получить сборку для разработки, содержащую этот модуль.

Если вход в систему завершается неудачно из-за сетевой ошибки, сначала повторите серверную часть URL в браузере телефона. Если URL работает, но вход в систему не удался, проверьте внутренний терминал и проверьте Postgres и миграцию. Локальный демонстрационный сеанс /dashboard не выполняет вход на телефоне. Если конфигурация кажется устаревшей, нажмите Ctrl + C в терминале Expo, затем выполните приведенную ниже команду перезапуска и снова откройте предварительный просмотр.

Expo Go не может доказать подлинность StoreKit или поведения при покупке/восстановлении счетов Play. Следите за покупками в приложении и сборками для мобильных устройств, чтобы получить сборку для разработки EAS и хранить тестовые учетные записи. Первые собственные сборки и регистрация учетной записи могут занять более пяти минут. Чтобы остановить предварительный просмотр, нажмите Ctrl + C в терминале Expo; по завершении остановите серверную часть отдельно.

corepack pnpm --filter @supastack/mobile start --clear