Ir al contenido

React Native 및 Expo 환경에서 PNPM

iOS 및 Android용 Expo CLI 및 PNPM 패키지 관리자를 사용한 React Native 개발 환경 설정

0조회

이 가이드는 React Native를 사용하여 Expo와 종속성 관리자인 PNPM을 활용한 전문 개발 환경을 준비하는 표준 기술 절차를 설명합니다. 시스템 전제 조건부터 멀티플랫폼(이 iOS 및 Android)을 지원하는 현대적인 프로젝트 초기화 및 로컬 배포까지 다룹니다.


현재 React 공식 문서와 기술 커뮤니티는 Expo와 PNPM의 조합을 절대적인 표준 작업 환경으로 추천합니다:

  • Expo Router: 파일 기반 라우팅(Next.js/Astro와 유사)으로 완전히 통합되고 타입이 지정된 기능입니다.
  • PNPM(효율적인 NPM): 내용 기반 링크(hard links) 및 저장소 아키텍처를 통해 NPM의 역사적인 느린 속도 및 취약성 문제를 해결합니다.
  • EAS Build/Submit: 비용이 많이 드는 로컬 하드웨어 없이 클라우드에서 네이티브 바이너리(.apk, .aab, .ipa)를 컴파일합니다.

어떤 애플리케이션을 초기화하기 전에 시스템에 다음 도구가 설치되어 있어야 합니다:

  • 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 개발 키트): OpenJDK 17 이상을 설치합니다.
  2. Android Studio: Android Studio를 설치하고 다음을 구성합니다:
    • Android SDK: 최신 Expo 릴리스에서 추천하는 SDK 버전을 다운로드했는지 확인하세요.
    • Android SDK Platform-Tools: 시스템 환경 변수에 필수적으로 추가되었습니다 (PATH).
    • 가상 장치 (AVD): 로컬 테스트용 Google Play Services가 포함된 에뮬레이터를 생성하세요.
  1. Xcode: Mac App Store에서 직접 다운로드되었습니다.
  2. Xcode Command Line Tools: 터미널에서 다음을 실행하여 설치합니다:
    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를 사용하여 새로운 현대적인 프로젝트를 생성하려면, 작업 디렉토리에서 공식적인 상호작용 명령을 실행하세요:

Ventana de terminal
# Crear proyecto con la plantilla por defecto recomendada usando PNPM
pnpm dlx create-expo-app mi-app-ia --template tabs
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

PNPM으로 종속성을 설치한 후, 프로젝트 폴더로 이동하여 개발 서버를 시작하세요:

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

Expo 서버를 시작하면 QR 코드와 대화형 제어 옵션이 표시됩니다:

  • a Android에서 열기: Android Studio의 활성 에뮬레이터 또는 USB로 연결된 디바이스에서 애플리케이션을 실행합니다.
  • i iOS에서 열기: Xcode의 iOS 시뮬레이터에서 애플리케이션을 실행합니다 (macOS 필요).
  • w 웹에서 열기: 애플리케이션의 웹 버전을 초기화합니다 (빠른 프로토타이핑에 유용).
  • r 애플리케이션 재로드: 연결된 모든 디바이스에서 UI 전체를 강제로 새로고침합니다.

개발을 시작하기 전에 환경의 올바른 상태를 확인하세요. PNPM을 통해 자동화된 Expo 진단 명령을 실행합니다:

Ventana de terminal
pnpm dlx expo-doctor
  • ✓ Node.js LTS 설치: 호환 및 최적의 버전입니다.
  • ✓ 환경 변수: ANDROID_HOME 및 JAVA_HOME이 올바르게 할당되었습니다.
  • ✓ Android SDK: 최소 구성 요소가 설치되어 있으며 adb에서 인식됩니다.
  • ✓ Expo CLI: package.json에 선언된 React Native 버전과 동기화된 SDK입니다.
  • ✕ Cocoapods (Windows 경고): 이 작업 공간에서 iOS 개발을 하지 않는 경우 성공적으로 무시됩니다.