Instalação do JAVA
O Ancestris precisa do Java e é compatível com Java 8 (também chamado de 1.8) eaté Java 11.18. 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 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:
- A versão 8 do Java é a recomendada, porque suporta todos os recursos do Ancestris.
- 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
- Transfira e instale o Java Development Kit (JDK) Versão 11:
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.
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"
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á.