Ir al contenido

Gestão de Dependências e PNPM

Buenas práticas na gestão de pacotes, instalação de dependências nativas e por que PNPM é infinitamente superior e mais seguro que NPM em React Native.

0lecturas

Esta guia aborda de forma exaustiva as metodologias correctas para a instalação, atualização e integração de dependências em projetos de React Native utilizando PNPM, detallando além por que é a opção óptima frente ao gestor de pacotes tradicional NPM.


1. Por que o PNPM é muito superior ao NPM?

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

Históricamente, NPM ha arrastrado graves problemas arquitectónicos que afectan directamente a seguridad, estabilidade e rendimiento de los proyectos de desarrollo:

  1. Dependencias Fantasma (Phantom Dependencies):
    • El Problema: NPM utiliza un árbol de dependencias plano (flat node_modules). Si instalas el paquete A, y este requiere internamente el paquete B, NPM coloca a B directamente en la raíz de node_modules.
    • El Riesgo de Seguridad: Tu código puede hacer import de B directamente sin declararlo formalmente en tu package.json. Si en el futuro actualizas A y deja de depender de B, tu código se romperá en producción de forma inesperada. Además, abre la puerta a ataques de cadena de suministro (Supply Chain Attacks) donde código malicioso accede de forma inadvertida a paquetes planos no declarados.
  2. Duplicación de Archivos y Bloqueo de Disco:
    • O NPM baixa cópias físicas redundantes dos mesmos pacotes em cada projeto local da sua máquina, enchendo seu disco rígido com gigabytes de código desnecessário.
  3. Lentitud Excesiva:
    • O processo de resolução da árvore plana exige recalcular e indexar milhares de pastas em cada instalação, diminuindo a velocidade dos seus fluxos de integração e implantação contínua (CI/CD).

A Solução do PNPM: Inovação em Estrutura e Segurança

Sección titulada «La Solución de PNPM: Innovación en Estructura y Seguridad»

PNPM (Performant NPM) resolve esses problemas mediante um enfoque completamente revolucionário:

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"]
  • Estructura No Plana de node_modules:
    • PNPM cria links simbólicos (symlinks). Somente os pacotes declarados explicitamente em seu package.json são acessíveis na raiz de node_modules. É fisicamente impossível importar pacotes fantasma não declarados, anulando este vetor de ataque.
  • Almacenamiento Direccionable por Contenido (Global Store):
    • Todos os pacotes se descargam uma só vez em um diretório global do sistema. Em seus projetos se criam links físicos (hard links) para esse único armazenamento. Ahorra até um 90% de espaço de disco!
  • Velocidad Superior:
    • Dado que não copia arquivos físicamente e lê do cache global, as instalações com PNPM são até 3 vezes mais rápidas que com NPM.

CaracterísticaNPMYarn (Classic)PNPM
Prevência de Dependências Fantasma✕ Não✕ Não✓ Sí (Por diseño)
Espaço de Disco Eficiente✕ Não (Copia física)✕ Não (Copia física)✓ Sí (Hard Links globais)
Velocidade de InstalaçãoLentaMédiaUltra Rápida
Segurança de EnlaceBaixa (Árvore plana)Baixa (Árvore plana)Alta (Estructura estricta)

3. Integração de Dependências com PNPM e Expo

Sección titulada «3. Integración de Dependencias con PNPM y Expo»

Como o React Native contém código compilado para plataformas móveis nativas, a instalação de módulos deve ser feita de forma coordenada:

Comando Recomendado

Para qualquer pacote que contém módulos nativos, utilize sempre pnpm expo install em lugar de comandos de instalação raw.

Ao executar pnpm expo install <paquete>:

  1. O Expo verifica a versão exata certificada e compatível com a versão ativa do seu SDK.
  2. PNPM realiza a instalação ultra rápida resolviendo de forma segura a estrutura física de enlazado em 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

Uma vez instalados os pacotes com o PNPM, a integração com as pastas nativas do Gradle (Android) e CocoaPods (iOS) é executada de forma natural:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: Diagnostica e valida a saúde geral do SDK e das dependências nativas do projeto.
  • pnpm expo install --fix: Resolve de forma automática e imediata qualquer versão desalineada em seu árbol de dependências, forçando a alinhar-se à release recomendada de Expo.