pnpm add <pkg>
Instalar el paquete y cualquier paquete que dependa de el. Por defecto, cualquier nuevo paquete se instala como una dependencia de producción.
TL;DR
Comando | Significado |
---|---|
pnpm add sax | Se guarda en dependencies |
pnpm add -D sax | Se guarda en devDependencies |
pnpm add -O sax | Se guarda en optionalDependencies |
pnpm add -g sax | Instalar el paquete globalmente |
pnpm add sax@next | Se instala desde el tag next |
pnpm add sax@3.0.0 | Especificar versión 3.0.0 |
Ubicaciones de paquetes soportados
Instalar desde el registro de npm
El comando pnpm add package-name
instalará la versión más reciente del paquete package-name
desde el registro de npm por defecto.
Si se ejecuta en el workspace, el comando primero intentara verificar si otros proyectos en el workspace usan el paquete especificado. Si es así, se instalará el rango de versión ya previamente instalado.
También puede instalar paquetes con:
- etiqueta:
pnpm add express@nightly
- versión:
pnpm add express@1.0.0
- rango de versiones:
pnpm add express@2 react@">=0.1.0 <0.2.0"
Instalar desde el espacio de trabajo
Tenga en cuenta que al añadir dependencias y trabajar dentro de un espacio de trabajo, los paquetes se instalarán desde las fuentes configuradas, dependiendo de si link-workspace-packages
está configurado, y el uso de la opción workspace: range protocol
.
Instalar desde el sistema de archivos local
Hay dos formas de instalar desde el sistema de archivos local:
- desde un archivo tarball (
.tar
,.tar.gz
o.tgz
) - de un directorio
Ejemplos:
pnpm add ./package.tar.gz
pnpm add ./some-directory
Cuando se instala desde un directorio, se creará un enlace simbólico en el node_modules
del proyecto, por lo que es lo mismo que ejecutar pnpm link
.
Instalar desde tarball remoto
El argumento debe ser un URL obtenible que empiece por "http://" o "https://".
Ejemplo:
pnpm add https://github.com/indexzero/forever/tarball/v0.5.6
Instalar desde el registro de npm
pnpm add <git remote url>
Instala el paquete desde el proveedor de Git alojado, clonándolo con Git. Puede utilizar un protocolo para determinados proveedores Git. Por ejemplo, pnpm add github:user/repo
Puede instalar desde Git mediante:
- último commit del master:
pnpm add kevva/is-positive
- commit:
pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
- branch:
pnpm add kevva/is-positive#master
- rango de versiones:
pnpm add kevva/is-positive#semver:^2.0.0
You may also install just a subdirectory from a Git-hosted monorepo. Por ejemplo:
pnpm add myorg/repo#path:packages/foo
It is possible to combine multiple parameters by separating them with &
. For instance, you can extend the above command by specifying which branch to fetch from:
pnpm add myorg/repo#path:packages/foo&next
Opciones
--save-prod, -P
Instala los paquetes especificados como una dependencia común: dependencies
.
--save-dev, -D
Instala los paquetes especificados como devDependencies
.
--save-optional, -O
Instala los paquetes especificados como optionalDependencies
.
--save-exact, -E
Las dependencias guardadas se configurarán con una versión exacta en lugar de utilizar el operador de rango semver por defecto de pnpm.
--save-peer
El uso de --save-peer
agregará uno o más paquetes a peerDependencies
y los instalará como dependencias de desarrollo.
--ignore-workspace-root-check
Se produce un error al agregar una nueva dependencia al paquete del espacio de trabajo raíz, a menos que se utilice el parámetro --ignore-workspace-root-check
o -w
.
Por ejemplo, pnpm add debug -w
.
--global, -g
Instala un paquete globalmente.
--workspace
Solo añade la nueva dependencia si se encuentra en el espacio de trabajo.