의존성 관리 및 PNPM
패키지 관리의 최선의 실천, 네이티브 의존성 설치 및 왜 PNPM이 React Native에서 NPM보다 무한히 우월하고 안전한가?
0조회
이 가이드는 리액트 네이티브 프로젝트에서 의존성의 설치, 업데이트 및 통합에 대한 올바른 방법론을 체계적으로 다루며, PNPM이 전통적인 패키지 관리자인 NPM과 비교하여 최적의 선택인 이유를 설명합니다.
1. 왜 PNPM이 NPM보다 훨씬 우월한가?
Sección titulada «1. ¿Por qué PNPM es muy superior a NPM?»역사적으로 NPM은 개발 프로젝트의 보안, 안정성 및 성능에 직접적인 영향을 미치는 심각한 아키텍처 문제를 가지고 있습니다.
- 팬텀 디펜던시(Phantom Dependencies):
- 문제: NPM은 평평한 의존성 트리를 사용합니다 (
flat node_modules).A패키지를 설치하고, 이 패키지가 내부적으로B패키지를 요구하면, NPM은B을node_modules의 루트에 직접 배치합니다. - 보안 위험: 코드가
import을B에서 직접 참조할 수 있으며, 이는 당신의package.json에 공식적으로 선언되지 않았을 수 있습니다. 미래에A을 업데이트하여B에 의존하지 않게 되면, 코드가 예기치 않게 생산 환경에서 작동하지 않게 됩니다. 또한, 공급망 공격(Supply Chain Attacks)으로 이어질 수 있으며, 악의적인 코드가 선언되지 않은 평평한 패키지를 간접적으로 접근할 수 있게 됩니다.
- 문제: NPM은 평평한 의존성 트리를 사용합니다 (
- 파일 중복 및 디스크 잠금:
- NPM은 각 로컬 프로젝트에서 동일한 패키지의 물리적 중복 복사본을 다운로드하여, 하드디스크에 불필요한 기가바이트의 코드로 가득 채웁니다.
- 과도한 지연:
- 평평한 트리 해석 프로세스는 각 설치 시 수천 개의 폴더를 재계산하고 인덱싱해야 하며, 지속적 통합 및 배포(CI/CD) 워크플로우의 속도를 느리게 만듭니다.
PNPM의 해결책: 구조와 보안의 혁신
Sección titulada «La Solución de PNPM: Innovación en Estructura y Seguridad»PNPM (Performant NPM)은 완전히 혁신적인 접근 방식을 통해 이러한 문제를 해결합니다:
graph TD A[Almacén Central de PNPM en Disco] -->|Enlace Físico / Hard Link| B["mi-proyecto/node_modules/.pnpm"] B -->|Enlaces Simbólicos / Symlinks| C["Dependencias Declaradas strictly en package.json"]- 비평면 node_modules 구조:
- PNPM은 심볼릭 링크(symlinks)를 생성합니다.
package.json에 명시적으로 선언된 패키지만node_modules의 루트에서 접근할 수 있습니다. 선언되지 않은 유령 패키지를 가져오는 것은 물리적으로 불가능하며, 이 공격 벡터를 무력화합니다.
- PNPM은 심볼릭 링크(symlinks)를 생성합니다.
- 콘텐츠 기반 주소 지정 스토리지(글로벌 스토어):
- 모든 패키지가 시스템의 전역 디렉토리에 단 한 번 다운로드됩니다. 프로젝트에서 이 유일한 저장소로 향하는 물리적인 하드 링크가 생성됩니다. 디스크 공간의 90%를 절약할 수 있습니다!
- 더 빠른 속도:
- 물리적인 파일 복사 없이 전역 캐시에서 읽기 때문에, PNPM의 설치는 NPM보다 최대 3배 빠릅니다.
| 특성 | NPM | Yarn (클래식) | PNPM |
|---|---|---|---|
| 유령 종속성 방지 | ✕ 아니오 | ✕ 아니오 | ✓ 네 (디자인에 따라) |
| 효율적인 디스크 공간 | ✕ 아니오 (물리적 복사) | ✕ 아니오 (물리적 복사) | ✓ 네 (글로벌 하드 링크) |
| 설치 속도 | 느림 | 중간 | 초고속 |
| 링크 보안 | 바하 (평평한 나무) | 바하 (평평한 나무) | 알타 (엄격한 구조) |
3. PNPM 및 Expo와의 의존성 통합
Sección titulada «3. Integración de Dependencias con PNPM y Expo»React Native는 모바일 네이티브 플랫폼용 컴파일 코드를 포함하고 있기 때문에, 모듈 설치는 조율하여 이루어져야 합니다:
추천 명령어
네이티브 모듈을 포함하는 모든 패키지에 대해, 원시 설치 명령어 대신 항상 pnpm expo install를 사용하십시오.
pnpm expo install <paquete>를 실행할 때:
- Expo는 활성 SDK 버전과 호환되고 인증된 정확한 버전을 확인합니다.
- PNPM은
node_modules/.pnpm/에서 물리적 링크 구조를 안전하게 해결하여 초고속 설치를 수행합니다.
# Instalar iconos vectoriales y almacenamiento asíncrono nativo de forma segurapnpm expo install lucide-react-native @react-native-async-storage/async-storage4. 네이티브 컴파일 및 통합
Sección titulada «4. Compilación e Integración Nativa»PNPM으로 패키지를 설치한 후, Gradle(안드로이드) 및 CocoaPods(iOS)의 네이티브 폴더와의 통합은 자연스럽게 실행됩니다:
# Compilar binarios de desarrollo nativos integrando las dependencias instaladaspnpm expo run:androidpnpm expo run:iospnpm dlx expo-doctor: SDK 및 프로젝트의 네이티브 종속성의 일반적인 건강 상태를 진단하고 검증합니다.pnpm expo install --fix: 의존성 트리에서 어떤 버전 불일치도 자동으로 즉시 해결하여 Expo 추천 릴리스에 맞춥니다.

