Skip to main content

Instalação JAVA

O Ancestris needsprecisa de Java ande isé compatiblecompatível withcom Java 8 (alsotambém calledchamado de 1.8) ande Java 11. WeRecomendamos recommendque youvocê use Java 88..

IfSe o Ancestris doesnão not startiniciar, orou showsmostrar thea tela inicial do Ancestris splashe screenparar, andgeralmente stops,está itrelacionado isa mostum generallyproblema relatedcom toa aninstalação issuedo withJava. theO Java installation.não Eitherestá Javainstalado isou noto installedAncestris não o encontra, encontra uma versão incompatível orou Ancestrisencontra doesuma notversão find it or finds an incompatible version or finds a corrupted versioncorrompida.

The following sections offer a step-by-step check to ensure Ancestris is using a valid Java 8 version.

 

IdentifyIdentifique whichqual versão do Java versionestá isconfigurada setpor by defaultpadrão

IfSe youvocê don'tnão knowsouber ifse o Java isestá installedinstalado orou whichqual versionversão isestá installed,instalada, please visit the official detailed explanation page or directly openvisite a commandpágina linede explicação detalhada oficial ou abra diretamente um terminal andde typelinha onde thecomando commande line:digite na linha de comando:

java -version

ThereExistem aremétodos alternativealternativos methods forpara MacOS ande Windows.
   - forpara MacOSsistemas systems,MacOS, checkverifique theas step-by-stepinstruções instructionspasso a passo.
   - forpara Windowssistemas systems,Windows, checkverifique theas step-by-stepinstruções instructionspasso a passo.

 

  • IfSe youvocê seevir anuma errormensagem messagede erro in theno terminal, theno Java isnão notestá installedinstalado onno yourseu system.sistema. Ancestris cannotnão run.pode Pleaseser executado. followSiga thea Installseção sectionInstalar belowabaixo topara installinstalar o Java 1.8 ande, thenem startseguida, inicie o Ancestris.

 

  • IfSe youvocê seevir somethingalgo likeassim thisem whereque o Java 1.8 isé displayedexibido, itsignifica meansque youvocê havetem thea properversão versioncorreta installedinstalada ande setdefinida bypor default.padrão.
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)

AccordingDe toacordo thecom displaya above,exibição weacima, canpodemos seever thatque thea installedversão Java versioninstalada setdefinida bypor defaultpadrão isé versiona versão 1.8, akatambém versionconhecida como versão 8.

IfSe o Ancestris doesnão notiniciar, start, eithero Ancestris doesnão noto findencontra, itencontra uma versão incompatível orou findsencontra anuma incompatibleversão version or finds a corrupted versioncorrompida. PleaseSiga followas theinstruções instructionspara toidentificar identifyqual whichversão Java versiono Ancestris findsencontra.

 

  • IfSe youvocê seevir auma differentversão Java versiondiferente fromda 1.8 orou 11,11, itsignifica meansque youvocê havetem anotheroutra versão Java versionpor by default.padrão.
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)

AccordingDe toacordo thecom displaya above,exibição weacima, canpodemos seever thatque thea installedversão Java versioninstalada setdefinida bypor defaultpadrão isé versiona versão 10. O Ancestris willnão notserá run. Pleaseexecutado. followSiga thea Installseção sectionInstalar belowabaixo topara installinstalar o Java 8. 

OnceDepois done,de youconcluído, willvocê thenterá havevárias severalversões Java versionsinstaladas installedno onseu your system.sistema.

IfSe youvocê aredeseja happydefinir to seto Java 8 como a versão padrão, siga as theinstruções defaultpara version,definir pleasea follow the instructions to set the defaultversão java version onpadrão yourno systemseu andsistema thene startinicie o Ancestris.

IfSe youvocê wouldpreferir rathermanter keepa theversão Java versiondefinida, seté necessário dizer ao Ancestris para não usar a versão Java padrão. Siga as itinstruções is,para thenforçar you need to tello Ancestris to not use the default Java version. Please follow the instructions to force Ancestris to use a specificusar uma versão java versionespecífica ande, thenem startseguida, inicie o Ancestris.

 

Identify which Java version Ancestris finds

To know which Java version Ancestris finds, you will need to check the Ancestris configuration file.

