Instalar o Ancestris

• Instalar e iniciar o Ancestris
• Reinstalar o Ancestris ou mudar de versão
• Actualizar o Ancestris
• Instalação passo-a-passo em MacOS
• Instalação passo-a-passo da versão estável em Windows
• Instalação passo-a-passo da versão quotidiana em Windows
• Instalação do JAVA
• Configurações de arranque
• Ficheiros de programa e ficheiros de configuração do utilizador

Instalar e iniciar o Ancestris

Leia os direitos de licença e utilizador

O Ancestris é um programa gratuito, licenciado sob a GNU GENERAL PUBLIC LICENSE V3.

O Ancestris é um programa de genealogia que pode utilizar  por tempo ilimitado e sem limite de indivíduos.

É disponibilizado por voluntários.

Verifique a configuração necessária

O Ancestris trabalha em todas as versões MacOS, Windows e Linux com Java instalado.

Se o Ancestris não inicia, ou mostra o ecrã inicial e pára, normalmente indica um problema com a instalação do Java.

Para utilizar o Ancestris, é indispensável ter a seguinte configuração:

• Java versão 8, 11, 17 e 18.

• 2 Gb de RAM
• 200 Mb de espaço disponível no disco rígido
• um ecrã suficientemente grande, recomendamos pelo menos 1920 x 1080

O Java é um pré-requisito

Para utilizar o Ancestris, tem de ter o Java instalado no seu sistema.

O Ancestris é compatível com o  Java Version 8, 11, 17 e 18.

Para descobrir qual versão Java instalada no seu sistema, outras versões do Java disponíveis, como alternar entre versões Java ou os requisitos técnicos do Java, consulte a página de instalação do Java.

Instalação

Se necessita de instruções detalhadas para a instalação, fornecemos guias passo-a-passo para todas as plataformas:
✔ Instalação passo-a-passo em MacOS
✔ Instalação passo-a-passo da versão 12 em Windows
✔ Instalação passo-a-passo da versão 13 em Windows

Segue-se uma visão geral da instalação e as ligações, em caso de problemas ou para alterar as definições de início. 

Vá à secção Transferir na página do Ancestris

Pode transferir o Ancestris gratuitamente na página https://www.ancestris.org, menu TRANSFERIR.

Escolha a sua versão do Ancestris

Duas versões estão disponíveis:

• se aprecia a estabilidade de utilização, escolha a versão com o número mais baixo e abdique dos derradeiros avanços no desenvolvimento;
• ou escolha a versão quotidiana (com o número mais alto), se deseja beneficiar dos últimos desenvolvimentos do programa.

Todas as  versões funcionam em qualquer computador e qualquer sistema operativo que permita executar o Java.

Todas as versões funcionam com qualquer dos idiomas traduzidos.

Todas as versões são versões integrais e permitem uma utilização ilimitada.

Transferir a versão estável

Disponível  e dedicada a permanecer estável durante alguns anos. Não evoluirá mais, tendo recebido já todas as correcções eventuais.

Para facilitar a transferência da versão estável, propomos três opções, MacOS, WIndows e Linux.

• Clique no botão correspondente ao seu sistema operativo:
  • MacOS,
  • Windows,
  • ou Linux (paire com o rato sobre a palavra Linux para ver as opções disponíveis: ficheiro AppImage, ficheiro ZIP genérico).
• O ficheiro a transferir é específico para o sistema operativo escolhido.
• Grave o ficheiro.
• Clique em Aceitar/Guardar.
• A transferência dura alguns minutos e permite obter um ficheiro na ordem dos 100 Mb.

Transferir a versão quotidiana

Beneficia dos derradeiros desenvolvimentos e de traduções actualizadas. Pode evoluir todos os dias, propondo actualizações automáticas. Há o risco de pequenos problemas, mas visa sempre respeitar a integridade dos seus dados.

Propomos ainda uma forma simples de transferir a versão quotidiana (a que tem o número mais alto),  que funciona igualmente bem em MacOS, Windows e Linux.

