Instalação JAVA

O Ancestris precisa de Java e é compatível com Java 8 (também chamado de 1.8) e Java 11. Recomendamos que você use Java 8.

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

The following sections offer a step-by-step check to ensure Ancestris is using a valid Java 8 version.

Identifique qual versão do Java está configurada por padrão

Se você não souber se o Java está instalado ou qual versão está instalada, visite a página de explicação detalhada oficial ou abra diretamente um terminal de linha de comando e digite na linha de comando:

java -version

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

Se você vir uma mensagem de erro no terminal, o Java não está instalado no seu sistema. Ancestris não pode ser executado. Siga a seção Instalar abaixo para instalar o Java 1.8 e, em seguida, inicie o Ancestris.

Se você vir algo assim em que o Java 1.8 é exibido, significa que você tem a versão correta instalada e definida por padrão.

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 a exibição acima, podemos ver que a versão Java instalada definida por padrão é a versão 1.8, também conhecida como versão 8.

Se o Ancestris não iniciar, o Ancestris não o encontra, encontra uma versão incompatível ou encontra uma versão corrompida. Siga as instruções para identificar qual versão Java o Ancestris encontra.

Se você vir uma versão Java diferente da 1.8 ou 11, significa que você tem outra versão Java por padrão.

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 a exibição acima, podemos ver que a versão Java instalada definida por padrão é a versão 10. O Ancestris não será executado. Siga a seção Instalar abaixo para instalar o Java 8.

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

Se você deseja definir o Java 8 como a versão padrão, siga as instruções para definir a versão java padrão no seu sistema e inicie o Ancestris.

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

Identifique qual versão Java o Ancestris encontra

Para saber qual versão Java o Ancestris encontra, você precisará verificar o arquivo de configuração do Ancestris.

1. Verifique a linha que define default_options

Esta linha deve ficar assim:

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

Se uma das opções nesta linha incluir --jdkhome="/path/to/java, verifique se o caminho especificado nesta opção é o caminho para o Java versão 1.8. Caso contrário, edite o arquivo de configuração e altere-o. Então 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 parecer jdkhome="/path/to/java", verifique se o caminho especificado nesta opção é o caminho para o Java versão 8. Caso contrário, edite o arquivo de configuração e altere-o. Então inicie o Ancestris.

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

Se a versão padrão verificada acima for Java 8, significa que a versão instalada do Java 8 pode estar corrompida. Tente reinstalá-lo usando as instruções de instalação e reinicie o Ancestris.

Instale Java

ToPara ~~install~~instalar ~~version~~a versão Java 8 onem ~~your~~seu ~~system,~~sistema, ~~you~~você ~~can~~pode ~~get~~obtê-la ~~it from the~~na ~~Oracle's~~Página ~~main~~principal ~~page~~da Oracle, orou, ~~more~~mais ~~precisely,~~precisamente, ~~directly~~diretamente na ~~from~~página ~~the~~de download ~~page~~.

Para instalar a versão Java 8 em seu sistema, você pode obtê-lo na página principal do Oracle ou, mais precisamente, diretamente na página de download.

Se você deseja escolher entre todas as versões disponíveis do Oracle Java, verifique esta página de versões disponíveis.
- A versão 8 do Java é recomendada, pois suporta todos os recursos do Ancestris.
  - Para detalhes completos sobre como instalar a versão 8
    - Para MacOS, consulte Instalação do JRE 8 para MacOS.
    - Para Windows, consulte Instalação do JRE para Windows.
    - Para Linux, consulte Instalação do JRE para Linux.

O Java Versão 11 suporta a maioria dos recursos do Ancestris.
- Baixe e instale o Java Development Kit (JDK) Versão 11
  - No MacOS, escolha o arquivo .dmg.
- Para obter detalhes completos sobre como instalar a versão 11
  - Para MacOS, consulte Instalação do JDK para MacOS.
  - Para janelas, consulte Instalação do JDK para Windows.
  - Para Linux, consulte Instalação do JDK no 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.

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