Guía para Compilar y Publicar la Librería landing-lib

Introducción

Este documento detalla el proceso para compilar y publicar la librería interna landing-lib de manera eficiente y organizada. Sigue estos pasos para garantizar que el paquete cumpla con los estándares de la empresa.

1. Compilar la Librería

Paso 1: Verificar la Configuración

Antes de comenzar, asegúrate de que el archivo package.json de tu librería tenga el formato correcto en el campo name:

{
  "name": "@doolehealth/landing-lib",
  "version": "x.x.x", // Asegúrate de usar el formato correcto de versionado semántico
  ...
}

Paso 2: Ejecutar el Comando de Build

Para compilar la librería, utiliza el comando:

ng build landing-lib

Esto generará un directorio dist/landing-lib donde se encontrará la versión compilada de la librería.

2. Publicar la Librería en NPM

Paso 1: Verificar el Package Ready para Publicar

1. Ve al directorio generado al compilar la librería:

cd dist/landing-lib

2. Asegúrate de que el archivo package.json tenga el nombre correcto, siguiendo el formato:

{
  "name": "@doolehealth/landing-lib",
  "version": "x.x.x",
  "main": "index.js",
  ...
}

Paso 2: Autenticarse en NPM

Si no estás autenticado en tu cuenta de NPM, ejecuta:

npm login

Esto te pedirá:

• Tu usuario de NPM.
• Contraseña.
• Correo electrónico asociado.

Paso 3: Publicar en NPM

Desde el directorio dist/landing-lib, ejecuta:

npm publish

Nota: Asegúrate de que la versión de la librería no sea repetida. Si intentas publicar con una versión existente, NPM rechazará la publicación.

Si es necesario, actualiza la versión en el package.json antes de publicar. Por ejemplo, incrementa la versión en el formato semántico (major.minor.patch):

"version": "1.0.1"

Paso 4: Confirmar la Publicación

Una vez publicada, puedes verificar que la librería esté disponible ejecutando:

npm view @doolehealth/landing-lib

Esto mostrará información de la versión publicada y otros detalles.

3. Notas Importantes

1. Verificar Dependencias: Antes de compilar y publicar, asegúrate de que todas las dependencias necesarias estén correctamente instaladas.
2. Evitar Versiones Duplicadas: Cada nueva versión publicada debe tener un número único. Utiliza versionado semántico para mantener el control.
3. Publicación Interna: Este proceso es para publicar librerías internas de la empresa y no deben ser accesibles al público general.

Resumen de Comandos

1. Compilar la librería:

ng build landing-lib

2. Acceder al directorio compilado:

cd dist/landing-lib

3. Publicar en NPM:

npm publish

ATENCIÓN:

• La configuración del name en el package.json debe seguir el formato @doolehealth/nombrelibreria.
• El icono ubicado en /assets/icons/logo-app.svg de la app que consuma esta libreria sera el que aparezca en el login.