React Native 및 Expo 환경에서 PNPM
iOS 및 Android용 Expo CLI 및 PNPM 패키지 관리자를 사용한 React Native 개발 환경 설정
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(효율적인 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)»- JDK (Java 개발 키트): OpenJDK 17 이상을 설치합니다.
- Android Studio: Android Studio를 설치하고 다음을 구성합니다:
- Android SDK: 최신 Expo 릴리스에서 추천하는 SDK 버전을 다운로드했는지 확인하세요.
- Android SDK Platform-Tools: 시스템 환경 변수에 필수적으로 추가되었습니다 (
PATH). - 가상 장치 (AVD): 로컬 테스트용 Google Play Services가 포함된 에뮬레이터를 생성하세요.
iOS 에뮬레이션 (macOS 전용)
Sección titulada «Para Emulación iOS (Exclusivo en macOS)»- Xcode: Mac App Store에서 직접 다운로드되었습니다.
- Xcode Command Line Tools: 터미널에서 다음을 실행하여 설치합니다:
Ventana de terminal xcode-select --install - Cocoapods: iOS 종속성 관리자 (
sudo gem install cocoapods).
3. PNPM을 사용한 프로젝트 초기화
Sección titulada «3. Inicialización del Proyecto con PNPM»React Native 및 Expo를 사용하여 새로운 현대적인 프로젝트를 생성하려면, 작업 디렉토리에서 공식적인 상호작용 명령을 실행하세요:
# Crear proyecto con la plantilla por defecto recomendada usando PNPMpnpm dlx create-expo-app mi-app-ia --template tabsmi-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 ExpoPNPM으로 종속성을 설치한 후, 프로젝트 폴더로 이동하여 개발 서버를 시작하세요:
cd mi-app-iapnpm expo startExpo 서버를 시작하면 QR 코드와 대화형 제어 옵션이 표시됩니다:
- a Android에서 열기: Android Studio의 활성 에뮬레이터 또는 USB로 연결된 디바이스에서 애플리케이션을 실행합니다.
- i iOS에서 열기: Xcode의 iOS 시뮬레이터에서 애플리케이션을 실행합니다 (macOS 필요).
- w 웹에서 열기: 애플리케이션의 웹 버전을 초기화합니다 (빠른 프로토타이핑에 유용).
- r 애플리케이션 재로드: 연결된 모든 디바이스에서 UI 전체를 강제로 새로고침합니다.
개발을 시작하기 전에 환경의 올바른 상태를 확인하세요. PNPM을 통해 자동화된 Expo 진단 명령을 실행합니다:
pnpm dlx expo-doctor- ✓ Node.js LTS 설치: 호환 및 최적의 버전입니다.
- ✓ 환경 변수:
ANDROID_HOME및JAVA_HOME이 올바르게 할당되었습니다. - ✓ Android SDK: 최소 구성 요소가 설치되어 있으며
adb에서 인식됩니다. - ✓ Expo CLI:
package.json에 선언된 React Native 버전과 동기화된 SDK입니다. - ✕ Cocoapods (Windows 경고): 이 작업 공간에서 iOS 개발을 하지 않는 경우 성공적으로 무시됩니다.