1. Check the line defining default_options

This line should look like this:

default_options="--branding ancestris -J-Xms96m -J-Xmx1g --laf javax.swing.plaf.nimbus.NimbusLookAndFeel"

If one of the options in this line includes --jdkhome="/path/to/java, make sure the path specified in this option is the path to Java version 1.8. Otherwise, edit the configuration file and change it. Then launch Ancestris.

If this line does not include a java path, follow the instructions below.

2. Check the line defining jdkhome

If the line looks like jdkhome="/path/to/java", then make sure the path specified in this option is the path to Java version 8. Otherwise, edit the configuration file and change it. Then launch Ancestris.

If the line starts with "#", or if the line does not exist, then it means the line is not used by Ancestris and that Ancestris uses the default Java version set on your system.

If the default version checked above was Java 8, it means your installed Java 8 version might be corrupted. Try reinstalling it using the Install instructions and restart Ancestris.

 

Install Java

To install version Java 8 on your system, you can get it from the Oracle's main page, or more precisely, directly from the download page.

  • If you need to know if your device can run Java, go to this configuration page to learn the minimum needed configuration.

 

 

  • If you prefer an Open Source Java version, it is possible to use OpenJDK and you can also install Java from the free AdoptopenJDK solution.

 

Set the default Java version

The procedures depend on your operative system.

 

Set default version for MacOS

The version of Java running on your system may be incompatible with Ancestris, so it will not run. You will get a message like the following in a terminal when Ancestris starts.

Swap 01.png

If you want to keep your current Java version and, for instance, run Java Version 8 (aka 1.8) at the same time, you need to swap Java versions.

To swap between different Java versions, open a Terminal window and follow the steps below.

In the following example, the instructions let you set Version 8 (aka 1.8) by default, without removing Java Version 10:

1/6 - Check which version of Java is set by default

java -version
echo $jdkhome

Swap 02.png

We can see Version 10. Ancestris will not work. You need Version 8 (aka 1.8) for Ancestris.

2/6 - Get a list of all installed versions on your system and check Version 8 (aka 1.8) is among them

/usr/libexec/java_home -V

Swap 03.png

OK, we can see Version 8 (aka 1.8) is installed.
If it were not, then install it as explained in this section.

3/6 - Type in the following 2 lines in the 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

These two lines will add the command to set your default Java version in your personal profile.

Swap 04.png

The first line defines the default Java version for all programs (JAVA_HOME, in uppercase).

The second line defines the default Java version to use for Ancestris (jdkhome, lowercase).

4/6 - Close the Terminal

exit

5/6 - Reopen a Terminal and check that the running Java is Version 8 (aka 1.8)

java -version
echo $jdkhome

Swap 05.png

OK, it is. We can see Version 8 (aka 1.8). You can now start Ancestris.

6/6 - Start Ancestris

Swap 06.png

When Ancestris starts, a Terminal window opens at the same time.

You can see in the title bar that Version 8 (aka 1.8) of Java is being used by Ancestris.

 

Set default version for Windows

You have to create a BAT file per Java version you wish to keep.

Use your favourite text editor to create those files, using the code below, and place them in a folder available from your 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

While creating these files, make sure you specify the correct name for the Java files for the lines JAVA_HOME, depending on your Java installation

When you decide to change the Java version, just run the corresponding BAT file: JAVA8 for version 1.8, or JAVA11 for version 11. The Java version at use will be shown on the terminal.

To check if the change is really in effect, type java -version on a console or check this page.

If you wish to keep your latest Java version and force the use of another version of Java for Ancestris, you have to change the configuration file, line jdkhome="C:\path\to\java"

 

Set default version for Linux

Type the following on a console :

sudo update-alternatives --config java

 

en_linux-java-versions.png

Select from the list the version needed.

If you wish to keep your latest Java version and force the use of another version of Java for Ancestris, you have to change the configuration file, line jdkhome="/path/to/java"

To get help using this tool :

sudo update-alternatives -l

 

 

Force Ancestris to use a specific Java version

Whatever your operating system is, if the default active Java version is different from the one to be used with Ancestris, you have to modify Ancestris's configuration file like this:

jdkhome="/path/to/java"

 

 

 

Back to top