A noter : Cet article s’applique aussi à sous Snow Leopard (Mac OS 10.6)

Trop simple

En fait pour installer Apache Maven sur Leopard, il y a tout simplement rien à faire par défaut .

En effet ce dernier est inclu dans les outils fournis de base avec l’OS.

arnaud@ahe:~$ mvn -version
Maven version: 2.0.6
arnaud@ahe:~$ which mvn
/usr/bin/mvn


Et voilà !!!

D’accord, cet article c’est du vol.

Allons un peu plus loin alors …

Remplacer la version de Maven embarquée

La version 2.0.6, c’est bien, merci Apple, mais elle commence à dater. Alors comment fait-on pour installer et utiliser une version plus récente.

Il suffit de télécharger la version et la placer dans /usr/share (C’est là qu’Apple a placé sa version 2.0.6 dans le sous-répertoire maven).
Pour placer un répertoire dans cet espace système il faut être administrateur. Le plus simple est donc de décompresser la version de Maven et de la déplacer depuis un terminal shell avec la commande :
arnaud@ahe:~$ sudo mv apache-maven-2.0.10 /usr/share
Pour terminer il faut recréer le lien symbolique qui se trouve dans /usr/bin/.
arnaud@ahe:~$ sudo ln -fhsv /usr/share/apache-maven-2.0.10/bin/mvn /usr/bin/mvn

Est ce plus intéressant ?

Allons jusqu’au bout et ajoutons maintenant la possibilité de passer d’une version de maven à une autre. Pour moi, en tant que développeur Maven, c’est très utile pour faire des tests de compatibilité pour les plugins. Pour vous, cela a son intérêt pendant les périodes d’upgrade afin de facilement tester une nouvelle version de maven sur un projet (et la sortie de la version 2.0.10 est toute proche ).

Pouvoir passer d’une version de Maven à une autre

Nous allons reprendre le principe d’un script shell déjà utilisé pour changer la version de Java. Nous téléchargeons les différentes versions de Maven que nous souhaitons utiliser dans ~/Applications (contrairement à /usr/share/ ce répertoire ne sera pas impacté lors d’une mise à jour de l’OS). Nous créons un script setMaven.sh (cf. ci-dessous) que vous placez dans un répertoire qui se trouve dans votre PATH (personnellement ~/Scripts)
#!/bin/sh
MVN_VERSIONS_DIRECTORY="~/Applications/"
MVN_DIRECTORY_TEMPLATE="apache-maven-"
cd ${MVN_VERSIONS_DIRECTORY}
echo "Current `mvn -v`"
if [ "$1" == "" ]; then
versions=`ls -1 ${MVN_VERSIONS_DIRECTORY} | grep 'maven-[2-9].[0-9]' | sed 's/^.*maven-//g'`
echo "Available Versions:" $versions
exit
fi
VERFOUND=`ls | grep $1 | head -n 1`
if [ "$VERFOUND" != "${MVN_DIRECTORY_TEMPLATE}$1" ]; then
BASE="`basename $0`"
echo Error: Could not change Maven -- version $1 not installed!
echo Run $BASE without arguments to see a list of installed versions.
exit 127
fi
# If we get here the user asked for a valid version, so configure it
echo You must now enter your Mac OS X password to change the Maven.
sudo ln -fhsv ${MVN_VERSIONS_DIRECTORY}${MVN_DIRECTORY_TEMPLATE}$1/bin/mvn /usr/bin/mvn
echo "New `mvn -v`"
# To activate if you have growl and growlnotify script installed
#growlnotify -n Maven -m "Maven now in $1"


Sans paramètre l’appel au script vous liste les différentes versions disponibles et la version actuellement configurée.

arnaud@ahe:~$ setMaven.sh
Current Maven version: 2.0.1
Available Versions: 2.0 2.0.1 2.0.10 2.0.2 2.0.3 2.0.4 2.0.5 2.0.6 2.0.7 2.0.8 2.0.9 2.1.0-M1 3.0-alpha-2