• Clique em Transferir
• O ficheiro a transferir é um ficheiro ZIP
• Grave o ficheiro
• Clique em Aceitar/Guardar
• A transferência dura alguns minutos e permite obter um ficheiro na ordem dos 100 Mb. É ligeiramente superior ao da versão estável, uma vez que contém todos os módulos suplementares pré-instalados.

Escolha a pasta Ancestris

Quando a transferência terminar, encontrará o ficheiro na sua pasta de Transferências predefinida.

Se não souber qual é a pasta, verifique as definições do seu navegador da Internet ou clique no ícone transferido no seu navegador.

A partir dessa pasta, mova o ficheiro transferido para onde desejar no seu computador.

Iniciar o Ancestris

A maneira de iniciar o Ancestris difere um pouco, dependendo da versão que transferiu.

Versão estável

• MacOS : basta fazer clique sobre o ficheiro transferido e o Ancestris instala-se na pasta Applications, a partir da qual pode iniciar o Ancestris.
• Windows : basta clicar duas vezes no ficheiro exe transferido Ancestris11Setup.exe. Este programa de instalação ajudará a instalar o Ancestris e também criará o ícone do programa.
• Linux : faça duplo clique sobre o ficheiro ancestris-11_<date>_<arch>.rpm ou ancestris-11_<date>_<arch>.deb para instalar o Ancestris e iniciar a aplicação obtida

Versão quotidiana

Qualquer que seja o seu sistema operativo, descomprima o ficheiro ZIP transferido.

Os ficheiros do Ancestris estarão dentro da pasta ancestris. Consulte a página de ficheiros do programa para ter uma visão detalhada da pasta ancestris.

Para iniciar o Ancestris, execute o ficheiro correspondente ao seu sistema operativo.

A forma de aqui chegarmos é ligeiramente diferente de versão para versão.

Solução de problemas

Se o Ancestris não iniciar, ou mostrar o ecrã inicial do Ancestris e parar, geralmente está relacionado a problemas 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.
Por favor, verifique a página de instalação do Java para obter ajuda.

Se precisar de etapas detalhadas de instalação, leia o guia passo a passo abaixo correspondente ao seu sistema:
✔ Guia de instalação passo-a-passo para MacOS
✔ Guia de instalação passo-a-passo da versão estável para Windows
✔ Guia de instalação passo-a-passo da versão quotidiana para Windows

Personalização

Ícone de atalho

Se precisar de personalizar um atalho com um ícone bonito para iniciar o Ancestris, verifique a documentação do sistema operativo sobre como criá-lo e sinta-se à vontade para usar o ficheiro de imagem incluído, ancestris.gif.
Em MacOS, clique no executável e coloque o Ancestris na barra de activação. Veja o guia passo-a-passo.
Em Windows, clique com o botão direito do rato e escolha "Criar atalho" e altere o ícone do atalho. Veja o guia passo-a-passo.
Para Linux, existem vários desses procedimentos e bastante diferentes de um sistema para outro.

Configurações de arranque

Pode personalizar a maneira como o Ancestris inicia, como a alocação de memória, por exemplo. Caso precise de personalizar o arranque do Ancestris, consulte a página Configurações de arranque.

Configurações do utilizador

Se tiver interesse em saber onde estão os ficheiros de configuração do utilizador, consulte a página Ficheiros do programa e ficheiros de configuração do utilizador.

Reinstalar o Ancestris ou mudar de versão

Há várias situações em que pode precisar de reinstalar o Ancestris, mas todas elas seguem as mesmas etapas descritas abaixo.

Situações que justificam a reinstalação

Reinstalar o Ancestris no mesmo computador:

• se uma nova versão do Ancestris estiver disponível e quiser beneficiar dela, por exemplo, actualizar da versão 12 para a versão 13;
• se houve uma modificação importante da mesma versão, geralmente a versão diária, por exemplo, quando a equipa do Ancestris faz alterações na plataforma do Ancestris; para ser notificado de tais alterações, terá de se inscrever na lista de distribuição;
• Se ocorreu uma alteração no seu computador ou se se perderam alguns ficheiros do Ancestris.

Em todas estas situações, a sua acção resultará na reinstalação do Ancestris.

Ao reinstalar o Ancestris, poderá preservar automaticamente as suas personalizações.

