Ir al contenido

의존성 관리 및 PNPM

패키지 관리의 최선의 실천, 네이티브 의존성 설치 및 왜 PNPM이 React Native에서 NPM보다 무한히 우월하고 안전한가?

0조회

이 가이드는 리액트 네이티브 프로젝트에서 의존성의 설치, 업데이트 및 통합에 대한 올바른 방법론을 체계적으로 다루며, PNPM이 전통적인 패키지 관리자인 NPM과 비교하여 최적의 선택인 이유를 설명합니다.


1. 왜 PNPM이 NPM보다 훨씬 우월한가?

Sección titulada «1. ¿Por qué PNPM es muy superior a NPM?»

역사적으로 NPM은 개발 프로젝트의 보안, 안정성 및 성능에 직접적인 영향을 미치는 심각한 아키텍처 문제를 가지고 있습니다.

  1. 팬텀 디펜던시(Phantom Dependencies):
    • 문제: NPM은 평평한 의존성 트리를 사용합니다 (flat node_modules). A 패키지를 설치하고, 이 패키지가 내부적으로 B 패키지를 요구하면, NPM은 B을 node_modules의 루트에 직접 배치합니다.
    • 보안 위험: 코드가 import을 B에서 직접 참조할 수 있으며, 이는 당신의 package.json에 공식적으로 선언되지 않았을 수 있습니다. 미래에 A을 업데이트하여 B에 의존하지 않게 되면, 코드가 예기치 않게 생산 환경에서 작동하지 않게 됩니다. 또한, 공급망 공격(Supply Chain Attacks)으로 이어질 수 있으며, 악의적인 코드가 선언되지 않은 평평한 패키지를 간접적으로 접근할 수 있게 됩니다.
  2. 파일 중복 및 디스크 잠금:
    • NPM은 각 로컬 프로젝트에서 동일한 패키지의 물리적 중복 복사본을 다운로드하여, 하드디스크에 불필요한 기가바이트의 코드로 가득 채웁니다.
  3. 과도한 지연:
    • 평평한 트리 해석 프로세스는 각 설치 시 수천 개의 폴더를 재계산하고 인덱싱해야 하며, 지속적 통합 및 배포(CI/CD) 워크플로우의 속도를 느리게 만듭니다.

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의 루트에서 접근할 수 있습니다. 선언되지 않은 유령 패키지를 가져오는 것은 물리적으로 불가능하며, 이 공격 벡터를 무력화합니다.
  • 콘텐츠 기반 주소 지정 스토리지(글로벌 스토어):
    • 모든 패키지가 시스템의 전역 디렉토리에 단 한 번 다운로드됩니다. 프로젝트에서 이 유일한 저장소로 향하는 물리적인 하드 링크가 생성됩니다. 디스크 공간의 90%를 절약할 수 있습니다!
  • 더 빠른 속도:
    • 물리적인 파일 복사 없이 전역 캐시에서 읽기 때문에, PNPM의 설치는 NPM보다 최대 3배 빠릅니다.

특성NPMYarn (클래식)PNPM
유령 종속성 방지✕ 아니오✕ 아니오✓ 네 (디자인에 따라)
효율적인 디스크 공간✕ 아니오 (물리적 복사)✕ 아니오 (물리적 복사)✓ 네 (글로벌 하드 링크)
설치 속도느림중간초고속
링크 보안바하 (평평한 나무)바하 (평평한 나무)알타 (엄격한 구조)

React Native는 모바일 네이티브 플랫폼용 컴파일 코드를 포함하고 있기 때문에, 모듈 설치는 조율하여 이루어져야 합니다:

추천 명령어

네이티브 모듈을 포함하는 모든 패키지에 대해, 원시 설치 명령어 대신 항상 pnpm expo install를 사용하십시오.

pnpm expo install <paquete>를 실행할 때:

  1. Expo는 활성 SDK 버전과 호환되고 인증된 정확한 버전을 확인합니다.
  2. PNPM은 node_modules/.pnpm/에서 물리적 링크 구조를 안전하게 해결하여 초고속 설치를 수행합니다.
Ventana de terminal
# Instalar iconos vectoriales y almacenamiento asíncrono nativo de forma segura
pnpm expo install lucide-react-native @react-native-async-storage/async-storage

PNPM으로 패키지를 설치한 후, Gradle(안드로이드) 및 CocoaPods(iOS)의 네이티브 폴더와의 통합은 자연스럽게 실행됩니다:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: SDK 및 프로젝트의 네이티브 종속성의 일반적인 건강 상태를 진단하고 검증합니다.
  • pnpm expo install --fix: 의존성 트리에서 어떤 버전 불일치도 자동으로 즉시 해결하여 Expo 추천 릴리스에 맞춥니다.