Installation de Java

Plusieursdevrez versionsalors vérifier et éventuellement mettre à jour le fichier de Java

SiPlutôt vousque avezde modifier le fichier de configuration d'Ancestris, et si plusieurs versions de Java etsont quedisponibles sur votre système, une alternative serait de modifier la version de Java par défaut. La version de Java par défaut est celle qui apparaît lorsque vous souhaiteztapez java -version comme indiqué dans la section ci-dessus. C'est celle qu'Ancestris enutilisera utilisesi unele autrefichier quede celleconfiguration par défaut, veuillez suivre les instructions pour forcer d'Ancestris àn'existe utiliserpas uneou versionn'indique Javapas spécifique.où trouver Java.

Identifier la version de Java utilisée par Ancestris

Vous ne devez vous préoccuper de ce qui est détaillé ci-dessous que si Java est installé et qu'Ancestris ne démarre pas.

Pour identifier le problème, vérifiez d'abord si Ancestris trouve la version de Java que vous souhaitez. Pour savoir quelle version Java Ancestris utilise, vous devez vérifier le fichier de configuration Ancestris.

Le principe est le suivant :

• S'il existe un fichier de configuration qui inclut un paramètre jdkhome indiquant où trouver Java, Ancestris utilisera la version de java correspondante.
• Sinon, Ancestris utilisera la version de Java par défaut indiquée dans la section au-dessus.

