Installation de Java

Ancestris est compatible avec les versionsJava 8 (aussi appelé 1.8), et Java 11.

Si Ancestris ne démarre pas, ou affiche l'écran de démarrage d'Ancestris et puis s'arrête, c'est généralement lié à un problème avec l'installation de Java. Soit Java n'est pas installé, soit Ancestris ne le trouve pas ou trouve une version incompatible ou trouve une version détériorée.

Les sections suivantes proposent une méthode étape par étape pour s'assurer qu'Ancestris utilise une version Java 8 valide.

Savoir quelle est la version par défaut de Java

Si vous ne savez pas si Java est installé sur votre ordinateur, ou bien quelle version est installée, veuillez visiter la page officielle d'explication détaillée ou sinon ouvrez un terminal et tapez la commande ci-dessous.

java -version

Il y a deux méthodes alternatives sur MacOS et Windows.
- pour MacOS, consultez les instructions pas à pas.
- pour Window, consultez les instructions pas à pas.

Si vous voyez un message d'erreur dans le terminal, c'est que Java n'est pas installé sur votre système. Ancestris ne peut pas foctionner dans ce cas. Veuillez suivre la section Installer ci-dessous pour installer Java 1.8, puis démarrez Ancestris.

Si vous voyez les lignes suivantes, cela signifie que vous avez la bonne version de java et que c'est celle utilisée par défaut.

java version "1.8.0_251"
Java(TM) SE Runtime Environment (build 1.8.0_251-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)

D'après l'affichage ci-dessus, vous pouvez voir que la version installée et positionnée par défaut est la version 1.8, i.e. version 8.

Si Ancestris ne démarre pas, c'est donc soit que Ancestris ne trouve pas Java ou alors trouve une version incompatible ou trouve une version détériorée. veuillez suivre les instruction d'identification de la version trouvée par Ancestris pour résoudre le problème.

Si vous voyez une version Java différente de 1.8 ou 11, cela signifie que vous avez une autre version Java définie par défaut.

java version "10.0.1" 2018-04-17
Java(TM) SE Runtime Environment 18.3 (build 10.0.1+10)
Java HotSpot(TM) 64-Bit Server VM 18.3 (build 10.0.1+10, mixed mode)

D'après l'affichage ci-dessus, nous pouvons voir que la version Java installée définie par défaut est la version 10. Ancestris ne fonctionnera pas. Veuillez suivre la section Installer ci-dessous pour installer Java 8.

Une fois cela fait, vous aurez alors plusieurs versions Java installées sur votre système.

Si vous êtes à l'aise pour définir Java 8 comme version par défaut, veuillez suivre les instructions pour définir la version Java par défaut sur votre système, puis démarrez Ancestris.

Si vous préférez conserver la version Java définie sans y toucher, vous devez indiquer à Ancestris de ne pas utiliser la version Java par défaut et d'en utiliser une autre. Veuillez suivre les instructions pour forcer Ancestris à utiliser une version Java spécifique, puis démarrez Ancestris.

IdentifyIdentifier whichla version de Java utilisée par Ancestris

Pour savoir quelle version Java Ancestris ~~finds~~trouve,

Tovous ~~know~~devrez ~~which~~vérifier ~~Java~~le ~~version~~fichier ~~Ancestris finds, you will need to check the Ancestris~~de configuration ~~file~~Ancestris.

1. ~~Check~~Repérez ~~the~~la ~~line~~ligne ~~defining~~qui définit default_options

~~This~~Cette ~~line~~ligne ~~should~~ressemble ~~look~~à ~~like this:~~ceci:

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

If one of the options in this line includes --jdkhome="/path/to/java, make sure the path specified in this option is the path to Java version 1.8. Otherwise, edit the configuration file and change it. Then launch Ancestris.

2. ~~Check~~Repérez ~~the~~la ~~line~~ligne ~~defining~~qui définit jdkhome

If the line looks like jdkhome="/path/to/java", then make sure the path specified in this option is the path to Java version 8. Otherwise, edit the configuration file and change it. Then lanch Ancestris.

If the line starts with "#", or if the line does not exist, then it means the line is not used by Ancestris and that Ancestris uses the default Java version set on your system.

If the default version checked above was Java 8, it means your installed Java 8 version might be corrupted. Try reinstalling it using the Install instructions and restart Ancestris.

Install Java

To install version Java 8 on your system, you can get it from the Oracle's main page, or more precisely, directly from the download page.

If you need to know if your device can run Java, go to this configuration page to learn the minimum needed configuration.

If you want to choose from all the available Oracle Java versions, check this available versions page.
- Java Version 8 is recommended as it supports all Ancestris features.
  - For full details on how to install version 8
    - For MacOS, see JRE 8 Installation for MacOS.
    - For Windows, see JRE Installation for Windows.
    - For Linux, see JRE Installation for Linux.

- Java Version 11 support most Ancestris features.
  - Download and install Java Development Kit (JDK) Version 11
    - For MacOS, choose the .dmg file.
  - For full details on how to install version 11
    - For MacOS, see Installation of the JDK for MacOS.
    - For windows, see Installation of the JDK for Windows.
    - For Linux, see Installation of the JDK on Linux.

If you prefer an Open Source Java version, it is possible to use OpenJDK and you can also install Java from the free AdoptopenJDK solution.

Utiliser plusieurs versions de Java en parallèle

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

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:

#jdkhome="/chemin/vers/jdk"

Utiliser plusieurs versions de Java sur MacOS

Vérifiez quelle version de java est utilisée par défaut :

java -version

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

Vérifiez quelles sont les versions de java installées et regardez si la version 1.8 ou 11 est bien installée :

/usr/libexec/java_home -V

OK, on voit que les versions 10 et 1.8 sont les deux versions installées.

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).

Fermez le terminal et relancez-le maintenant pour vérifier que la version utilisée a bien changé

java version

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

Utiliser plusieurs versions de Java 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 fichier 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érifier 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"

Utiliser plusieurs versions de Java 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 à utilliser 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 comme ce qui suit.

jdkhome="/chemin/vers/java"