Cabe-lhe decidir se deseja reinstalar o Ancestris no mesmo local no seu computador ou não.
Em qualquer caso, recomendamos que elimine a instância anterior do Ancestris e substitua os ficheiros de programa.
Caso mantenha duas instâncias diferentes do Ancestris no mesmo computador, pode originar confusão, dado que só existe um conjunto de configurações do utilizador.

Reinstalar o Ancestris num segundo computador

Se deseja instalar o Ancestris num segundo computador, faça uma instalação inicial normal.

Se deseja ter as mesmas configurações nos dois computadores, copie primeiro a pasta de configurações de um computador para o outro.

Como alternativa, também pode usar o botão de exportação na janela de preferências do Ancestris.

Reinstalar a versão estável

Para reinstalar a versão estável, preservando as suas configurações, faça uma instalação inicial normal.

Deve ser muito rápido, dado que o Java já deve estar instalado e os atalhos do Ancestris já estão definidos.

Na prática, consistirá na simples substituição das cinco pastas descritas nas etapas a seguir.

Mudar da versão estável ou reinstalar

Para actualizar da versão estável para a versão quotidiana, ou reinstalar a versão quotidiana, preservando as suas personalizações:

• feche o Ancestris, se estiver em execução;
  • transfira a versão quotidiana dos nossos servidores Ancestris e siga o procedimento recomendado para o seu sistema operativo;
• vá à pasta ancestris na localização da instalação anterior;
• elimine as seguintes pastas:
  • ancestris
  • bin
  • etc
  • harness
  • platform
• substitua-as pelas pastas recém-transferidas correspondentes;
• reinicie o Ancestris como de costume.

Caso algumas configurações já não funcionem ou não sejam compatíveis com a nova versão, consulte a página de configurações do utilizador.

Actualizar o Ancestris

A equipa Ancestris trabalha constantemente na melhoria do Ancestris.

Todas as actualizações que fazemos na versão que utiliza estão disponíveis automaticamente e não precisa de fazer nada, esteja a utilizar a versão principal ou a versão diária.

Actualizações automáticas

Receberá uma notificação automática das actualizações da sua versão actual, sempre que iniciar o Ancestris.

Quando o Ancestris for iniciado, verá um pequeno balão por alguns segundos no canto inferior direito, indicando o número de actualizações disponíveis. Basta clicar na ligação neste balão e seguir as etapas.

Se perder este balão, só aparece por alguns segundos, o pequeno ícone do globo permanecerá disponível. O balão reaparecerá novamente.

Se clicar para obter as actualizações, ser-lhe-á solicitado que confirme a transferência das actualizações.

Clique em Avançar e o Ancestris fará a transferência. Verá uma barra de progresso no canto inferior direito.

Depois da transferência, o Ancestris pede a sua confirmação.

Clique em Continuar e verá o mesmo balão oferecendo o reinício do Ancestris para concluir a actualização.

Actualizações manuais

Também é possível efectuar actualizações a qualquer momento. Basta escolher Opções -> Procurar actualizações na barra de menu principal. Será aberto o mesmo assistente mostrado acima. Basta seguir as mesmas etapas.

Se nenhuma actualização estiver disponível, verá a seguinte janela:

Saiba mais sobre as actualizações

Se utiliza a versão estável

Quando detectamos erros que podem afectar o uso da versão principal, corrigimo-los e a actualização fica disponível de acordo com as instruções acima.

Estas actualizações são muito raras.

Se usa a versão quotidiana

Em relação à versão quotidiana, as actualizações acontecem quase diariamente!

Actualizações menores

Na maioria das vezes, as actualizações são evoluções ou novas funcionalidades.

Estas actualizações estão regularmente disponíveis.

Pode beneficiar delas de acordo com a descrição acima.

Actualizações estruturais

Em raras ocasiões, certas actualizações do Ancestris versão quotidiana acontecem na plataforma principal do Ancestris.

Essas alterações podem ser simples traduções de menu ou algo importante. Por exemplo, quando actualizamos a plataforma Netbeans subjacente, sobre a qual o Ancestris funciona.

A equipa do Ancestris notificará os utilizadores através do fórum ou da lista de distribuição e no painel Actualizações recentes da janela de boas vindas do Ancestris.

