Instalación de MADS V5

Para desarrollar con MADS V5 necesitas cuatro piezas: la herramienta de línea de comandos mads, un JDK, Maven y, para trabajar cómodamente, la extensión de VS Code.

¿Ya tenías mads instalado clonando el repositorio con Git? Elimina primero esa instalación (el enlace /usr/local/bin/mads o la entrada de su carpeta bin en el PATH) para que no tenga prioridad sobre la nueva.

1. Herramienta mads

macOS y Linux (Homebrew)

Con Homebrew instalado:

brew tap sivicomeng/mads
brew trust --formula sivicomeng/mads/mads
brew install mads
mads --version

Las versiones recientes de Homebrew solo cargan fórmulas de repositorios de terceros si confías en ellas; eso es lo que hace brew trust. Homebrew instala también el Java que necesita mads.

Windows (Scoop)

Desde una PowerShell normal (no como administrador), instala Scoop si no lo tienes:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

Y después instala mads:

scoop install git
scoop bucket add java
scoop install java/temurin-lts-jdk
scoop bucket add mads https://github.com/sivicomeng/homebrew-mads
scoop install mads/mads
mads --version

Scoop necesita Git para añadir repositorios (buckets). Si ya tienes un JDK 8 o superior, puedes saltarte las dos líneas de Java.

2. Maven

Los comandos de módulo (mads module build, test, deploy…) ejecutan Maven, que mads localiza con la variable M2_HOME o con la preferencia M2_HOME de mads --edit.

Por ejemplo, en macOS añade esta línea a ~/.zshrc:

export M2_HOME="$(brew --prefix maven)/libexec"

3. Extensión de VS Code

Instala MADS V5 para Visual Studio Code desde el Marketplace, o desde la paleta de comandos de VS Code:

ext install sivicom.mads-extension

La extensión añade la vista Mads al Explorador y los comandos Mads: … a la paleta. Continúa en Desarrollo en VS Code.

4. Comprobar la instalación

mads --version

Muestra la versión de la plataforma, la de la herramienta, la última publicada y el tipo de instalación. Si algo falla, mads -v --version añade las versiones de Java instaladas y las variables de entorno.

Actualizar

mads comprueba si hay versiones nuevas como mucho cada 12 horas y, si las hay, te indica el comando:

Para desactivar la comprobación, por ejemplo en servidores de integración continua, define MADS_NO_UPDATE_CHECK=1.

Elegir la versión de Java

mads usa el primer Java que encuentra en este orden: JAVA_HOME_MADS, el java del PATH y JAVA_HOME. Para fijar un JDK concreto, define JAVA_HOME_MADS:

export JAVA_HOME_MADS="$(/usr/libexec/java_home -v 21)"