Pour modifier la version vous la passez en paramètre du script.

arnaud@ahe:~$ setMaven.sh 2.0.10
Current Maven version: 2.0.1
You must now enter your Mac OS X password to change Maven.
/usr/bin/mvn -> /home/arnaud/Applications/apache-maven-2.0.10/bin/mvn
New Maven version: 2.0.10
Java version: 1.5.0_16
OS name: "mac os x" version: "10.5.6" arch: "i386" Family: "unix"


Mission réussie ! A noter que ce script, comme pour la version Java, est persistant.

Pour qu’Eclipse utilise tout le temps la version 1.5 de Java quelque soit celle configurée sur votre système, il faut le définir dans le fichier eclipse.ini.
Si ECLIPSE_HOME est le répertoire où vous avez extrait votre installation d’Eclipse, le fichier eclipse.ini se trouve dans ECLIPSE_HOME/Eclipse.app/Contents/MacOS/eclipse.ini. Pour y accéder depuis le Finder, faites un “clic-droit” sur l’icône de l’application Eclipse qui se trouve à la racine de ECLIPSE_HOME, et choisissez “Show Package Contents”.

Le contenu de ce fichier doit ressembler à ceci :

[sourcecode language='java']

-showsplash
org.eclipse.platform
-startup
../../../plugins/org.eclipse.equinox.launcher_1.0.101.R34x_v20080819.jar
–launcher.library
../../../plugins/org.eclipse.equinox.launcher.carbon.macosx_1.0.101.R34x_v20080731
-vmargs
-Xdock:icon=../Resources/Eclipse.icns
-XstartOnFirstThread
-Xms40m
-Xmx512m
-XX:MaxPermSize=256m
-Dosgi.requiredJavaVersion=1.5
-Dorg.eclipse.swt.internal.carbon.smallFonts
[/sourcecode]

Juste avant la ligne -vmargs vous allez y rajouter les deux lignes suivantes pour forcer eclipse à utiliser la version 1.5 :
[sourcecode language='java']
-vm
/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Commands/java
[/sourcecode]

Votre fichier eclipse.ini doit alors ressembler à ceci :

[sourcecode language='java']

-showsplash
org.eclipse.platform
-startup
../../../plugins/org.eclipse.equinox.launcher_1.0.101.R34x_v20080819.jar
–launcher.library
../../../plugins/org.eclipse.equinox.launcher.carbon.macosx_1.0.101.R34x_v20080731
-vm
/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Commands/java
-vmargs
-Xdock:icon=../Resources/Eclipse.icns
-XstartOnFirstThread
-Xms40m
-Xmx512m
-XX:MaxPermSize=256m
-Dosgi.requiredJavaVersion=1.5
-Dorg.eclipse.swt.internal.carbon.smallFonts
[/sourcecode]

Désormais vous pouvez démarrer eclipse, quelque soit la version de Java activée sur votre machine.

Lien :

• http://www.jedi.be/blog/2008/10/10/new-project-new-eclipse-34-installation-on-mac-osx-leopard/

Comme beaucoup de développeurs Java pour m’assurer que mon code est bien compatible au niveau des APIs avec la cible recherchée (1.4, 1.5, 1.6, …) je dois utiliser la version de Java en question pour construire et tester mon projet (Par exemple Maven 2.0.x et ses plugins doivent toujours êtres compatibles avec Java 1.4).

Apple fournit les différentes versions de Java dont vous avez besoin. Dans mon cas j’ai récupéré la totale c’est à dire Java SE 6 (1.6.0_07), J2SE 5.0 (1.5.0_16), et J2SE 1.4.2 (1.4.2_18).

Maintenant comment passer d’une version à l’autre ? Il existe pour cela plusieurs solutions.

La solution ergonomique version Apple
Dans Applications/Utilities/Java vous utilisez les Java preferences et vous modifiez l’ordre des versions de Java disponibles pour les applications afin de mettre en premier la version souhaitée. La modification se fait instantanément (sans rechargement du shell) pour toute votre machine.

