Instalação do JAVA

O Ancestris precisa do Java e é compatível com Java 8 (também chamado de 1.8) e Java 11. Recomendamos que utilize o Java 8.

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.

Identifique a versão Java predefinida

Se não souber se o Java está instalado ou qual a versão instalada, vá à página oficial de ajuda. ou abra directamente um terminal de linha de comandos e insira:

java -version

Existem métodos alternativos para MacOS e Windows;
- para sistemas MacOS, veja as instruções passo-a-passo;
- para sistemas Windows, veja as instruções passo-a-passo.

 

  • 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 1.8 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 o Ancestris não iniciar, é porque não encontra o Java ou encontra uma versão incompatível ou corrompida. Siga as instruções para identificar a versão Java encontrada.

  • Se vir uma versão Java diferente da 1.8 ou 11, significa que tem outra versão Java pré-definida.
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)

De acordo com o exemplo acima, podemos ver que a versão Java instalada e pré-definida é a versão 10. O Ancestris não será executado. Siga a secção Instalar abaixo para instalar o Java 8.

Depois de concluída, terá várias versões Java instaladas no seu sistema.

Se deseja definir o Java 8 como pré-definição, siga as instruções para pré-definir a versão Java e inicie o Ancestris.

Se preferir manter a versão Java pré-definida, é necessário dizer ao Ancestris para não a usar. Siga as instruções para forçar o Ancestris a usar uma versão Java específica e inicie o Ancestris.

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

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.

Swap 01.png

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

Swap 06.png

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"

Pré-definir a versão para Linux

Digite o seguinte numa consola:

sudo update-alternatives --config java

en_linux-java-versions.png

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"

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