Instal·lació de MADS V5

Per desenvolupar amb MADS V5 necessites quatre peces: l'eina de línia d'ordres mads, un JDK, Maven i, per treballar còmodament, l'extensió de VS Code.

Ja tenies mads instal·lat clonant el repositori amb Git? Elimina primer aquesta instal·lació (l'enllaç /usr/local/bin/mads o l'entrada de la seva carpeta bin al PATH) perquè no tingui prioritat sobre la nova.

1. Eina mads

macOS i Linux (Homebrew)

Amb Homebrew instal·lat:

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

Les versions recents de Homebrew només carreguen fórmules de repositoris de tercers si hi confies; això és el que fa brew trust. Homebrew instal·la també el Java que necessita mads.

Windows (Scoop)

Des d'una PowerShell normal (no com a administrador), instal·la Scoop si no el tens:

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

I després instal·la 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 necessita Git per afegir repositoris (buckets). Si ja tens un JDK 8 o superior, pots saltar-te les dues línies de Java.

2. Maven

Les ordres de mòdul (mads module build, test, deploy…) executen Maven, que mads localitza amb la variable M2_HOME o amb la preferència M2_HOME de mads --edit.

Per exemple, a macOS afegeix aquesta línia a ~/.zshrc:

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

3. Extensió de VS Code

Instal·la MADS V5 per a Visual Studio Code des del Marketplace, o des de la paleta d'ordres de VS Code:

ext install sivicom.mads-extension

L'extensió afegeix la vista Mads a l'Explorador i les ordres Mads: … a la paleta. Continua a Desenvolupament a VS Code.

4. Comprovar la instal·lació

mads --version

Mostra la versió de la plataforma, la de l'eina, l'última publicada i el tipus d'instal·lació. Si alguna cosa falla, mads -v --version hi afegeix les versions de Java instal·lades i les variables d'entorn.

Actualitzar

mads comprova si hi ha versions noves com a màxim cada 12 hores i, si n'hi ha, t'indica l'ordre:

Per desactivar la comprovació, per exemple en servidors d'integració contínua, defineix MADS_NO_UPDATE_CHECK=1.

Triar la versió de Java

mads fa servir el primer Java que troba en aquest ordre: JAVA_HOME_MADS, el java del PATH i JAVA_HOME. Per fixar un JDK concret, defineix JAVA_HOME_MADS:

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