Por exemplo, a imagem abaixo mostra em amarelo, uma actualização da versão 11 que ocorreu em 12 de Janeiro de 2021.

Como de costume, estas actualizações estarão disponíveis através das actualizações automáticas descritas acima.

No entanto, se aplicar só as actualizações automáticas, não obterá o programa completo. Ou seja, a nova evolução ainda não estará disponível (por exemplo, traduções de menus) ou talvez tenha algumas disfunções importantes. O Ancestris pode deixar de funcionar.

Não se preocupe, isto não altera os seus dados. Para beneficiar totalmente das alterações, terá de reinstalar o Ancestris. Por favor, siga as instruções de reinstalação neste caso.

Instalação passo-a-passo em MacOS

Esta página mostra como instalar o Ancestris num sistema MacOS.

Mostramos aqui um exemplo que teve lugar em Março de 2024, uma instalação da versão 12 do Ancestris em MacOS Sonoma

1 - Abra o menu de ferramentas do MacOS.

2 - Abra um terminal e insira "java -version".

Se o Java estiver instalado, a resposta indicará tal facto e mostrará o número da versão.

Abaixo podemos ver que a versão 17 está instalada.

Se o Java estiver instalado, passe directamente ao passo 5.

Caso contrário, a resposta será de que o Java não foi encontrado. Siga as etapas seguintes.

3 - Instale o Java indo à página Adoptium.

Podemos observar que nos é proposto o Java com suporte a longo prazo (LTS), versão 21 para macOS.

Clique em "Latest LTS Release".

Inicia-se a transferência. Aceite o ficheiro no seu navegador e aguarde.

Após um momento, terminou a transferência.

Inicie a instalação. Deverá ver a janela seguinte.

Clique em "Continue".

Clique em "Continue".

Clique em "Agree".

Clique em "Install".

Valide a instalação com impressão digital ou senha.

Começa a instalação.

Terminou a instalação, clique em "Close".

Por fim, decida se deseja manter o pacote de instalação.

4 - Verifique se o Java foi correctamente instalado na janela do terminal.

Escreva "Java -version".

Verá o seguinte, indicando que a instalação foi bem sucedida.

Terminou a instalação do Java. Prossigamos agora com a instalação do Ancestris.

Instalação do Ancestris

5 - Vá à página https://pt.ancestris.org/index_pt.html e clique em Transferir.

Isto leva-nos à secção de transferências.

Clique em "Ancestris XX" (XX é o número mais alto) na coluna macOS. Começa a transferência.

Quando terminar, verá a dimensão do pacote, na imagem cerca de 94 MB.

Inicie o instalador, clicando em "Open".

Deverá ver a janela de instalação do Ancestris.

Clique em "Continue".

Clique em "Install".

Confirme a instalação com impressão digital ou senha.

Começa a instalação.

O instalador pede permissão para instalar os ficheiros no seu computador. Clique em "Allow".

A instalação termina. Clique em "Close".

Por fim, decida se deseja conservar o pacote de instalação.

6 - Inicie o Ancestris a partir do ecrã de início de aplicações.

O Ancestris inicia.

Verá a janela principal da aplicação.

O idioma do Ancestris deverá ser ajustado automaticamente para o do seu computador.

Parabéns!

Instalação passo-a-passo da versão estável em Windows

Esta página mostra passo-a-passo como instalar a versão estável do Ancestris num sistema Windows.

Instalar a versão estável do Ancestris

Siga as instruções abaixo.

1/4 - Transferir o Ancestris

• vá a https://www.ancestris.org;
• clique em Transferir no menu;
• clique na palavra "WINDOWS";
• a transferência pode levar de 3 a 4 minutos, tem cerca de 139 Mb.

2/4 - Faça duplo clique duas vezes no ficheiro transferido

• A versão estável do Ancestris possui um assistente de configuração para Windows;

• clique em Seguinte;

• aceite o contrato e clique em Seguinte;

• escolha um caminho de instalação;

O caminho não deve ter acentos nem caracteres especiais.

• clique em Seguinte;

