Skip to main content

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:

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 
      java -version
       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.
    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 ou ancestris64.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 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'ilse existehouver unum fichierficheiro de configurationconfiguração quique inclutinclua unum paramètreparâmetro jdkhome indiquantindicando onde trouverencontrar o Java, o Ancestris utiliserautilizará laa version deversão java correspondante.correspondente;
    • Sinon,caso contrário, o Ancestris utiliserautilizará laa versionversão depré-definida do Java parindicada défautna indiquéesecção dans la section au-dessus.acima.

    O Ancestris utiliseutiliza deuxdois fichiersficheiros de configuration,configuração, tousambos deux nomméschamados ancestris.conf
    1/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 vous 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/java, assurez-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 :

    jdkhome="/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"
    • 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


    jdkhome="/usr/java/jdk1.8.0_291-amd64/"

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

    Swap 01.png

    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

    Swap 06.png

    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

    en_linux-java-versions.png

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