Passage en Java 1.6

Configuration Java en 1.6

Console :
[sourcecode language='java']arnaud@ahe:~$ java -version
java version “1.6.0_07″
Java(TM) SE Runtime Environment (build 1.6.0_07-b06-153)
Java HotSpot(TM) 64-Bit Server VM (build 1.6.0_07-b06-57, mixed mode)[/sourcecode]
Passage en Java 1.5

Configuration Java en 1.5

Console :
[sourcecode language='java']arnaud@ahe:~$ java -version
java version “1.5.0_16″
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_16-b06-284)
Java HotSpot(TM) 64-Bit Server VM (build 1.5.0_16-133, mixed mode)[/sourcecode]
Passage en Java 1.4

Configuration Java en 1.4

Console :
[sourcecode language='java']arnaud@ahe:~$ java -version
java version “1.4.2_18″
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_18-b08-314)
Java HotSpot(TM) Client VM (build 1.4.2-90, mixed mode)[/sourcecode]
La version ligne de commande pour le geek

Lorsque l’on est geek et que l’on passe sa journée dans sa console shell, il faut avouer que l’on aime pas trop en sortir. La solution pour faire la même opération en ligne de commande consiste à utiliser un script setJDK.sh (cf. ci-dessous) que vous placez dans un répertoire qui se trouve dans votre PATH (personnellement ~/Scripts)
[sourcecode language='java']#!/bin/sh
cd /System/Library/Frameworks/JavaVM.framework/Versions

CURJDK=”`readlink CurrentJDK`”
echo Current JDK version: $CURJDK

if [ "$1" == "" ]; then
echo Installed versions:
ls
exit
fi

VERFOUND=`ls | grep $1 | head -n 1`

if [ "$VERFOUND" != "$1" ]; then
BASE=”`basename $0`”
echo Error: Could not change JDK– version $1 not installed!
echo Run $BASE without arguments to see a list of installed versions.
exit 127
fi

echo You must now enter your Mac OS X password to change the JDK.
sudo ln -fhsv $1 CurrentJDK

# To activate if you have growl and growlnotify script installed
#growlnotify -n Java -m “Java now in $1″[/sourcecode]
Ensuite vous devez modifier votre PATH (et en même temps ajouter le JAVA_HOME) afin de passer avant les versions du système :
Dans ~/.bash_login ou ~/.profile .
[sourcecode language='java']# JAVA
export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home
export PATH=$JAVA_HOME/bin:$PATH[/sourcecode]
Attention de bien placer le $PATH après le $JAVA_HOME/bin !!!

Sans paramètre l’appel au script vous liste les différentes versions disponibles et la version actuellement configurée.
[sourcecode language='java']arnaud@ahe:~$ setJDK.sh
Current JDK version: 1.5
Installed versions:
1.3 1.4 1.4.2 1.5.0 1.6.0 Current
1.3.1 1.4.1 1.5 1.6 A CurrentJDK[/sourcecode]
Pour modifier la version vous la passez en paramètre du script.
[sourcecode language='java']arnaud@ahe:~$ setJDK.sh 1.4
Current JDK version: 1.5
You must now enter your Mac OS X password to change the JDK.
Password:
CurrentJDK -> 1.4
arnaud@ahe:~$ java -version
java version “1.4.2_18″
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_18-b08-314)
Java HotSpot(TM) Client VM (build 1.4.2-90, mixed mode)[/sourcecode]

Et voilà !

A noter que ces deux solutions sont incompatibles. Il faut donc faire votre choix. Pour la deuxième solution vous modifiez votre PATH et les binaires Java ne sont donc plus chargés depuis /usr/bin qui est nécessaire à la première solution.

Mes sources :

• http://developer.apple.com/java/
• http://developer.apple.com/java/javaleopard.html
• http://nagpals.com/blog/post.cfm/setting-current-jdk-programmatically-on-mac