• defina um nome para o atalho no menu "Iniciar";
• pode optar por não criar nenhum atalho marcando a caixa na parte inferior esquerda da janela;
• clique em Seguinte;

• marque a caixa para criar um atalho na área de trabalho;
• clique em Seguinte;

• clique em Instalar;

• o programa está instalado no seu computador;

• pode iniciar directamente a aplicação com a caixa "Executar o Ancestris"

3/4 - Clique no atalho e o Ancestris é iniciado.

4/4 - Verá a página de boas vindas. Agora está tudo pronto para utilizar o Ancestris.

Instalação passo-a-passo da versão quotidiana em Windows

Esta página mostra como instalar a versão quotidiana d o Ancestris num sistema Windows.

As secções abaixo são independentes e nem todas precisam ser feitas.

Os ecrãs mostrados podem parecer diferentes dos que verá no seu sistema ou mesmo da versão actual do Ancestris.

Identificar a versão Java

Painel de controlo Java

Abra o painel de controlo do Windows e depois o painel de controlo do Java.

No separador Geral, clique em "About" para verificar a versão Java instalada.

No separador Security, desmarque a opção "Enable Java content for browsers and Web Start applications" para melhorar a segurança.

Linha de comandos

Como alternativa, estas etapas permitem identificar a versão Java em execução no seu sistema:

1 - Abra uma janela do Windows PowerShell e insira o CMD ou abra uma janela de linha de comandos.

2 - Insira java -version. Obterá algo parecido com o que está abaixo, que mostra que o Java Versão 8 (também conhecido como 1.8) de 64 bits está instalado. Caso contrário, isso significa que o Java não está instalado. Siga estas instruções para instalá-lo.

java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode)

3 - Insira exit uma ou duas vezes para fechar a linha de comandos.

Instalar a versão quotidiana do Ancestris

Siga as instruções abaixo no seu sistema Windows.

1/6 - Transfira o Ancestris

• Vá a https://www.ancestris.org;

• clique em Transferir no menu;

• role para baixo até à secção Versão diária e clique no botão Transferir para obter a versão quotidiana;

• a transferência pode levar 2 ou 3 minutos, tem cerca de 100 MB.

2/6 - Extraia o arquivo Ancestris

• O Ancestris não precisa de ser instalado, é executado directamente a partir do ficheiro .exe.;
• Logo, clique com o botão direito do rato no arquivo ancestris-latest.zip transferido, escolha "Extrair tudo" e seleccione uma pasta de destino onde o ficheiro .exe possa ser executado.
• No Windows 7, descomprima na pasta C:\Program Files, caso contrário o Ancestris não será executado.

3/6 - Verifique o ficheiro Ancestris a executar

• Na pasta de destino, abra a pasta ancestris e depois a pasta bin; aí, o ficheiro ancestris64.exe executará o Ancestris num sistema de 64 bits, enquanto o ficheiro ancestris.exe executará o Ancestris num sistema de 32 bits.

4/6 - Adicionar um atalho do Ancestris

• Clique com o botão direito do rato no ficheiro ancestris64.exe ou ancestris.exe e escolha "Afixar em Iniciar" ou "Afixar na barra de tarefas" para adicionar um atalho ao menu Iniciar ou à barra de tarefas.

• Em seguida, defina o ícone do atalho resultante. Para isso, é necessário clicar com o botão direito do rato no atalho e substituir o ícone pelo ficheiro ancestris.gif.

5/6 - Clique no atalho e o Ancestris é iniciado.

6/6 - Verá a página de boas vindas. Agora está tudo pronto para utilizar o Ancestris.

Se o Ancestris não iniciar, pode estar relacionado com um problema de versão Java. Pode ser necessário trocar a versão do Java. Por favor, siga estas instruções.

Instalação do JAVA

O Ancestris precisa do Java e é compatível com Java 8 (também chamado de 1.8) até Java 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:
      • instalação do JRE 8 para MacOS;
      • instalação do JRE para Windows;.
      • instalação do JRE para Linux.

• 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
    • instalação do JDK em MacOS;
    • instalação do JDK para Windows;
    • Instalação do JDK em Linux.

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

• •  
• Para MacOS
• Para Windows
• Para Linux

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

