Instalação do JAVA

O Ancestris é compatível com as versões Java 8 a 21.

Se o Ancestris não iniciar, ou mostrar o ecrã inicial e parar, geralmente é um problema com a instalação do Java. Ou o Java não está instalado, o Ancestris não o encontra, encontra uma versão incompatível ou encontra uma versão corrompida.

As secções seguintes mostram uma verificação passo-a-passo para garantir que o Ancestris usa uma versão Java 8 válida.

Princípio geral

• O Ancestris funciona com as versões Java indicadas ao cimo da página.
  • O Ancestris é compilado na versão 8 para maior compatibilidade com o maior número de utilizadores.
  • Foi testado e funciona em versões LTS (Long Term Support).
  • Não testamos as versões Short Term, que se tornam rapidamente obsoletas e não podem ser transferidas após 18 meses, mas os utilizadores disseram-nos que o Ancestris também funciona em versões intermédias.

• Se uma versão funcional de Java estiver disponível no seu sistema, o Ancestris encontrá-la-á sem ter de configurar nada.

• Caso contrário, pode instalar o Java de qualquer fornecedor. Os nossos utilizadores sentem-se mais confortáveis com o Adoptium.

• Para saber se o Java está instalado no seu sistema, siga estas instruções.

• Se o Ancestris não iniciar quando o Java estiver instalado, consulte a secção Resolução de problemas.

• Podem estar instaladas várias versões de Java no seu sistema. Para indicar ao Ancestris qual delas deve ser utilizada, é necessário:

  • actualizar o ficheiro de configuração do Ancestris, seguindo estas instruções.

• • mudar a versão pré-definida do Java, seguindo estas instruções.

Instalação do Java

Uma forma simples de recuperar uma versão do Java, é transferi-la a partir de Adoptium.net

Se não tiver o Java instalado, ou se pretender obter a versão mais recente ou uma versão específica do Java, basta transferi-lo a partir do sítio acima referido.

Saber se o Java está instalado

Se não souber se o Java está instalado ou qual a versão instalada, abra directamente um terminal de linha de comandos e insira:

java -version

• Se vir uma mensagem de erro no terminal, significa que o Java não está instalado no seu sistema. O Ancestris não pode ser executado. Siga a secção Instalar abaixo para instalar o Java e depois inicie o Ancestris.
• Se vir algo como o exemplo seguinte, significa que tem a versão correcta instalada e pré-definida.

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)

De acordo com o exemplo acima, podemos ver que a versão Java instalada e pré-definida é a versão 1.8, também conhecida como versão 8.

Se vir uma versão Java como no exemplo acima e está satisfeito com essa versão, pode ignorar o resto desta página.

Resolução de problemas

Se o Ancestris não iniciar, é porque não encontra o Java ou encontra uma versão incompatível ou corrompida.

Quer esteja instalada apenas uma versão do Java no seu sistema ou várias, terá de verificar e possivelmente actualizar o ficheiro de configuração para indicar ao Ancestris onde encontrar o Java.

Em vez de modificar o ficheiro de configuração da Ancestris, e se estiverem disponíveis várias versões de Java no seu sistema, uma alternativa é modificar a versão predefinida do Java.

• A versão pré-definida do Java é a que aparece quando se escreve 

  java -version

   como indicado na secção acima. Esta é a que a Ancestris utilizará se o ficheiro de configuração não existir ou não indicar onde encontrar o Java.

Em caso de dúvida, inicie o Ancestris manualmente a partir duma janela de terminal e envie-nos o texto que aparece no ecrã.

Independentemente do sistema operativo que estiver a utilizar, abra uma janela de terminal e:

• vá à pasta da aplicação ancestris/bin;
• Inicie o Ancestris manualmente;
• digitando ./ancestris em macOS ou Linux;
• digitando ancestris.exe ou ancestris64.exe em Windows;
• a janela do terminal mostrará o que ele faz;
• envie-nos este ecrã.

Actualizar o ficheiro de configuração do Ancestris

Não precisa de se preocupar com o que está detalhado abaixo a não ser que o Java não esteja instalado ou que o Ancestris não inicie.

Vous devez mettre à jour le fichier de configuration Ancestris pour indiquer à Ancestris où trouver Java si Ancestris ne le trouve pas tout seul.

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.

