Scribd
Cargar
51 vistas5 páginas

Angular y NPM

Este documento describe Angular, NPM y cómo crear y publicar paquetes. Explica que Angular depende de paquetes NPM y que NPM es un administrador de paquetes de JavaScript que incluye una CLI, un registro de paquetes y una página web. También describe cómo crear un archivo package.json, los comandos NPM básicos como install, publish y cache, y el proceso general de publicación de paquetes en un registro.

Cargado por

RAQUEL GONZALEZ RODRIGUEZ
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como RTF, PDF, TXT o lee en línea desde Scribd
51 vistas5 páginas

Angular y NPM

Este documento describe Angular, NPM y cómo crear y publicar paquetes. Explica que Angular depende de paquetes NPM y que NPM es un administrador de paquetes de JavaScript que incluye una CLI, un registro de paquetes y una página web. También describe cómo crear un archivo package.json, los comandos NPM básicos como install, publish y cache, y el proceso general de publicación de paquetes en un registro.

Cargado por

RAQUEL GONZALEZ RODRIGUEZ
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como RTF, PDF, TXT o lee en línea desde Scribd
Está en la página 1/ 5

ANGULAR AND NPM

Para disponer de Angular en el sistema, es necesario:


-Una versión TLS activa o con mantenimiento de Node.js (para ver los requerimientos específicos de una
versión concreta, revisar la key del fichero package.json)
Para saber qué versión de node hay en el sistema, node -v

-Angular, las apps de Angular y la Angular CLI dependen de paquetes npm para muchas de sus
características y funciones. Para descargar e instalar paquetes npm necesitas un npm package manager.

NPM

Es el mayor registry de software. Se usa para compartir paquetes. Es un administrador de paquetes de


JavaScript. Se compone de 3 elementos:

-La website. Para descubrir paquetes, set up perfiles, y administrar la experiencia con npm (ej. set up
organizaciones para administrar el acceso publico o privado a paquetes)

-La CLI, se ejecuta desde una terminal, sirve para interactuar con npm

-El registry. El registry público de npm es una base de datos enorme de paquetes de Javascript,
compuesto de software y metadatos. Gran parte de estos paquetes son módulos de node, o contienen
modulos de node.

Usamos NPM para adaptar paquetes de código para tus aplicaciones, descargar herramientas, ejecutar
paquetes sin descargarlos usando npx, administrar diversas versiones de código y depedencias...

¿Qué es un paquete?

Un paquete es un archivo o un directorio que está descrito por un archivo package.json. Un paquete
DEBE contener un archivo package.json para ser publicado en el registry de npm.
Osea, un programa descrito por un archivo package.json.

Los paquetes pueden almacenarse como un archivo o directorio, o como un zip, archivo comprimido de
una carpeta que contiene un programa descrito por un archivo package.json

A este paquete se puede acceder a través de una url si está publicado en un registry, un nombre@tag
que apunta a un paquete pubicado en el registry...

Tarball (tape archive) es un archivo .tar que se usa para consolidar archios y carpetas en uno, es una
extensión, un tipo de archivo, un formato que puede combinar varios archivos en uno único llamado
tarball

NPM viene preconfigurado para usar el registry público de npm, pero puedes configurarlo para usar
cualquier registry que quieras.

Usamos npm install para instalar las dependnecias de un programa.

PRÁCTICA NPM

La CLI de npm tiene muchas versiones, hay que ver cuál se ajusta más a nuestras necesidades. Para
instalar npm, la versión estable más reciente usamos:

npm install npm@latest -g

Para publicar e instalar paquetes en y desde un registry npm público o privado, se debe instalar Node.js y
la CLI de npm. Recomendable usar una node version manager (como nvm) para instalar Node.js y npm

Revisar versiones de npm y node.js


node -v
npm -v

CREAR UN ARCHIVO PACKAGE.JSON

Se puede añadir un archivo package.json a un paquete para facilitar la instalación y manejo del mismo,
pero para publicarlo en el registry es OBLIGATORIO que disponga de este archivo. En este archivo se
recoge: un listado de los paquetes de los que depende el proyecto (las dependencias del proyecto), la
versión del paquete que usa el proyecto usando las reglas de versionado semántico, y permite hacer tu
build reproducible y fácil de compartir

Recomendaciones en versionado semántico para paquetes: https://docs.npmjs.com/about-semantic-


versioning (sigue siendo Major.Minor.Parche, pero empieza por 1.0.0)

Para crear un archivo package.json, se usa el comando siguiente en el path del codigo del paquete:
npm init

Nos lanzarán una serie de preguntas para ir rellenando la info del archivo. Si queremos que se rellene
con info por defecto, genérica, usamos:

npm init --yes


CAMPOS DEL FICHERO PACKAGE.JSON

Es obligatorio que contenga dos campos:


"name" Especifica el nombre del paquete, debe estar en minúsculas y sólo ser una palabra, puede
llevar - y _

"version" Debe seguir el formato x.x.x y el versionado semántico

Además, se pueden especificar otros campos tales como:

"author" , "description" info sobre el paquete, un string, README info, "scripts" Que se deseen ejecutar,
"keywords""license", "bugs", "homepage" ...

ARCHIVO NPMRC

Npm obtiene su configuración de la CLI, las variables de entorno y los archivos NPMRC. Se puede usar el
comando npm config para actualizar/editar el contenido de los archivos npmrc

Todos los archivos de configuración npm están en formato key = value. Las variables de entorno se
pueden sobreescribir usando ${NOMBRE_VARIABLE}

Existen 4 archivos NPMRC relevantes:

-El archvo de configuración por proyecto /path/al/proyecto/.npmrc


-El archivo de configuración de usaurio ~/.npmrc
-El archivo de configuración global $PREFIJO/etc/npmrc
-El archivo de configuración npm builtin /path/al/proyecto/.npmrc

Cada uno de etsos archivos se carga y su configuración es resuelta siguiendo una precedencia de más
específico a menos, es decir, un setting del userconfig sobreescribirá un setting la configuración global

CACHÉ
Los archivos de caché se almacenan en ~/.npm o %AppData%/npm-cache
https://docs.npmjs.com/cli/v8/commands/npm-cache

Usamos el comando npm cache para añadir, listar o limpiar la carpeta de caché de npm.
Con add añadimos paquetes específicos al caché local.
Con clean eliminamos toda la info dentro de la carpeta de caché.
Con verify verificamos el contenido de la carpeta de caché, y la integridad de la misma.

COMANDOS

npm install paquete@tag

https://docs.npmjs.com/cli/v8/commands/npm-install#synopsis

npm cache add archivo

npm cache add url


npm cache clean
npm cache verify
https://docs.npmjs.com/cli/v8/commands/npm-cache

npm pack

Para cualquier cosa que sea instalable (una carpeta de paquete, un tarball.. este comando lo buscará en
el caché, copiará el tarball al directorio de trabajo actual como <nombre>-<version>.tgz y escribirá el
nombre del archivo/s al stdout (salida estándar, la vía por la que el programa devuelve los datos tras
ejecutarse)

Si no se especifican argumentos, npm empaqueta la carpeta actual

npm publish <carpeta>


Publica un paquete al registry.
<carpeta> Se refiere a una carpeta que contiene un archivo package.json

npm publish --tag nombretag


Regista el paquete con el tag especificado. Si no se especifica, publica con el tag latest.

--dry-run Hace todo lo que haría el publish pero no publica el paquete, informa sobre qué habría sido
publicado.

El publish fallará si la combinación nombre:versión ya existe en el registry durante la publicación.

También podría gustarte