Publicar en npm
Versionar y publicar su biblioteca
Publicar en npm es una lección gratuita de Angular Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Angular Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Angular Academy incluye 4 lecciones en total.
Compartir su biblioteca con el mundo
Una vez compilada conforme al Angular Package Format, una biblioteca se publica en un registro, normalmente npm, para que cualquier proyecto pueda instalarla mediante npm install. En esta lección se explican el versionado y el flujo de publicación.
Publique el resultado de dist, no el código fuente
Debe publicar el paquete compilado en dist/<lib>, que contiene el package.json generado y los bundles compilados, nunca el proyecto con el código fuente sin compilar. La compilación es lo que hace que el paquete sea consumible.
ng build ui-kit --configuration production
cd dist/ui-kitVersionado semántico
Los paquetes de npm utilizan semver: MAJOR.MINOR.PATCH. Incremente PATCH para correcciones, MINOR para funcionalidades compatibles con versiones anteriores y MAJOR para cambios incompatibles. Los consumidores dependen de esto para actualizarse de forma segura.
0.0.1 -> 0.1.0 # new feature, no breaks (minor)
0.1.0 -> 0.1.1 # bug fix (patch)
0.1.1 -> 1.0.0 # breaking change (major)Establecer la versión
La versión procede del package.json propio de la biblioteca. Actualícela antes de compilar o use npm version para incrementarla de forma coherente.
# inside projects/ui-kit (or use the field directly)
npm version minor # bumps and tags the versionIniciar sesión en npm
Autentíquese en el registro antes de publicar. npm login almacena un token para autorizar el comando de publicación.
npm login
# enter username, password / token, emailPublicar
Desde la carpeta del paquete compilado, ejecute npm publish. npm sube el paquete y permite instalarlo mediante su nombre y versión.
cd dist/ui-kit
npm publishPaquetes con scope
Los paquetes de una organización utilizan un scope como @myorg/ui-kit. En npm, los paquetes con scope son privados de forma predeterminada; pase --access public para publicarlos públicamente.
npm publish --access publicInstalar la biblioteca publicada
Los consumidores la añaden como cualquier otra dependencia y realizan la importación desde su API pública. Angular encuentra el bundle FESM y los tipos mediante el package.json generado.
npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';Prelanzamientos y tags
Publique las compilaciones inestables con un dist-tag como next para que no se conviertan en la versión predeterminada latest. Los consumidores deben indicar explícitamente que desean utilizarlas.
npm publish --tag next
npm install ui-kit@nextRegistros privados
Para bibliotecas de uso interno, publique en un registro privado (paquetes privados de npm, GitHub Packages o Verdaccio) configurando .npmrc. El flujo de publicación es el mismo; solo cambian la URL del registro y la autenticación.
Automatizar en CI
Los equipos maduros publican desde CI en una versión etiquetada: el pipeline compila la biblioteca, ejecuta las pruebas y ejecuta npm publish con un token almacenado. Esto evita errores manuales y mantiene las versiones vinculadas a los commits.
Comprobación rápida
¿Qué se publica en npm?
Recapitulación
Publique el resultado compilado de dist/<lib>, versionado con semver. Incremente la versión, ejecute npm login y después npm publish (añada --access public para paquetes con scope y --tag next para prelanzamientos). Los consumidores ejecutan npm install e importan desde la API pública. Automatice la publicación en CI para garantizar la fiabilidad.
Preguntas frecuentes
¿La lección «Publicar en npm» es gratis?
Sí — el texto completo de «Publicar en npm» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Angular Academy, actualiza a CoddyKit PRO. El curso de Angular Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Publicar en npm»?
Versionar y publicar su biblioteca Practicas Angular Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Angular Academy?
No se requiere experiencia previa. Angular Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Publicar en npm»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Angular Academy?
Sí. Cada lección de Angular Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Crear una biblioteca con ng generate
- API pública y entry points
- Crear builds con ng-packagr
- Publicar en npm