Ancestris utilise deux fichiers de configuration, tous deux nommés ancestris.conf
1/ Le premier est le fichier de Configuration Application , qui fait partie du répertoire Application et qui est créé lors de l'installation d'Ancestris. 
2/ L'autre est le fichier de Configuration Utilisateur, qui fait partie du répertoire utilisateur, et qui est créé lorsque vous modifiez certaines préférences lors de l'utilisation d'Ancestris.

Le fichier de Configuration Utilisateur est prioritaire sur le fichier de Configuration Application.

Le fichier de configuration à vérifier et à mettre à jour est donc le fichier de Configuration Utilisateur s'il existe, et le fichier de Configuration Application dans le cas contraire.
- Si vous installez Ancestris, vous devrez probablement mettre à jour le fichier de Configuration Application.
- Si vous avez déjà utilisé Ancestris et que vous voulez changer la version de java, vous devrez probablement mettre à jour le fichier de Configuration Utilisateur. 

Cliquez ici pour savoir où trouver le fichier de configuration en fonction de votre système.

Le chemin d'accès à Java dans le fichier de configuration

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.

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 la ligne jdkhome comme ceci:

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 :

• Modifiez le fichier de configuration de l'utilisateur d'Ancestris s'il existe :

  • Le fichier est /Users/<yourname>/Library/Application Support/ancestris/<version ou trunk>/etc/ancestris.conf.

  • Remplacez <votre nom> par le nom que vous utilisez sur votre Mac

  • Remplacez <version ou trunk> par le numéro de version d'Ancestris que vous utilisez : la version stable et officielle actuelle est un numéro : 11 par exemple ; la version quotidienne est appelée 'trunk'.

  • Pour voir le dossier Library dans le Finder, vous devez appuyer sur Command+J. Il est caché par défaut

    Traduit avec DeepL.com (version gratuite)

• Si le fichier de configuration utilisateur n'existe pas, parce que vous n'avez pas encore utilisé Ancestris par exemple, éditez alors 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 :

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

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

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

Identifique a versão Java encontrada

Para saber a versão Java que o Ancestris encontra, terá de verificar o ficheiro de configuração do Ancestris.

1. Verifique a linha que define default_options

Esta linha deve-se parecer com o seguinte:

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

Se uma das opções nesta linha incluir --jdkhome="/caminho/para/o/java, verifique se o caminho especificado nesta opção é o caminho para o Java versão 1.8. Caso contrário, edite o ficheiro de configuração e altere-o. E depois inicie o Ancestris.

Se esta linha não incluir um caminho java, siga as instruções abaixo.

2. Verifique a linha que define jdkhome

Se a linha se parecer com jdkhome="/caminho/para/o/java", verifique se o caminho especificado nesta opção é o caminho para o Java versão 8. Caso contrário, edite o ficheiro de configuração e altere-o. E depois inicie o Ancestris.

Se a linha começar com "#" ou se não existir, significa que a linha não é usada pelo Ancestris e que o Ancestris usa a versão Java pré-definida no seu sistema.

Se a versão pré-definida verificada acima for Java 8, significa que a versão instalada do Java 8 pode estar corrompida. Tente reinstalar utilizando as instruções de instalação e reinicie o Ancestris.

Instalar o Java

Para instalar a versão Java 8 no seu sistema, pode obtê-la na página principal da Oracle ou, mais precisamente, na página de transferências. Se deseja escolher entre todas as versões disponíveis do Oracle Java, verifique esta página de versões disponíveis.

• Se precisa de saber se o seu dispositivo pode executar o Java, vá a esta página de configuração:
  • A versão 8 do Java é a recomendada, porque suporta todos os recursos do Ancestris.
    • Para detalhes completos sobre como instalar a versão 8:
      • instalação do JRE 8 para MacOS;
      • instalação do JRE para Windows;.
      • instalação do JRE para Linux.

• O Java Versão 11 suporta a maioria dos recursos do Ancestris:
  • Transfira e instale o Java Development Kit (JDK) Versão 11:
    • em MacOS, escolha o arquivo .dmg;
  • Para obter detalhes completos sobre como instalar a versão 11
    • instalação do JDK em MacOS;
    • instalação do JDK para Windows;
    • Instalação do JDK em Linux.

Se preferir uma versão Java de código aberto, é possível usar o OpenJDK e também poderá instalar o Java a partir da solução gratuita AdoptopenJDK.

Pré-definir a versão Java

• •  
• Para MacOS
• Para Windows
• Para Linux

