Publicar un paquete en NPM
Clase 16 de 18 • Curso de Gestión de Dependencias y Paquetes con NPM
Resumen
Antes de publicar un paquete en NPM debes asegurarte de cumplir con los siguientes requisitos:
- Asegurar que el programa funcione reduciendo en lo posible los bugs
- Revisar que la configuración del archivo package.json sea correcta
- Tener un nombre único para el proyecto, usando guiones (-) para separar palabras y evitando números
- Crear una cuenta en NPM, ya que aquí estarán tus paquetes a tu nombre. Después, debes utilizar el comando
npm adduser
para iniciar sesión en la terminal. Si no aparece tu contraseña, no te preocupes, es una forma de seguridad
Una vez hayas cumplido los requisitos, ejecuta el comando npm publish
y si no existen errores, tu paquete será publicado. Puedes utilizar el comando npm whoami
para visualizar el usuario en el que publicarás el paquete, esto es importante si tienes varias cuentas de NPM.
Si realizas cambios en tu código, deberás cambiar la versión de tu proyecto, puedes utilizar los siguientes comandos:
##Aumenta una version path (1.0.0) -> (1.0.1)
$ npm version patch
##Aumenta una version minor (1.0.0) -> (1.1.0)
$ npm version minor
##Aumenta una version major (1.0.0) -> (2.0.0)
$ npm version major
##Aumenta una version específica (1.0.0) -> (3.1.1)
$ npm version <version>
Una vez actualizada la versión de tu proyecto, puedes ejecutar nuevamente el comando npm publish
para actualizarlo en los repositorios de NPM.
Publicando el proyecto de mensajes aleatorios
Antes de publicar el proyecto de mensajes aleatorios, debemos asegurarnos de que el programa se ejecute bien en la terminal. Para esto, identifica el directorio en el que te encuentras, debe ser el mismo del proyecto con el comando pwd
.
También debes ejecutar el comando sudo npm link
que te permitirá hacer una referencia al paquete hacia el directorio global de NPM, similar a cómo se instalaría desde los servidores de NPM.
Otra forma es instalarlo de manera global, como cualquier otra dependencia, pero en lugar del nombre de la dependencia, estará la ruta del proyecto:
$ sudo npm install -g /users/tuUsuario/random-messages
De esta manera, ya puedes ejecutar el programa con el comando que creamos en "bin"
, random-msg
y funcionará de forma global en el sistema.
Una vez revisado todo, ya puedes ingresar tu usuario con npm adduser
y publicarlo con npm publish
. En los paquetes de tu usuario de NPM aparecerá algo parecido a esto:
Contribución creada con aportes de: Andrés Guano.