# Instalar o Ancestris Instale, reinstale ou actualize o Ancestris no MacOS, Windows e Linux. Pré-requisito Java. Localização dos arquivos, configurações de inicialização e configurações 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](http://www.gnu.org/copyleft/gpl.html "Mostrar a licença") 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-do-java "Instalação do JAVA"). - 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](http://www.java.com/pt_PT/ "Página do Java") instalado no seu sistema. O Ancestris é compatível com o [ **Java Version 8, 11, 17 e 18**](https://adoptium.net/ "Download Java"). 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-do-java "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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos "Instalação passo-a-passo em MacOS") ✔ [Instalação passo-a-passo da versão 11 em Windows](https://docs.ancestris.org/books/manual-do-utilizador/page/instalacao-passo-a-passo-da-versao-11-em-windows-639 "Instalação passo-a-passo da versão 11 em Windows") ✔ [Instalação passo-a-passo da versão 12 em Windows](https://docs.ancestris.org/books/manual-do-utilizador/page/instalacao-passo-a-passo-da-versao-12-em-windows "Instalação passo-a-passo da versão 12 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](https://www.ancestris.org/index_pt.html "Página do Ancestris"), menu TRANSFERIR. [![pt_ancestrissite.png](https://docs.ancestris.org/uploads/images/gallery/2020-05/scaled-1680-/pt_ancestrissite.png)](https://docs.ancestris.org/uploads/images/gallery/2020-05/pt_ancestrissite.png) ## Escolha a sua versão do Ancestris Duas versões estão disponíveis. - [Se aprecia a estabilidade de utilização](#bkmrk-etc... "Escolha a versão 11"), escolha a versão 11 e abdique dos derradeiros avanços no desenvolvimento. - Escolha a versão quotidiana 12 [se deseja beneficiar dos últimos desenvolvimentos](#bkmrk-pour-t%C3%A9l%C3%A9charger-la- "Escolha a versão 12") 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 11 Disponível desde o início de 2020 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 v11, propomos três opções, MacOS, WIndows e Linux. [![pt-download-ancestris.png](https://docs.ancestris.org/uploads/images/gallery/2021-05/scaled-1680-/pt-download-ancestris.png)](https://docs.ancestris.org/uploads/images/gallery/2021-05/pt-download-ancestris.png) - Clique no botão correspondente ao seu sistema operativo: - MacOS, - Windows, - ou Linux (paire com o rato sobre a palavra Linux para ver as distribuições disponíveis: Fedora, Redhat, Mandriva, Ubuntu, Mint, Debian, 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. [![en-version11.png](https://docs.ancestris.org/uploads/images/gallery/2021-05/scaled-1680-/en-version11.png)](https://docs.ancestris.org/uploads/images/gallery/2021-05/en-version11.png) ### Transferir a versão quotidiana 12 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 v12, que funciona igualmente bem em MacOS, Windows e Linux. [![pt-download-ancestris.png](https://docs.ancestris.org/uploads/images/gallery/2021-05/scaled-1680-/pt-download-ancestris.png)](https://docs.ancestris.org/uploads/images/gallery/2021-05/pt-download-ancestris.png) - 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. [![en-version-trunk.png](https://docs.ancestris.org/uploads/images/gallery/2021-05/scaled-1680-/en-version-trunk.png)](https://docs.ancestris.org/uploads/images/gallery/2021-05/en-version-trunk.png) ## 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 11 - **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__.rpm` ou `ancestris-11__.deb` para instalar o Ancestris e iniciar a aplicação obtida ### Versão quotidiana 12 **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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador") 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. [![pt_Accueil.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/pt_Accueil.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_Accueil.png) ## 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-do-java "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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos "Instalação passo-a-passo em MacOS") ✔ [Guia de instalação passo-a-passo da versão 11 para Windows](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-da-vers%C3%A3o-10-em-windows "Instalação passo-a-passo da versão 11 em Windows") ✔ [Guia de instalação passo-a-passo da versão 12 para Windows](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-da-vers%C3%A3o-11-em-windows "Instalação passo-a-passo da versão 12 em 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos-%28l%29 "Instalação passo-a-passo em MacOS (L)"). 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-da-vers%C3%A3o-11-em-windows "Instalação passo-a-passo da versão 11 em Windows"). 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](https://docs.ancestris.org/books/manual-do-utilizador/page/configura%C3%A7%C3%B5es-de-arranque "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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de 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 11 para a versão 12; - 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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador"). 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instalar-e-iniciar-o-ancestris-%28l%29 "Instalar e iniciar o Ancestris (L)"). 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. ## Mudar da versão 11 ou reinstalar Para reinstalar a versão principal, preservando as suas configurações, continue [faça uma instalação inicial normal](https://docs.ancestris.org/books/manual-do-utilizador/page/instalar-e-iniciar-o-ancestris-%28l%29 "Instalar e iniciar o Ancestris (L)"). 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 5 pastas descritas nas etapas a seguir. ## Mudar da versão 12 ou reinstalar Para actualizar da versão 11 para a versão 12, ou reinstalar a versão 12, preservando as suas personalizações: - feche o Ancestris, se estiver em execução; - [transfira a versão 12 dos nossos Ancestris servidores](https://www.ancestris.org/mw/mw-base/compteur_dl.php?/dl/pub/ancestris/dev/ancestris-latest.zip "Transfira a última versão") e descomprima o ficheiro ZIP; - 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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração 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. [![updates_popup.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/updates_popup.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/updates_popup.png) Se perder este balão, só aparece por alguns segundos, o pequeno ícone do globo [![pt_plugin_installer_popup_new.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/pt_plugin_installer_popup_new.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_plugin_installer_popup_new.png) 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. [![pt_plugin_installer.png](https://docs.ancestris.org/uploads/images/gallery/2020-11/scaled-1680-/pt_plugin_installer.png)](https://docs.ancestris.org/uploads/images/gallery/2020-11/pt_plugin_installer.png) Clique em Avançar e o Ancestris fará a transferência. Verá uma barra de progresso no canto inferior direito. [![pt_plugin_installer_download_progress.png](https://docs.ancestris.org/uploads/images/gallery/2020-11/scaled-1680-/pt_plugin_installer_download_progress.png)](https://docs.ancestris.org/uploads/images/gallery/2020-11/pt_plugin_installer_download_progress.png) Depois da transferência, o Ancestris pede a sua confirmação. [![pt_plugin_installer_signature.png](https://docs.ancestris.org/uploads/images/gallery/2020-11/scaled-1680-/pt_plugin_installer_signature.png)](https://docs.ancestris.org/uploads/images/gallery/2020-11/pt_plugin_installer_signature.png) Clique em Continuar e verá o mesmo balão oferecendo o reinício do Ancestris para concluir a actualização. [![pt_plugin_installer_popup_restart.png](https://docs.ancestris.org/uploads/images/gallery/2020-11/scaled-1680-/pt_plugin_installer_popup_restart.png)](https://docs.ancestris.org/uploads/images/gallery/2020-11/pt_plugin_installer_popup_restart.png) ## 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: [![pt_plugin_installer_no_updates.png](https://docs.ancestris.org/uploads/images/gallery/2020-11/scaled-1680-/pt_plugin_installer_no_updates.png)](https://docs.ancestris.org/uploads/images/gallery/2020-11/pt_plugin_installer_no_updates.png) Saiba mais sobre as actualizações ### Se utiliza a versão estável 10 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](#bkmrk-r%C3%A9cup%C3%A9ration-automat "Actualizar o Ancestris"). Estas actualizações são muito raras. ### Se usa a versão diária 11 Em relação à versão diária, 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](#bkmrk-r%C3%A9cup%C3%A9ration-automat "Actualizar o Ancestris"). #### Actualizações estruturais Em raras ocasiões, certas actualizações do Ancestris versão diária 11 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. [![pt_welcome_recent_updates.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/pt_welcome_recent_updates.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/pt_welcome_recent_updates.png) Como de costume, estas actualizações estarão disponíveis através das [actualizações automáticas](#bkmrk-r%C3%A9cup%C3%A9ration-automat "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](https://docs.ancestris.org/books/manual-do-utilizador/page/reinstalar-o-ancestris-ou-mudar-de-vers%C3%A3o "Reinstalar o Ancestris ou mudar de versã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 Janeiro de 2021, uma instalação da versão 11 do Ancestris em MacOS Catalina