{{@9#bkmrk-ancestris-utilise-de}}

Donc ouvrez le fichier de configuration avec un éditeur de texte normal.

1. Repérez la ligne qui définit default_options

Cette ligne ressemble à ceci:

default_options="--branding ancestris -J-Xms96m -J-Xmx1g --laf javax.swing.plaf.nimbus.NimbusLookAndFeel"

Si l'une des options dans cette ligne inclut --jdkhome="/chemin/vers/java, assurez-vous que le chemin indiqué dans cette définition est celui de la version java que vous souhaitez utiliser. 

Si elle n'inclut pas l'option en question, recherchez jdkhome ailleurs..

2. Repérez la ligne qui définit jdkhome

Si cette ligne existe, elle doit ressembler à jdkhome="/chemin/vers/java". Assurez-vous , que le chemin indiqué dans cette définition est celui de la version java que vous souhaitez utiliser.

Si la ligne début par "#", signe d'une ligne de commentaire, Ancestris l'ignorera et par conséquent, ne tiendra pas compte du paramètre jdkhome indiqué.

Si Ancestris ne démarre pas, il se peut que le nom du dossier donné par jdkhome soit mal orthographié ou qu'il pointe vers une version incorrecte de Java.

Installation de Java

Pour installer Java sur votre ordinateur, vous pouvez l'obtenir depuis la page principale Java d'Oracle, ou plus précisément:
- Version d'utilisation simple: sur la page de téléchargement du JRE (MacOS, Windows, Linux) 
- Version de développment: sur la page de téléchargement du JDK (MacOS, Windows, Linux)

Une façon simple de récupérer une version de java est aussi possible à partir de Adoptium.net

• Si vous voulez savoir si votre ordinateur est compatible avec Java, visitez la page de configuration.

• Si vous voulez choisir une version parmi toutes les versions Oracle disponibles, visitez la page des versions disponibles.
  • La version 8 de Java est recommandée car elle fonctionne bien avec toutes les fonctionnalités d'Ancestris.
    • Pour plus de détails sur la façon d'installer la version 8
      • Pour MacOS, voir Installation de Java JRE 8 pour MacOS.
      • Pour Windows, voir Installation de Java JRE 8 pour Windows.
      • Pour Linux, voir Installation de Java JRE 8 pour Linux.

• • Les versions long termes suivantes sont compatibles avec la plupart des fonctionnalités d'Ancestris.
    • Téléchargez-la depuis Java Development Kit (JDK) Version 11
      • Pour MacOS, choisissez le fichier .dmg.
    • Pour plus de détails sur la façon d'installer la version 11
      • Pour MacOS, voir Installation du JDK pour MacOS.
      • Pour windows, voir Installation du JDK pour Windows.
      • Pour Linux, voir Installation du JDK pour Linux.

• Si vous préférez une version de Java en Open Source, il est possible d'utiliser OpenJDK et vous pouvez aussi installer Java depuis la solution libre Adoptium.

Définir la version par défaut de Java

La procédure dépend de votre système d'exploitation.

• Sur MacOS
• Sur Windows
• Sur Linux

Quel que soit votre système d'exploitation, vous pouvez identifier quelle version de java est activée par défaut sur votre système en tapant en ligne de commande

java -version

Quel que soit votre système d'exploitation, si la version de java à utiliser pour Ancestris est différente de celle activée par défaut sur votre système, il faut modifier le fichier de configuration d'Ancestris comme suit en dé-commentant la ligne ci-dessous et en spécifiant le chemin vers java.

jdkhome="/chemin/vers/jdk"

Définir la version par défaut sur MacOS

La version de Java définie par défaut sur votre ordinateur peut être incompatible avec Ancestris. Cela ne fonctionnera donc pas.

Si vous souhaitez conserver plusieurs versions de Java en même temps, et définir par défaut la version 8 par exemple, vous devrez alors échanger les versions.

Pour cela, ouvrez un terminal et suivez les instructions ci-dessous.

Dans l'exemple suivant, les instructions permettent de définir la version 8 comme version par défaut tout en gardant la version 10 sur votre ordinateur.

1/6 - Vérifiez quelle version de java est utilisée par défaut

java -version

On voit que la version 10 est celle définie par défaut. Il faut la version 1.8 (i.e. 8) ou 11 pour Ancestris.

2/6 - Vérifiez quelles versions de java sont installées et regardez si la version 1.8 ou 11 est bien parmi elles

/usr/libexec/java_home -V

On voit que les versions 10 et 1.8 sont les deux versions installées.

Si ce n'était pas le cas, il vous faudrait installer la version 8 selon les instructions ci-dessus.

3/6 - Ajoutez les paramètres qui définissent par défaut la version de java 1.8 dans votre profil

echo 'export JAVA_HOME=`/usr/libexec/java_home -v 1.8`' >>~/.bash_profile
echo 'export jdkhome=`/usr/libexec/java_home -v 1.8`' >>~/.bash_profile

La première ligne définit la version de java à utiliser pour les commandes dans la console (JAVA_HOME, en majuscule).

La seconde définit la version de java à utiliser pour Ancestris (jdkhome, en minuscule).

Ici, on définit la version 1.8 pour les deux utilisations (console et Ancestris).

4/6 - Fermez le terminal

Exit

5/6 - Ouvrez de nouveau le terminal et vérifiez que la version utilisée a bien changé

java version

OK, c'est bon. On voit que la version 1.8 est utilisée.

6/6 - Redémarrer Ancestris dans un terminal

Quand Ancestris démarre dans un terminal , vous pouvez voir la barre de titre de la fenêtre qui indique la version de Java utilisée par Ancestris.

Définir la version par défaut sur Windows

Il vous faut créer un fichier BAT par version de Java que vous voulez conserver.

Vous devez créer les fichiers ci-dessous avec votre éditeur préféré et les placer dans un répertoire accessible depuis votre PATH.

JAVA8.BAT

@echo off
echo Setting JAVA_HOME
set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_12
echo setting PATH
set PATH=C:\Program Files\Java\jdk1.8.0_12\bin;%PATH%
echo Display java version
java -version

JAVA10.BAT

@echo off
echo Setting JAVA_HOME
set JAVA_HOME=C:\Program Files\Java\jdk1.10.0_11
echo setting PATH
set PATH=C:\Program Files\Java\jdk1.10.0_11\bin;%PATH%
echo Display java version
java -version

 En écrivant ces fichiers, assurez-vous de spécifier les bons noms de fichiers java pour les lignes JAVA_HOME ci-dessus, selon votre installation de java.

Quand vous voudrez alterner de version Java, il vous suffira de lancer le fichier BAT correspondant : JAVA8 pour la version 1.8, ou JAVA10 pour la version 10. La version de java en vigueur s'affichera dans la console.

Pour vérifier que l'alternance a bien été prise en compte, vérifiez vous-même votre version de java en tapant java -version dans une console ou en vérifiant sur cette page.

Si vous voulez garder votre dernière version de Java et forcer l'utilisation d'une autre version 8 Ancestris, il faudra modifier le fichier de configuration en modifiant la ligne #jdkhome="C:\chemin\vers\jdk"

Définir la version par défaut sur Linux

Tapez la commande suivante en console :

sudo update-alternatives --config java

Sélectionnez dans la liste qui s'affiche la version que vous souhaitez.

Si vous voulez garder votre dernière version de Java et forcer l'utilisation d'une autre version de java pour Ancestris, il faudra modifier le fichier de configuration en modifiant la ligne #jdkhome="/chemin/vers/jdk"

Pour connaître toutes les commandes de cet utilitaire

sudo update-alternatives -l

Forcer Ancestris à utiliser une version Java spécifique

Quel que soit votre système d'exploitation, si la version Java active par défaut est différente de celle à utiliser avec Ancestris, vous devez modifier le fichier de configuration d'Ancestris d'origine comme ce qui suit en dé-commentant la ligne ci-dessous et en spécifiant le chemin vers java.

jdkhome="/chemin/vers/java"

Cas de Windows et Linux

Pour Windows ou Linux par exemple, si l'exécutable java est /usr/java/jdk1.8.0_291-amd64/bin/java, alors vous devez indiquer

jdkhome="/usr/java/jdk1.8.0_291-amd64/"

Note: vous devez exclure /bin/java de la description du chemin.

Cas de MacOS

Pour MacOS, si par exemple Java 18 et Java 17 sont installés sur votre Mac et que vous souhaitez forcer l'utilisation de Java 17 pour Ancestris, la manipulation complète pour forcer la version de Java serait la suivante :

• Editez le fichier de configuration d'Ancestris de l'application
  /Applications/Ancestris.app/Contents/Resources/ancestris/etc/ancestris.conf
• Repérez la ligne #jdkhome="/chemin/vers/java" et supprimer le caractère # du début de ligne pour dé-commenter cette ligne et pour qu'Ancestris en tienne compte.
• Remplacer la par, en supposant que témurin 17 soit la version de java à forcer :

jdkhome="/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"

• Sauvegardez le fichier ancestris.conf ainsi modifié et vérifiez qu'il s'est bien sauvegardé.
• Relancez Ancestris.

Points d'attention quelque soit votre système d'exploitation

Attention 1 : Si le répertoire java n'existe pas, en l'occurrence temurin-17.jdk dans l'exemple précédent, alors Ancestris ne se lancera pas car il ne trouvera pas Java.

Attention 2 : Si la ligne jdkhome est également définie dans le fichier configuration personnalisé d'Ancestris, sa valeur sera prioritaire sur celle du fichier configuration de l'application. Voir la page fichier de configuration d'Ancestris correspondante.