Configurações de arranque

É possível personalizar as configurações de arranque do Ancestris.

Em geral, não é necessário configurá-las ou modificá-las.

No entanto, nalgumas circunstâncias específicas, convém ajustá-las um pouco.

É tão simples quanto editar a linha no ficheiro de configuração do Ancestris. Por favor, consulte o a localização do ficheiro de configuração.

Definir o tamanho da memória para genealogias grandes

O Ancestris funciona perfeitamente bem com genealogias de várias dezenas ou milhares de indivíduos.

Pode fazer o Ancestris trabalhar com várias genealogias ao mesmo tempo.

Recomendamos uma memória de 4 GB para genealogias muito grandes.

O Ancestris pode abrir e gerir uma genealogia simples de 600.000 indivíduos.

---

Para genealogias muito grandes, recomendamos que altere os parâmetros de arranque do Ancestris para aumentar o tamanho máximo de memória para o Java.

• Parâmetro a alterar: -J-Xmx para 8GB, por exemplo:

default_options="-J-Xmx8g --laf Nimbus --branding ancestris --locale pt -J-Xms96m"

Recomendamos ainda, se necessário, reiniciar o dispositivo e iniciar apenas o Ancestris e nada mais, para que toda a memória disponível seja alocada para o Ancestris.

Pré-definir o idioma

O idioma pré-definido pode ser escolhido nas preferências do Ancestris.

Também pode ser inicializado num idioma da sua escolha usando a configuração de arranque.

• Parâmetro a alterar: --locale para um dos códigos de idioma de dois dígitos. Exemplo : "en" para inglês:

default_options="-J-Xmx1g --laf Nimbus --branding ancestris --locale en -J-Xms96m"

Pré-definir a aparência e comportamento

A aparência pode ser definida nas preferências do Ancestris.

Também pode ser inicializado com uma aparência da sua escolha usando a configuração de arranque.

• Parâmetro a alterar: --laf para um dos nomes fornecidos nas preferências do Ancestris. Por exemplo. "Nimbus":

default_options="-J-Xmx1g --laf Nimbus --branding ancestris --locale en -J-Xms96m"

Para regressar à pré-definição, remova o parâmetro da linha.

Pré-definir o tamanho do ícone

Em circunstâncias muito raras, se modificar o tamanho pré-definido das letras e ícones no seu computador ou usar um ecrã muito grande, o Ancestris poderá mostrar os seus ícones num tamanho muito pequeno.

É possível aumentar o aspecto dos ícones com o Ancestris usando o método a seguir, mas apenas com o Java 11.

• Parâmetro a alterar: -J-Dsun.java2d.uiScale=1.5

default_options="-J-Xmx1g --laf Nimbus --branding ancestris --locale en -J-Xms96m -J-Dsun.java2d.uiScale=1.5"

Instruções específicas do Windows

Outra maneira de forçar o tamanho do ícone no Windows com Java versão 8 é a seguinte:

Clique com o botão direito do rato em ancesris.exe ou ancestris64.exe, seleccione Propriedades e escolha o separador Compatibilidade.

Ficheiros de programa e ficheiros de configuração do utilizador

Há dois grupos de ficheiros necessários para executar o Ancestris:

• os ficheiros de programa, que executam o programa;
• os ficheiros de configuração do utilizador, que armazenam as preferências do utilizador.

Pode arriscar perder os ficheiros de programa porque pode sempre obtê-los na página do Ancestris;
mas deve fazer seguranças dos ficheiros de configuração do utilizador, uma vez que são especificamente seus.

Ficheiros de programa

Os ficheiros de programa do Ancestris estarão dentro da pasta ancestris usada durante a instalação.

Pode inserir whereis ancestris num terminal para saber onde está essa pasta (não no Windows).

Esta pasta ancestris contém as seguintes sub-pastas.

• ancestris
• bin
  • ancestris : ficheiro executável para iniciar o Ancestris em MacOS e Linux
  • ancestris.exe : ficheiro executável para iniciar o Ancestris em Windows
    
  • ancestris64.exe : ficheiro executável para iniciar o Ancestris no Windows com arquitectura Java de 64 bits (recomendado)
  • ancestris.gif : ícone Ancestris a usar ao criar um atalho do Ancestris
  • outros ícones Ancestris
