Ir al contenido

Среда React Native и Expo с PNPM

Профессиональная настройка среды разработки React Native с использованием Expo CLI и менеджера пакетов PNPM для iOS и Android.

0просмотры

Этот гид детализирует стандартную техническую процедуру подготовки профессиональной среды разработки для React Native с использованием Expo и менеджера зависимостей PNPM. Он охватывает все, от предварительных требований системы до инициализации и локального развертывания современного проекта с поддержкой нескольких платформ (iOS и Android).


1. Expo и PNPM: Определенно лучшая комбинация

Sección titulada «1. Expo y PNPM: La Combinación Definitiva»

В настоящее время официальная документация React и техническое сообщество рекомендуют комбинацию Expo и PNPM как абсолютный стандарт рабочей среды:

  • Expo Router: Маршрутизация на основе файлов (аналогично Next.js/Astro) полностью интегрирована и типизирована.
  • PNPM (Performant NPM): Решает серьезные исторические проблемы медленности и уязвимости NPM за счет архитектуры, основанной на физических ссылках (hard links) и адресуемом хранилище.
  • EAS Build/Submit: Облачная сборка родных бинарных файлов (.apk, .aab, .ipa) без необходимости дорогого локального оборудования.

2. Предварительные требования к среде

Sección titulada «2. Requisitos Previos del Entorno»

Перед инициализацией любого приложения крайне важно иметь следующие инструменты, установленные в системе:

Базовые инструменты

Sección titulada «Herramientas de Base»
  • Node.js (LTS): Рекомендуется использовать активную версию с долгосрочной поддержкой.
  • Менеджер пакетов: pnpm (Установлен глобально через npm i -g pnpm или corepack enable).
  • Git: Для управления версиями проекта.

Для эмуляции Android (Windows/macOS/Linux)

Sección titulada «Para Emulación Android (Windows/macOS/Linux)»
  1. JDK (Java Development Kit): Установить OpenJDK 17 или выше.
  2. Android Studio: Установите Android Studio и настройте:
    • Android SDK: Убедиться, что скачана рекомендуемая версия SDK последнего релиза Expo.
    • Android SDK Platform-Tools: Обязательно добавить в переменные среды системы (PATH).
    • Виртуальное устройство (AVD): Создать эмулятор с Google Play Services для локальных тестов.

Для эмуляции iOS (Эксклюзив для macOS)

Sección titulada «Para Emulación iOS (Exclusivo en macOS)»
  1. Xcode: Скачать напрямую из Mac App Store.
  2. Инструменты командной строки Xcode: Установите, выполнив в терминале:
    Ventana de terminal
    xcode-select --install
  3. Cocoapods: Менеджер зависимостей iOS (sudo gem install cocoapods).

3. Инициализация проекта с помощью PNPM

Sección titulada «3. Inicialización del Proyecto con PNPM»

Чтобы создать новый современный проект React Native с Expo, используя PNPM, выполните официальную интерактивную команду в рабочем каталоге:

Ventana de terminal
# Crear proyecto con la plantilla por defecto recomendada usando PNPM
pnpm dlx create-expo-app mi-app-ia --template tabs

Рекомендуемая структура директорий

Sección titulada «Estructura de Directorios Recomendada»
mi-app-ia/
├── app/ # Directorio de rutas (Expo Router)
│ ├── (tabs)/ # Grupo de pestañas de navegación inferior
│ │ ├── _layout.tsx # Definición del enrutador de pestañas
│ │ ├── index.tsx # Pantalla de inicio
│ │ └── explorar.tsx # Pantalla de exploración
│ ├── _layout.tsx # Enrutador raíz (Modales, Autenticación, etc.)
│ └── +not-found.tsx # Pantalla 404 de respaldo
├── assets/ # Imágenes, fuentes y recursos multimedia
├── components/ # Componentes UI reutilizables
├── constants/ # Colores, configuraciones globales y APIs
├── package.json # Dependencias y scripts del ciclo de vida
└── app.json # Configuración nativa del manifiesto de Expo

4. Выполнение в режиме разработки

Sección titulada «4. Ejecución en Modo de Desarrollo»

После завершения установки зависимостей с помощью PNPM, перейдите в каталог проекта и запустите сервер разработки:

Ventana de terminal
cd mi-app-ia
pnpm expo start

Интерактивные опции запуска в консоли

Sección titulada «Opciones de Lanzamiento Interactivas en la Consola»

При запуске сервера Expo отобразится QR-код и интерактивные опции управления:

  • a Открыть в Android: Запускает приложение в активном эмуляторе Android Studio или устройстве, подключенном по USB.
  • i Открыть в iOS: Запускает приложение в симуляторе iOS Xcode (требуется macOS).
  • w Открыть в Web: Инициализирует веб-версию приложения (полезно для быстрой верстки).
  • r Перезагрузить приложение: Принудительно обновляет интерфейс пользователя на всех подключенных устройствах.

5. Список проверки среды

Sección titulada «5. Lista de Verificación del Entorno»

Убедитесь в правильном состоянии вашей среды перед началом разработки. Запустите команду автоматической диагностики Expo через PNPM:

Ventana de terminal
pnpm dlx expo-doctor

Результаты диагностики и состояния

Sección titulada «Resultados de Diagnóstico y Estado»
  • ✓ Установка Node.js LTS: Совместимая и оптимальная версия.
  • ✓ Переменные окружения: ANDROID_HOME и JAVA_HOME назначены правильно.
  • ✓ SDK Android: Минимальные компоненты установлены и распознаны adb.
  • ✓ Expo CLI: SDK синхронизировано с версией React Native, объявленной в package.json.
  • ✕ Cocoapods (Предупреждение в Windows): Успешно проигнорировано, если вы не разрабатываете для iOS на этой рабочей станции.