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
Para instalar a versão Java 8 em seu sistema, você pode obtê-la na Página principal da Oracle ou, mais precisamente, diretamente na página de download.
- 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.
- Para detalhes completos sobre como instalar a versão 8
- A versão 8 do Java é recomendada, pois suporta todos os recursos do Ancestris.
- 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.
- Baixe e instale o Java Development Kit (JDK) Versão 11
-
-
- 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.
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.
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
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
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.
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
Está bem. Podemos ver a versão 8 (também conhecida como 1.8). Agora você pode iniciar o Ancestris.
6/6 - Iniciar Ancestris
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"