• etc
• harness
• platform

Ao reinstalar o Ancestris, está simplesmente a substituir estes ficheiros e pastas..

Ficheiros de configuração do utilizador

A pasta do utilizador

Os ficheiros de configuração do utilizador Ancestris estão na pasta do utilizador.

Pode ver a localização da pasta do utilizador no diálogo Acerca.
Este diálogo pode ser acedido no menu principal,  Ajuda/Acerca do Ancestris ou então clicando em .

Exemplo :

Esta pasta do utilizador depende do seu sistema operativo.

• Windows : C:\Users\[utilizador]\.ancestris\<version>
• MacOS : ${HOME}/Library/Application Support/ancestris/<version>
• Linux : ~/.ancestris/<version>

Onde <version> é o número da versão instalada.

• 11 : neste caso, a versão principal 11
• trunk : neste caso, a versão diária 12

O ficheiro de configuração e o ficheiro de diário

Há dois ficheiros especialmente importantes na pasta do utilizador para arranque do programa e diagnóstico de eventuais erros:

• o ficheiro de configuração: <pasta do utilizador>/etc/ancestris.conf define as configurações de arranque;

Caso o Ancestris tenha problemas em detectar a versão Java, pode editar o ficheiro de configuração presente na pasta de instalação: <pasta de instalação do Ancestris>/etc/ancestris.conf

• o ficheiro de diário: <pasta do utilizador>/ancestris/ancestris.log armazena todos os avisos e mensagens de erro que ocorrem enquanto utiliza o Ancestris.

Aqui também estão localizadas as suas preferências e modelos personalizados:

• as suas preferências : <pasta do utilizador>/ancestris/config
• os seus modelos pessoais : <pasta do utilizador>/ancestris/blueprints
• os seus almanaques : <pasta do utilizador>/ancestris/almanac
• os seus modelos de registo individual e familiar : <pasta do utilizador>/ancestris/gedart
• o seu histórico de modificações : <pasta do utilizador>/var/cache/ModificationsHistory

Consulte o manual do utilizador para saber para que servem esses modelos.

Descrição detalhada

~/.ancestris/trunk	Pasta do utilizador
ancestris	Modelos definidos pelo utilizador
almanac	Almanaques para a visualização cronológica e para relatórios cronológicos.
blueprints	Plantas disponíveis para exibir informações de genealogia na árvore dinâmica, editor Gedcom, etc.
gedart	Modelos padrão e modelos definidos pelo utilizador para o registo individual e familiar/relatório Gedart.
ancestris.log	Ficheiro de diário do Ancestris. É o ficheiro que o suporte do Ancestris pode precisar caso nos envie um erro. Pode definir o tamanho do diário nas preferências.
config	Preferências definidas pelo utilizador
Modules	Preferências do utilizador das extensões instaladas
Preferences	Preferências do utilizador de todas as vistas e ferramentas, excepto as das extensões instaladas
Toolbars	Configurações principais da barra de ferramentas
Windows2Local	Posição das janelas
shortcuts.html	Atalhos
etc
ancestris.conf	Ficheiro de configuração do Ancestris para configurações de arranque
modules	Extensões instaladas
update_tracking	Informações de actualização de extensões instaladas
var
cache
ModificationsHistory	Histórico de modificações de ficheiros Gedcom abertos pelo Ancestris
...	Informações temporárias armazenadas pelo Ancestris
log	Ficheiros de diário temporários

Ao reinstalar o Ancestris, os ficheiros de configuração do utilizador não são modificados, deverá poder executar a versão actualizada com todas as configurações anteriores.

No entanto, pode haver algumas mudanças na maneira como a nova versão usa algumas das configurações.
  - Se este for o caso, recomendamos que mantenha apenas as pastas ancestris, config, etc e ModificationsHistory.
  - Se tiver problemas com as janelas, recomendamos remover a pasta Windows2Local.

Desinstalar o Ancestris

Para desinstalar o Ancestris, basta eliminar as 2 pastas dos ficheiros de programa e os ficheiros de configuração do utilizador.