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

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 predefinida é 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 predefinida.

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 predefinida é 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 predefinição, siga as instruções para predefinir a versão Java e inicie o Ancestris.

Se preferir manter a versão Java predefinida, é 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 predefinida no seu sistema.

Se a versão predefinida 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 você 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, ~~pois~~porque suporta todos os recursos do Ancestris.
  - Para detalhes completos sobre como instalar a versão 88:
    - ~~Para MacOS, consulte~~ ~~Instalaç~~instalação do JRE 8 para ~~MacOS~~MacOS;.
    - ~~Para Windows, consulte~~ ~~Instalaç~~instalação do JRE para Windows;.
    - ~~Para Linux, consulte~~ ~~Instalaç~~instalação do JRE para Linux.

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

Se ~~você~~ 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.

DefinaPredefinir a versão Java padrão

~~Os procedimentos dependem do seu sistema operacional.~~

Para MacOS
Para Windows
Para Linux

Definir versão padrão para MacOS

A versão do Java em execução no seu sistema pode ser incompatível com o Ancestris, portanto, não será executada. Você receberá uma mensagem como a seguinte em um terminal quando o Ancestris iniciar.

Swap 01.png

Se você deseja manter sua versão atual do Java e, por exemplo, executar o Java Versão 8 (também conhecido como 1.8) ao mesmo tempo, é necessário trocar as versões do Java.

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

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

1/6 - Verifique qual versão do Java está definida por padrão

java -version
echo $jdkhome

Swap 02.png

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

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

/usr/libexec/java_home -V

Swap 03.png

OK, podemos ver a versão 8 (aka 1.8) instalada.
Caso contrário, instale-o conforme explicado nesta seção.

3/6 - Digite as 2 linhas a seguir 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

Essas duas linhas adicionarão o comando para definir sua versão Java padrão em seu perfil pessoal.

Swap 04.png

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

A segunda linha define a versão Java padrão a ser usada para o Ancestris (jdkhome, minúscula).

4/6 - Feche o terminal

exit

5/6 - Reabra um Terminal e verifique se o Java em execução é a Versão 8 (aka 1.8)

java -version
echo $jdkhome

Swap 05.png

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

6/6 - Iniciar Ancestris

Swap 06.png

Quando o Ancestris inicia, uma janela do Terminal é aberta ao mesmo tempo.

Você pode ver na barra de título que a Versão 8 (aka 1.8) do Java está sendo usada pelo Ancestris.

Definir versão padrão para Windows

Você precisa criar um arquivo BAT por versão Java que deseja manter.

Use seu editor de texto favorito para criar esses arquivos, usando o código abaixo, e coloque-os em uma pasta disponível em 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 esses arquivos, especifique o nome correto para os arquivos Java para as linhas JAVA_HOME, dependendo da sua instalação Java

Ao decidir alterar a versão do Java, basta executar o arquivo 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 em um console ou verifique esta página.

Se você deseja manter sua versão mais recente do Java e forçar o uso de outra versão do Java for Ancestris, é necessário alterar o arquivo de configuração, linha jdkhome="C:\path\to\java"

Definir versão padrão para Linux

Digite o seguinte em um console:

sudo update-alternatives --config java

Selecione na lista a versão necessária.

Se você deseja manter sua versão mais recente do Java e forçar o uso de outra versão do Java for Ancestris, é necessário alterar o arquivo de configuração, linha jdkhome="/path/to/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 operacional, se a versão Java ativa padrão for diferente daquela a ser usada com o Ancestris, você deverá modificar o arquivo de configuração do Ancestris da seguinte maneira:

jdkhome="/path/to/java"