Instalação do JAVA
O Ancestris é compatível com as versões Java 8 a 21.
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.
Princípio geral
- O Ancestris funciona com as versões Java indicadas ao cimo da página.
- O Ancestris é compilado na versão 8 para maior compatibilidade com o maior número de utilizadores.
- Foi testado e funciona em versões LTS (Long Term Support).
- Não testamos as versões Short Term, que se tornam rapidamente obsoletas e não podem ser transferidas após 18 meses, mas os utilizadores disseram-nos que o Ancestris também funciona em versões intermédias.
-
Se uma versão funcional de Java estiver disponível no seu sistema, o Ancestris encontrá-la-á sem ter de configurar nada.
-
Caso contrário, pode instalar o Java de qualquer fornecedor. Os nossos utilizadores sentem-se mais confortáveis com o Adoptium.
-
Para saber se o Java está instalado no seu sistema, siga estas instruções.
-
Se o Ancestris não iniciar quando o Java estiver instalado, consulte a secção Resolução de problemas.
-
Podem estar instaladas várias versões de Java no seu sistema. Para indicar ao Ancestris qual delas deve ser utilizada, é necessário:
-
actualizar o ficheiro de configuração do Ancestris, seguindo estas instruções.
-
-
- mudar a versão pré-definida do Java, seguindo estas instruções.
Instalação do Java
Uma forma simples de recuperar uma versão do Java, é transferi-la a partir de Adoptium.net
Se não tiver o Java instalado, ou se pretender obter a versão mais recente ou uma versão específica do Java, basta transferi-lo a partir do sítio acima referido.
Saber se o Java está instalado
Se não souber se o Java está instalado ou qual a versão instalada, abra directamente um terminal de linha de comandos e insira:
java -version
- 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 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 vir uma versão Java como no exemplo acima e está satisfeito com essa versão, pode ignorar o resto desta página.
Resolução de problemas
Se o Ancestris não iniciar, é porque não encontra o Java ou encontra uma versão incompatível ou corrompida.
Quer esteja instalada apenas uma versão do Java no seu sistema ou várias, terá de verificar e possivelmente actualizar o ficheiro de configuração para indicar ao Ancestris onde encontrar o Java.
Em vez de modificar o ficheiro de configuração da Ancestris, e se estiverem disponíveis várias versões de Java no seu sistema, uma alternativa é modificar a versão predefinida do Java.
- A versão pré-definida do Java é a que aparece quando se escreve
como indicado na secção acima. Esta é a que a Ancestris utilizará se o ficheiro de configuração não existir ou não indicar onde encontrar o Java.java -version
Em caso de dúvida, inicie o Ancestris manualmente a partir duma janela de terminal e envie-nos o texto que aparece no ecrã.
Independentemente do sistema operativo que estiver a utilizar, abra uma janela de terminal e:
- vá à pasta da aplicação
ancestris/bin;
- Inicie o Ancestris manualmente;
- digitando
./ancestris
em macOS ou Linux; - digitando
ancestris.exe
ouancestris64.exe
em Windows; - a janela do terminal mostrará o que ele faz;
- envie-nos este ecrã.
Actualizar o ficheiro de configuração do Ancestris
Não precisa de se preocupar com o que está detalhado abaixo a não ser que o Java não esteja instalado ou que o Ancestris não inicie.
VousÉ deveznecessário mettreactualizar à jour leo fichierficheiro de configurationconfiguração do Ancestris pourpara indiquerlhe àindicar Ancestris oùonde trouverencontrar JavaJava, se o Ancestris não o conseguir encontrar por si Ancestris ne le trouve pas tout seul.próprio.
LeO principeprincípio esté leo suivant :seguinte:
S'ilseexistehouverunumfichierficheiro deconfigurationconfiguraçãoquiqueinclutincluaunumparamètreparâmetro jdkhomeindiquantindicandooùondetrouverencontrar o Java, o Ancestrisutiliserautilizarálaaversion deversão javacorrespondante.correspondente;Sinon,caso contrário, o Ancestrisutiliserautilizarálaaversionversãodepré-definida do Javaparindicadadéfautnaindiquéesecçãodans la section au-dessus.acima.
O Ancestris utiliseutiliza deuxdois fichiersficheiros de configuration,configuração, tousambos deux nomméschamados ancestris.conf1/1. LeO premierprimeiro esté leo fichierficheiro de Configurationconfiguração Applicationda aplicação, quique faitfaz partieparte duda répertoirepasta ApplicationAplicação ete qui est créé lorscriado quando o Ancestris é instalado.
2. O outro é o ficheiro de l'installationconfiguração d'do utilizador, que faz parte da pasta do utilizador e é criado quando modifica certas preferências ao utilizar o Ancestris.
O 2/ L'autre est le fichierficheiro de Configurationconfiguração Utilisateur,do quiutilizador faitprecede partieo du répertoire utilisateur, et qui est créé lorsque vous modifiez certaines préférences lorsficheiro de l'utilisationconfiguração d'Ancestris.da alicação.LeO fichierficheiro de Configurationconfiguração Utilisateura estverificar prioritairee suractualizar leé, fichierportanto, o ficheiro de Configurationconfiguração Application.Ledo fichierutilizador, se existir, e o ficheiro de configurationconfiguração àda vérifieraplicação, etse ànão mettreexistir.
- àSe jourestiver esta doncinstalar leo fichierAncestris, terá provavelmente de Configurationactualizar Utilisateuro s'il existe, et le fichierficheiro de Configurationconfiguração Applicationda dans le cas contraire.aplicação.
- SiSe vousjá installezutilizou Ancestris,o vousAncestris devreze probablementpretende mettrealterar àa jourversão ledo fichierJava, terá provavelmente de Configurationactualizar Application.-o Si vous avez déjà utilisé Ancestris et que vous voulez changer la versionficheiro de java,configuração vousdo devrez probablement mettre à jour le fichier de Configuration Utilisateur.utilizador.
Cliquez ici pour savoir où trouver le fichier de configuration en fonction de votre système.
LeO chemincaminho d'accèsde àacesso ao Java dansno le fichierficheiro de configurationconfiguração
DoncPor ouvrezisso, leabra fichiero ficheiro de configurationconfiguração aveccom unum éditeureditor de textetexto normal.
1. RepérezLocalize laa lignelinha quique définitdefine default_options
CetteEsta lignelinha ressembletem ào ceci:seguinte aspecto:
default_options="--branding ancestris -J-Xms96m -J-Xmx1g --laf javax.swing.plaf.nimbus.NimbusLookAndFeel"
SiSe l'uneuma desdas optionsopções dansnesta cettelinha ligne inclutincluir --jdkhome="/
, chemin/vers/caminho/para/javaassurez-vousassegure-se de que leo chemincaminho indiquéindicado dansnesta cettedefinição définitioné esto celuida deversão la version javaJava que vousdeseja souhaitez utiliser.utilizar.
SiSenão, elleprocure n'inclut pas l'option en question, recherchezpor jdkhome ailleurs..noutro lado.
2. RepérezEncontre laa lignelinha quique définitdefine jdkhome
SiSe cetteexistir, lignedeve-se existe,parecer ellecomjdkhome="/caminho/para/java"
. doitAssegure-se ressemblerde àque o caminho indicado nesta definição é o da versão Java que deseja utilizar.
Se a lunha começa por "#", sinal de uma linha de comentário, o Ancestris ignorá-la-á e, por consequência, nnão terá em conta o parâmetro jdkhome indicado.
Se o Ancestris não iniciar, pode acontecer que o nome da pasta indicada por jdkhome esteja mal escrito ou que aponte para uma versão incorrecta do Java.
Qualquer que seja o seu sistema operativo, se a versão de Java a utilizar para o Ancestris for diferente da que está activada por defeito no seu sistema, é necessário modificar a linha jdkhome da seguinte forma:
jdkhome="/chemin/vers/
java"jdk". Assurez-vous , que le chemin indiqué dans cette définition est celui de la version java que vous souhaitez utiliser.
Si la ligne début par "#", signe d'une ligne de commentaire, Ancestris l'ignorera et par conséquent, ne tiendra pas compte du paramètre jdkhome indiqué.
Si Ancestris ne démarre pas, il se peut que le nom du dossier donné par jdkhome soit mal orthographié ou qu'il pointe vers une version incorrecte de Java.
Quel que soit votre système d'exploitation, si la version de java à utiliser pour Ancestris est différente de celle activée par défaut sur votre système, il faut modifier la ligne jdkhome comme ceci:jdkhome="/chemin/vers/jdk"
Cas de macOS
Pour macOS, si par exemple Java 18 et Java 17 sont installés sur votre Mac et que vous souhaitez forcer l'utilisation de Java 17 pour Ancestris, la manipulation complète pour forcer la version de Java serait la suivante :
-
Modifiez le fichier de configuration de l'utilisateur d'Ancestris s'il existe :
-
Le fichier est
/Users/<yourname>/Library/Application Support/ancestris/<version ou trunk>/etc/ancestris.conf
. -
Remplacez <votre nom> par le nom que vous utilisez sur votre Mac
-
Remplacez <version ou trunk> par le numéro de version d'Ancestris que vous utilisez : la version stable et officielle actuelle est un numéro : 11 par exemple ; la version quotidienne est appelée 'trunk'.
-
Pour voir le dossier Library dans le Finder, vous devez appuyer sur Command+J. Il est caché par défaut
Traduit avec DeepL.com (version gratuite)
-
-
Si le fichier de configuration utilisateur n'existe pas, parce que vous n'avez pas encore utilisé Ancestris par exemple, éditez alors le fichier de configuration d'Ancestris de l'application
/Applications/Ancestris.app/Contents/Resources/ancestris/etc/ancestris.conf
-
Repérez la ligne
#jdkhome="/chemin/vers/java"
et supprimer le caractère # du début de ligne pour dé-commenter cette ligne et pour qu'Ancestris en tienne compte. - Remplacer la par, en supposant que témurin 17 soit la version de java à forcer :
- Sauvegardez le fichier ancestris.conf ainsi modifié et vérifiez qu'il s'est bien sauvegardé.
- Relancez Ancestris.
Cas de Windows et Linux
Pour Windows ou Linux par exemple, si l'exécutable java est /usr/java/jdk1.8.0_291-amd64/bin/java, alors vous devez indiquer
Note: vous devez exclure /bin/java de la description du chemin.
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"
Caso o Ancestris tenha dificuldade em detectar a versão Java, pode editar esta mesma linha no ficheiro de configuração pré-definido, localizado na pasta de instalação: <pasta de instalação>/etc/ancestris.conf.
Não esquecer de apagar o carácter # no início da linha.
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á.