[![macOS-01.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-01.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-01.png) As etapas são as seguintes: - **[Instalação do Java que ainda não esteja instalado no Catalina](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos#bkmrk-knowing-which-java-v "Instalação passo-a-passo em MacOS")**; - [Transferência da versão 11 do Ancestris a partir da página segura do Ancestris](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos#bkmrk-installation-of-ance "Instalação passo-a-passo em MacOS"); - [Confirmação da segurança para autorizar o arranque do Ancestris a seguir ao aviso do MacOS](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos#bkmrk-confirmation-of-the- "Instalação passo-a-passo em MacOS"); - **[Início do Ancestris](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos#bkmrk-28.-finally%2C-ancestr "Instalação passo-a-passo em MacOS")**; - **[Manter o Ancestris na Dock](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos#bkmrk-keep-in-dock "Instalação passo-a-passo em MacOS").** Queira notar que os ecrãs da Internet e da aplicação podem diferir dos que vê no seu computador. Nota especial para os utilizadores do MacOS Big Sur: - para a versão MacOS, poderá ser necessário especificar o caminho da versão Java no ficheiro de configuração do Ancestris ([ver a secção correspondente, se for o caso](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador")) - Por motivos de segurança ligadas ao mesmo assunto, poderá ser necessário colocar os ficheiros genealógicos Gedcom numa outra pasta que não a pasta "Documentos", ou poderão não ser abertos pelo Ancestris. ## Identificar a versão Java Estas etapas permitem identificar a versão Java em execução no seu sistema. ##### 1 - Abra o menu de ferramentas do MacOS. [![macOS-02.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-02.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-02.png) ##### 2 - Abra um terminal e insira "java -version" Se o Java não estiver instalado, verá uma janela que lhe propõe a instalação. Clique em "Mais informação...". Se o Java estiver instalado, passe directamente ao[ écran 11](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos#bkmrk-11.-then-type-again- "Instalação passo-a-passo em MacOS"). [![macOS-03.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-03.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-03.png) ##### 3 - Está agora na página web do Java. Clique em "JDK Download" Podemos observar que nos é proposto o Java 15. Instale essa versão, mesmo que nós sugiramos a versão 8 ou 11, que são as versões de longo termo ([ver a configuração requerida](https://docs.ancestris.org/books/manual-do-utilizador/page/instalar-e-iniciar-o-ancestris#bkmrk-%C2%A0-0 "Instalar e iniciar o Ancestris")) [![macOS-04.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-04.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-04.png) ##### 4 - Vá à linha "macOS installer" e clique no ficheiro ".dmg". [![macOS-05.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-05.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-05.png) ##### ##### 5 - Clique no botão verde para o transferir [![macOS-06.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-06.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-06.png) ##### ##### 6 - A transferência leva alguns minutos. Seja paciente... [![macOS-07.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-07.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-07.png) ##### ##### 7 - Quando terminada, abra a pasta de transferências e verifique a presença do ficheiro [![macOS-08.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-08.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-08.png) ##### ##### 8 - Clique no pacote JDK para o instalar [![macOS-09.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-09.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-09.png) ##### ##### 9 - Inicia-se a instalação do JDK do Java. Siga as etapas propostas [![macOS-10.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-10.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-10.png) ##### ##### 10 - As etapas deve concluir-se por si só. Quando assim for, feche a janela [![macOS-11.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-11.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-11.png) ##### ##### 11 - Volte ao terminal e repita "java -version" Deverá ver agora a versão do Java, de acordo com este exemplo, a versão 15. [![macOS-12.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-12.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-12.png) E estamos terminados com o Java. Passemos agora a instalar o Ancestris. ##### 12 - Vá à página [https://www.ancestris.org](https://www.ancestris.org/) [![macOS-13.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-13.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-13.png) ##### ##### 13 - No menu, clique em "Transferir". Será mostrada a área de transferências. [![macOS-14.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-14.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-14.png) ##### ##### 14 - Clique no botão **Ancestris 11** na secção **MacOS** [![macOS-15.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-15.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-15.png) ##### ##### 15 - Autorize a transferência a partir da página do Ancestris, se for a primeira vez que o faz [![macOS-16.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-16.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-16.png) ##### ##### 16 - A transferência inicia-se. Leva cerca de 2 minutos. [![macOS-17.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-17.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-17.png) ##### ##### 17 - Espere ainda mais um pouco. Nós dissemos 2 minutos... [![macOS-18.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-18.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-18.png) ##### ##### 18 - Uma vez terminada, mova o ficheiro para a sua pasta de genealogia [![macOS-19.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-19.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-19.png) Se transferiu a versão estável do Ancestris, clique no pacote Ancestris e ele instala-se na pasta Applications. Salte para o passo 29. Os passos 19 a 28 são para a versão diária do Ancestris, que não inclui um pacote de instalação. ##### 19 - É preferível colocar a aplicação Ancestris numa pasta diferente da dos ficheiros de dados [![macOS-20.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-20.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-20.png) ##### ##### 20 - Para garantir a versão correcta da aplicação, clique em "Quick Look "ancestris"", no menu contextual do ficheiro [![macOS-21.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-21.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-21.png) ##### ##### 21 - Verá a descrição da aplicação, com a respectiva versão e data [![macOS-22.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-22.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-22.png) ##### ##### 22 - Clique em "Abrir Ancestris" ou vá à pasta da aplicação e clique no ícone para a iniciar [![macOS-23.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-23.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-23.png) ### Confirmação do controlo de segurança ##### 23 - O Ancestris arranca, mas o MacOS dirá que não pode abrir a aplicação por o editor não estar verificado. O Ancestris é de código aberto e sem malware. Autorize o arranque. [![macOS-24.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-24.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-24.png) ##### ##### 24 - Para tal, vá às preferências do sistema [![macOS-25.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-25.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-25.png) ##### ##### 25 - Clique em "Segurança e Privacidade" [![macOS-26.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-26.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-26.png) ##### ##### 26 - Clique em "Abrir mesmo assim" [![macOS-27.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-27.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-27.png) ##### ##### 27 - Se é a primeira vez que faz este tipo de autorização, insira a sua senha [![macOS-28.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-28.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-28.png) ##### ##### 28 - Sim, tem a certeza. Clique em "Abrir" [![macOS-29.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-29.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-29.png) ##### ##### 29 - Enfim o Ancestris inicia [![macOS-30.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-30.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-30.png) ##### ##### 30 - Pode ver a janela de boas vindas [![macOS-31.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-31.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-31.png) ##### ##### 31 - Pode ver que, a partir do menu da aplicação, acede às preferências do Ancestris e ao diálogo "Acerca" [![macOS-32.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-32.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-32.png) ### Manter na Dock ##### 32 - Vamos agora fixar o Ancestris na barra de aplicações (Dock) [![macOS-33.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-33.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-33.png) ##### ##### 33 - Escolha "Opções" e "Manter na barra" [![macOS-34.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/macOS-34.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/macOS-34.png) ##### ##### 34 - E está feito! O Ancestris está instalado e acessível a partir da barra de aplicações! [![macOS-35.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/macOS-35.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/macOS-35.png) ### Nota especial para utilizadores do MacOS Big Sur [![en-Ancestris-MacOS-BigSur11-4.png](https://docs.ancestris.org/uploads/images/gallery/2021-07/scaled-1680-/en-ancestris-macos-bigsur11-4.png)](https://docs.ancestris.org/uploads/images/gallery/2021-07/en-ancestris-macos-bigsur11-4.png)

Desde Julho de 2021, a versão estável instala-se automaticamente na pasta Applications. Assim, a partir do passo 19 acima, tudo o que tem de fazer é clicar no pacote de instalação. Os restantes passos só são necessários para a versão 12.

Para a versão 12, há alguns passos adicionais para utilizadores do **MacOS Big Sur**, caso o Ancestris não inicie após a instalação acima: - pode ser necessáro armazenar os ficheiros Gedcom numa pasta diferente das "Documents", "Desktop" e "Downloads". Por exemplo, pode utilizar a pasta "Public"; - de facto, por razões de segurança, o MacOS pode impedir o acesso a estas pastas por aplicações não assinadas; - pode também acontecer que seja mostrada a mensagem de erro "Wrong line n° null" ao abrir um ficheiro Gedcom colocado numa destas pastas; - pode ainda ser necessário especificar o caminho da versão do Java no ficheiro de configuração do Ancestris. Isto está descrito abaixo. ##### Princípios básicos: - O ficheiro de configuração está aqui : `${HOME}/Library/Application Support/ancestris/trunk/etc/ancestris.conf` - A localização do Java é dada pelo seguinte comando: `/usr/libexec/java_home -V` Eis os passos. ##### 1. Abra um terminal e verifique e copie a localização do Java: - escreva /usr/libexec/java\_home -V na linha de comandos e prima Enter; - Deverá ver o caminho da versão Java instalada; - seleccione a linha indicando o caminho e copie-a para a memória. Pode ser diferente do exemplo abaixo. - Algo como isto: `/Library/Java/JavaVirtualMachines/jdk-15.0.1.jdk/Contents/Home` [![en-force-java-path-01.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/en-force-java-path-01.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/en-force-java-path-01.png) ##### 2. Abra o ficheiro de configuração do Ancestris no editor de texto: - Escreva o seguinte comando: `nano ${HOME}/Library/'Application Support'/ancestris/trunk/etc/ancestris.conf` [![en-force-java-path-02.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/en-force-java-path-02.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/en-force-java-path-02.png) ##### 3. Abre-se o editor nano e mostra o conteúdo do ficheiro de configuração do Ancestris [![en-force-java-path-03.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/en-force-java-path-03.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/en-force-java-path-03.png) ##### 4. Adicione - ou modifique - a linha que diz `jdkhome=""` e cole o caminho do Java entre as aspas: - Adicione a linha, se não existir; - Ou actualize-a. Certifique-se de remover o sinal de cardinal "#" no início da linha, ou a alteração não será tida em conta; [![en-force-java-path-04.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/en-force-java-path-04.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/en-force-java-path-04.png) ##### 5. Saia, gravando as alterações [![en-force-java-path-05.png](https://docs.ancestris.org/uploads/images/gallery/2021-02/scaled-1680-/en-force-java-path-05.png)](https://docs.ancestris.org/uploads/images/gallery/2021-02/en-force-java-path-05.png) ##### 6. Verifique se o ficheiro de configuração do Ancestris foi modificado e inicie o Ancestris: - insira o comando começado com "`cat ${home}/...`"abaixo. - O terminal mostra o ficheiro de configuração com a linha adicionada. [![en-force-java-path-06.png](https://docs.ancestris.org/uploads/images/gallery/2021-01/scaled-1680-/en-force-java-path-06.png)](https://docs.ancestris.org/uploads/images/gallery/2021-01/en-force-java-path-06.png)
O ficheiro de configuração está actualizado. Pode iniciar o Ancestris, que já deverá encontrar o Java. # Instalação passo-a-passo da versão 11 em Windows Esta página mostra passo-a-passo como instalar o Ancestris versão 10 num sistema Windows. ## Instalar o Ancestris versão 11 Siga as instruções abaixo. ##### 1/4 - Transferir o Ancestris - vá a [https://www.ancestris.org](https://www.ancestris.org "Site Ancestris"); - clique em Transferir no menu; - clique na palavra "WINDOWS"; - a transferência pode levar de 3 a 4 minutos, tem cerca de 139 Mb. [![pt-download-ancestris.png](https://docs.ancestris.org/uploads/images/gallery/2021-05/scaled-1680-/pt-download-ancestris.png)](https://docs.ancestris.org/uploads/images/gallery/2021-05/pt-download-ancestris.png) ##### ##### 2/4 - Faça duplo clique duas vezes no ficheiro transferido - O Ancestris 11 possui um assistente de configuração para Windows; [![Ancestris10Setup-pt-02.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-02.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-02.png) - clique em **Seguinte**; [![Ancestris10Setup-pt-03.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-03.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-03.png) - aceite o contrato e clique em **Seguinte**; [![Ancestris10Setup-pt-04.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-04.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-04.png) - escolha um caminho de instalação;

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

- clique em **Seguinte**; [![Ancestris10Setup-pt-05.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-05.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-05.png) - 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**; [![Ancestris10Setup-pt-06.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-06.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-06.png) - marque a caixa para criar um atalho na área de trabalho; - clique em **Seguinte;** [![Ancestris10Setup-pt-07.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-07.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-07.png) - clique em **Instalar;** [![Ancestris10Setup-pt-08.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-08.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-08.png) - o programa está instalado no seu computador; [![Ancestris10Setup-pt-09.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/Ancestris10Setup-pt-09.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/Ancestris10Setup-pt-09.png) - pode iniciar directamente a aplicação com a caixa "Executar o Ancestris" ##### 3/4 - Clique no atalho e o Ancestris é iniciado. [![pt_Ancestris_start.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Ancestris_start.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Ancestris_start.png) ##### 4/4 - Verá a página de boas vindas. Agora está tudo pronto para utilizar o Ancestris. [![pt_Accueil.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/pt_Accueil.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_Accueil.png) # Instalação passo-a-passo da versão 12 em Windows Esta página mostra como instalar 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. [![pt_Windows_Java_Control_Panel_About.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Windows_Java_Control_Panel_About.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Windows_Java_Control_Panel_About.png) No separador Security, desmarque a opção "Enable Java content for browsers and Web Start applications" para melhorar a segurança. [![pt_Windows_Java_Control_Panel_Security.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Windows_Java_Control_Panel_Security.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Windows_Java_Control_Panel_Security.png) ### 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.](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-do-java "Instalação do JAVA") ``` 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 o Ancestris versão 12 Siga as instruções abaixo no seu sistema Windows. ##### 1/6 - Transfira o Ancestris - Vá a [https://www.ancestris.org](https://www.ancestris.org/index_pt.html "Página do Ancestris"); - 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 12; - a transferência pode levar 2 ou 3 minutos, tem cerca de 100 MB. [![pt-download-ancestris.png](https://docs.ancestris.org/uploads/images/gallery/2021-05/scaled-1680-/pt-download-ancestris.png)](https://docs.ancestris.org/uploads/images/gallery/2021-05/pt-download-ancestris.png) ##### 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. [![pt_Windows_Ancestris_Extract.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Windows_Ancestris_Extract.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Windows_Ancestris_Extract.png) ##### 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. [![pt_Windows_Ancestris_Folder.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Windows_Ancestris_Folder.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Windows_Ancestris_Folder.png) ##### 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. [![pt_Windows_Ancestris_Shortcut.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Windows_Ancestris_Shortcut.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Windows_Ancestris_Shortcut.png) - 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. [![pt_Ancestris_start.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_Ancestris_start.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_Ancestris_start.png) ##### 6/6 - Verá a página de boas vindas. Agora está tudo pronto para utilizar o Ancestris. [![pt_Accueil.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/pt_Accueil.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_Accueil.png)

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.](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-do-java "Instalação do JAVA")

# 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.](https://www.java.com/p/download/help/version_manual.xml "Como encontrar a versão Java instalada") 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;](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-em-macos "Instalação passo-a-passo em MacOS") - para sistemas Windows, [veja as instruções passo-a-passo](https://docs.ancestris.org/books/manual-do-utilizador/page/instala%C3%A7%C3%A3o-passo-a-passo-da-vers%C3%A3o-11-em-windows "Instalação passo-a-passo da versão 11 em Windows").

- **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](#bkmrk-install-java "Instalar o Java") 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](#bkmrk-identify-which-java--0 "Identificar a versão Java"). - **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](#bkmrk-install-java "Instalar o Java") 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](#bkmrk-using-several-java-v "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](#bkmrk-forcing-ancestris-to "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](https://docs.ancestris.org/books/manual-do-utilizador/page/arquivos-de-software-e-arquivos-de-configura%C3%A7%C3%B5es-do-usu%C3%A1rio "Arquivos de software e arquivos de configurações do usuário") 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](https://docs.ancestris.org/books/manual-do-utilizador/page/instalar-e-iniciar-o-ancestris-%28l%29 "Instalar e iniciar o Ancestris (L)") 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](http://www.java.com/pt/ "Página Java.com") ou, mais precisamente, na [página de transferências](https://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html "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](https://www.oracle.com/java/technologies/javase-jre8-downloads.html "Versões disponíveis").

- Se precisa de **saber se o seu dispositivo pode executar o Java**, vá a esta [página de configuração](http://www.oracle.com/technetwork/java/javase/config-417990.html#os "Configuração requerida para executar o Java"): - 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;](https://docs.oracle.com/javase/8/docs/technotes/guides/install/mac_jre.html#CHDGECEB "Instalação do JRE 8 para MacOS") - [instalação do JRE para Windows](https://docs.oracle.com/javase/8/docs/technotes/guides/install/windows_jre_install.html#CHDEDHAJ "Instalação do JRE para Windows");. - [instalação do JRE para Linux](https://docs.oracle.com/javase/8/docs/technotes/guides/install/linux_jre.html "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:](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html "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](https://docs.oracle.com/en/java/javase/11/install/installation-jdk-macos.html#GUID-2FE451B0-9572-4E38-A1A5-568B77B146DE "Instalação do JDK em MacOS"); - [instalação do JDK para Windows](https://docs.oracle.com/en/java/javase/11/install/installation-jdk-microsoft-windows-platforms.html#GUID-A7E27B90-A28D-4237-9383-A58B416071CA "Instalação do JDK para Windows"); - [Instalação do JDK em Linux](https://docs.oracle.com/en/java/javase/11/install/installation-jdk-linux-platforms.html#GUID-737A84E4-2EFF-4D38-8E60-3E29D1B884B8 "Instalação do JDK em Linux"). Se **preferir uma versão Java de código aberto**, é possível usar o [OpenJDK](http://openjdk.java.net/ "OpenJDK") e também poderá instalar o Java a partir da solução gratuita [AdoptopenJDK](https://adoptopenjdk.net/ "AdoptopenJDK"). ## Pré-definir a versão Java - - - [Para MacOS](#bkmrk-set-the-default-java "Escolher a versão Java para MacOS") - [Para Windows](#bkmrk-swaping-java-version-0 "Escolher a versão Java para Windows") - [Para Linux](#bkmrk-swaping-java-version-1 "Escolher a versão Java 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. ![Swap 01.png](https://en.ancestris.org/images/4/47/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](#bkmrk-install-java "Instalar o Java"). **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](https://en.ancestris.org/images/f/fb/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](https://www.java.com/pt/download/help/version_manual.xml "Manual do Java"). 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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador"), linha `jdkhome="C:\caminho\para\o\java" ` ### Pré-definir a versão para Linux Digite o seguinte numa consola: ``` sudo update-alternatives --config java ``` [![en_linux-java-versions.png](https://docs.ancestris.org/uploads/images/gallery/2020-05/scaled-1680-/en_linux-java-versions.png)](https://docs.ancestris.org/uploads/images/gallery/2020-05/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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador"), 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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador") 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](https://docs.ancestris.org/books/manual-do-utilizador/page/ficheiros-de-programa-e-ficheiros-de-configura%C3%A7%C3%A3o-do-utilizador "Ficheiros de programa e ficheiros de configuração do utilizador"). ## 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](https://docs.ancestris.org/books/manual-do-utilizador/page/prefer%C3%AAncias "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](https://docs.ancestris.org/books/manual-do-utilizador/page/prefer%C3%AAncias "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](https://docs.ancestris.org/books/manual-do-utilizador/page/prefer%C3%AAncias "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**. [![pt_User_settings_icon1.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_User_settings_icon1.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_User_settings_icon1.png)
Clique em **Alterar definições de valor alto de PPP**.
[![pt_User_settings_icon2.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/pt_User_settings_icon2.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/pt_User_settings_icon2.png)
Defina a opção como **Sistema**, valide com OK e reinicie o Ancestris.
# 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 [![icon_about.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/icon_about.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/icon_about.png). Exemplo : [![pt_help_about.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/pt_help_about.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_help_about.png)

Esta **pasta do utilizador** depende do seu sistema operativo. - Windows : `C:\Users\[utilizador]\.ancestris\` - MacOS : `${HOME}/Library/Application Support/ancestris/` - Linux : `~/.ancestris/` Onde `` é 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**: `/etc/ancestris.conf` define as configurações de arranque; - **o ficheiro de diário**: `/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** : `/ancestris/config` - os seus **modelos pessoais** : `/ancestris/blueprints` - os seus **almanaques** : `/ancestris/almanac` - os seus **modelos de registo individual e familiar** : `/ancestris/gedart` - o seu **histórico de modificações** : `/var/cache/ModificationsHistory` Consulte o [manual do utilizador](https://docs.ancestris.org/books/manual-do-utilizador/page/modelos "Modelos") 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](https://docs.ancestris.org/books/manual-do-utilizador/page/prefer%C3%AAncias "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.