Pré-definir a versão para MacOS

A versão do Java em execução no seu sistema pode ser incompatível com o Ancestris, impedindo assim a sua execução. Receberá uma mensagem como a seguinte num terminal quando o Ancestris iniciar.

Se deseja manter a sua versão actual do Java e em simultâneo executar o Java Versão 8 (também conhecido como 1.8), é necessário trocar as versões do Java.

Para alternar entre diferentes versões do Java, abra uma janela de terminal e siga as etapas abaixo.

No exemplo a seguir, as instruções permitem pré-definir a Versão 8 (também conhecida como 1.8), sem remover o Java Versão 10:

1/6 - Identifique a versão Java pré-definida

java -version

Podemos ver a versão 10. O Ancestris não funcionará. Precisa da versão 8 (também conhecida como 1.8) para o Ancestris.

2/6 - Obtenha uma lista de todas as versões instaladas no seu sistema e verifique se a Versão 8 (também conhecida como 1.8) está entre elas:

/usr/libexec/java_home -V

Podemos ver que a versão 8 está instalada.
Caso contrário, instale-o conforme explicado nesta secção.

3/6 - Insira as 2 linhas seguintes no terminal

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

Estas duas linhas adicionarão o comando para pré-definir a sua versão Java no seu perfil pessoal.

A primeira linha pré-define a versão Java para todos os programas (JAVA_HOME, em maiúsculas).

A segunda linha pré-define a versão Java a usar pelo Ancestris (jdkhome, minúsculas).

4/6 - Feche o terminal

exit

5/6 - Reabra um terminal e verifique se o Java em execução é a versão 8

java -version

Está bem. Podemos ver a versão 8 (também conhecida como 1.8). Agora pode iniciar o Ancestris.

6/6 - Iniciar o Ancestris num terminal

Quando o Ancestris inicia, é aberta uma janela de terminal ao mesmo tempo.

Pode ver na barra de título que o Ancestris está a utilizar a versão 8 do Java.

Pré-definir a versão para Windows

Tem de criar um ficheiro BAT para cada versão Java que deseja manter.

Use o seu editor de texto favorito para criar estes ficheiros, usando o código abaixo, e coloque-os numa pasta disponível no seu 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

JAVA11.BAT

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

Ao criar estes ficheiros, especifique o nome correcto para os ficheiros Java, que serão utilizados nas linhas JAVA_HOME, dependendo da sua instalação Java

Ao decidir alterar a versão do Java, basta executar o ficheiro BAT correspondente: JAVA8 para a versão 1.8 ou JAVA11 para a versão 11. A versão do Java em uso será mostrada no terminal.

Para verificar se a alteração está realmente em vigor, digite java -version num terminal ou verifique esta página.

Se deseja manter a versão mais recente do Java e forçar o uso de outra versão do Java pelo Ancestris, é necessário alterar o ficheiro de configuração, linha jdkhome="C:\caminho\para\o\java"

Caso o Ancestris tenha dificuldade em detectar a versão Java, pode editar esta mesma linha no ficheiro de configuração pré-definido, localizado na pasta de instalação: <pasta de instalação>/etc/ancestris.conf.
Não esquecer de apagar o carácter # no início da linha.

Pré-definir a versão para Linux

Digite o seguinte numa consola:

sudo update-alternatives --config java

Seleccione na lista a versão requerida.

Se deseja manter a versão mais recente do Java e forçar o uso de outra versão do Java pelo Ancestris, é necessário alterar o ficheiro de configuração, linha jdkhome="/caminho/para/o/java"

Para obter ajuda com esta ferramenta:

sudo update-alternatives -l

Forçar o Ancestris a usar uma versão Java específica

Qualquer que seja o seu sistema operativo, se a versão Java activa pré-definida for diferente daquela a utilizar com o Ancestris, deverá modificar o ficheiro de configuração do Ancestris da seguinte maneira:

jdkhome="/caminho/para/o/java"

Nota: deve excluir /bin/java na descrição do caminho.

Por exemplo: se o executável java for /usr/java/jdk1.8.0_291-amd64/bin/java, deve indicar

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

Bem entendido, se esta linha não estiver comentada, ou seja, não começar por #, o Ancestris terá em conta a prioridade e o caminho indicado para a versão Java deve existir e indicar uma versão funcional do Java. Senão, o Ancestris não procura outra versão e não arrancará.