Instalacja Java

Ancestris wymaga Javy i jest kompatybilny z wersjami Java od 8 do 21.

Jeśli Ancestris się nie uruchamia albo pokazuje ekran powitalny i się zatrzymuje, najczęściej jest to związane z problemem z instalacją Javy. Może to oznaczać, że Java nie jest zainstalowana, Ancestris jej nie znajduje, znajduje niekompatybilną wersję lub uszkodzoną instalację.

Poniższe sekcje zawierają instrukcje krok po kroku, które pozwolą upewnić się, że Ancestris korzysta z prawidłowej wersji Javy.


Zasada ogólna

Instalacja Java

Prostym sposobem na uzyskanie oficjalnej wersji Javy jest pobranie jej ze strony Adoptium.net

Jeśli Java nie jest zainstalowana lub jeśli chcesz najnowszą albo konkretną wersję Javy, po prostu pobierz ją ze wspomnianej wyżej strony.


Zidentyfikuj, czy Java jest już zainstalowana:

Jeśli nie wiesz, czy Java jest zainstalowana, ani która wersja jest zainstalowana, otwórz terminal wiersza poleceń i wpisz polecenie:

java -version
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)

Zgodnie z powyższym wyświetlaniem, możemy zobaczyć, że zainstalowana wersja Javy ustawiona domyślnie to wersja 1.8, czyli wersja 8.

Jeśli masz zainstalowaną wersję Javy, jak w przykładzie powyżej, i chcesz jej używać, możesz zignorować resztę tej strony.


Rozwiązywanie problemów

Jeśli Java jest zainstalowana, a Ancestris się nie uruchamia, oznacza to, że Ancestris nie może znaleźć Javy, znalazł niekompatybilną wersję lub wersja jest uszkodzona.

Niezależnie od tego, czy masz zainstalowaną tylko jedną wersję Javy, czy kilka, będziesz musiał sprawdzić i ewentualnie zaktualizować plik konfiguracyjny, aby wskazać Ancestris, gdzie szukać Javy.

Zamiast zmieniać plik konfiguracyjny Ancestris, jeśli masz zainstalowane kilka wersji Javy, alternatywnie możesz zmienić domyślną wersję Javy na swoim systemie.

W razie wątpliwości, proszę uruchomić Ancestris ręcznie z okna terminala i wysłać nam odpowiedź (log), która pojawi się na ekranie.


Aktualizacja pliku konfiguracyjnego Ancestris 

Musisz się tym zająć tylko wtedy, gdy Java jest zainstalowana, ale Ancestris nie uruchamia się.

Musisz zaktualizować plik konfiguracyjny Ancestris, aby wskazać, gdzie Ancestris powinien szukać Javy, jeśli aplikacja nie może jej znaleźć.

Zasada jest następująca:

Ancestris używa dwóch plików konfiguracyjnych, oba o nazwie ancestris.conf:
1/ Pierwszy z nich to plik konfiguracyjny aplikacji, który jest częścią katalogu aplikacji i jest tworzony podczas instalacji Ancestris.
2/ Drugi to plik konfiguracyjny użytkownika, który jest częścią katalogu użytkownika i jest tworzony, gdy zmienisz jakieś ustawienia preferencji podczas korzystania z Ancestris.

Plik konfiguracyjny użytkownika ma pierwszeństwo przed plikiem konfiguracyjnym aplikacji. 

Dlatego plik konfiguracyjny, który należy sprawdzić i zaktualizować, to plik konfiguracyjny użytkownika, jeśli istnieje, a w przeciwnym razie plik konfiguracyjny aplikacji.
- Jeśli instalujesz Ancestris, prawdopodobnie będziesz musiał zaktualizować plik konfiguracyjny aplikacji.
- Jeśli już korzystałeś z Ancestris i chcesz zmienić wersję Javy, prawdopodobnie będziesz musiał zaktualizować plik konfiguracyjny użytkownika

Sprawdź tutaj, gdzie znajduje się plik konfiguracyjny w zależności od twojego systemu.


Ścieżka do Javy w pliku konfiguracyjnym

Otwórz plik konfiguracyjny za pomocą zwykłego edytora tekstu.

1. Sprawdź linię definiującą default_options

Linia ta powinna wyglądać następująco:

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

Jeśli jedna z opcji w tej linii zawiera --jdkhome="/path/to/java, upewnij się, że ścieżka określona w tej opcji wskazuje na wersję Javy, którą chcesz używać.

Jeśli ta linia nie zawiera ścieżki do Javy, spróbuj znaleźć opcję jdkhome w innym miejscu.

2. Sprawdź linię definiującą jdkhome

Jeśli linia wygląda jak jdkhome="/path/to/java", upewnij się, że ścieżka wskazuje na wersję Javy, którą chcesz używać.

Jeśli linia zaczyna się od "#", to jest to komentarz, który Ancestris zignoruje, jakby go nie było.

Jeśli Ancestris się nie uruchamia, może to oznaczać, że nazwa folderu jdkhome jest źle napisana lub wskazuje na nieprawidłową wersję Javy.

Bez względu na system operacyjny, jeśli domyślna aktywna wersja Javy różni się od tej, która ma być używana z Ancestris, należy zmodyfikować linię jdkhome w ten sposób:

jdkhome="/path/to/java"

Przypadek macOS

Dla macOS, jeśli na przykład Java 21 i Java 17 są zainstalowane na twoim Macu, a chcesz wymusić użycie Java 17 dla Ancestris, pełna operacja, aby wymusić wersję Javy, wyglądałaby następująco:

Przypadek Windows i Linux

Możesz użyć polecenia echo %JAVA_HOME% aby sprawdzić gdzie zainstalowana jest Java.

Dla systemu Windows lub Linux, na przykład, jeśli plik wykonywalny Java znajduje się w lokalizacji /usr/java/jdk1.8.0_291-amd64/bin/java, należy pisać:

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

Uwaga: należy wykluczyć bin/java w opisie ścieżki.

Zmienianie domyślnych wersji Javy, gdy zainstalowane są różne wersje

Jeśli na twoim systemie zainstalowane są różne wersje Javy i chcesz zmienić wersję, którą będzie używać Ancestris, procedura zmiany zależy od twojego systemu operacyjnego.


Zamiana domyślnej wersji na macOS

Aby przełączyć między różnymi wersjami Java, otwórz okno terminala i postępuj zgodnie z poniższymi krokami.

W poniższym przykładzie instrukcje pozwolą ustawić wersję 8 (aka 1.8) jako domyślną, bez usuwania wersji Java 10:

1/6 - Sprawdź, która wersja Java jest ustawiona jako domyślna.

java -version
echo $jdkhome

Możesz sprawdzić, jaką wersję Javy aktualnie używasz.

2/6 - Uzyskaj listę wszystkich zainstalowanych wersji na swoim systemie i sprawdź, czy wersja 8 lub 11 jest jedną z nich.

/usr/libexec/java_home -V

Jeśli wersja, którą chcesz, nie znajduje się na liście, zainstaluj ją, jak wyjaśniono w tej sekcji.

Jeśli jest na liście, ale nie jest tą, która jest wymieniona wcześniej, wymuś ścieżkę do wersji Java za pomocą poniższego kroku.

3/6 - Wpisz poniższe 2 linie w Terminalu.

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

Te dwie linie dodadzą polecenie ustawiające domyślną wersję Java w Twoim osobistym profilu. Tutaj wymuszamy wersję 1.8 (lub 8). Zastąp ją swoją wersją Java.

Pierwsza linia definiuje domyślną wersję Java dla wszystkich programów (JAVA_HOME, wielkimi literami).

Druga linia definiuje domyślną wersję Java do użycia w Ancestris (jdkhome, małymi literami).

4/6 - Zamknij Terminal

exit

5/6 - Otwórz ponownie Terminal i sprawdź, czy uruchomiona wersja Java to teraz ta, którą chcesz (wersja 8 w naszym przykładzie).

java -version
echo $jdkhome

Teraz możesz uruchomić Ancestris.

6/6 - Uruchom Ancestris

Kiedy Ancestris się uruchomi, jednocześnie otworzy się okno Terminala.

Będziesz mógł zobaczyć w pasku tytułowym, że wersja 8 Java jest używana przez Ancestris.


Zamiana domyślnej wersji na Windows

Musisz utworzyć plik BAT dla każdej wersji Java, którą chcesz zachować.

Użyj swojego ulubionego edytora tekstu, aby stworzyć te pliki, używając poniższego kodu, a następnie umieść je w folderze dostępnym w zmiennej 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

Podczas tworzenia tych plików upewnij się, że określiłeś poprawną nazwę plików Java w liniach JAVA_HOME, w zależności od zainstalowanej wersji Java.

Kiedy zdecydujesz się zmienić wersję Java, wystarczy uruchomić odpowiedni plik BAT: JAVA8 dla wersji 1.8 lub JAVA11 dla wersji 11. Wersja Java, która jest używana, zostanie wyświetlona w terminalu.

Aby sprawdzić, czy zmiana została zastosowana, wpisz java -version w konsoli lub sprawdź tę stronę.

Zmień domyślną wersję dla systemu Linux

Wpisz poniższe polecenie w konsoli:

sudo update-alternatives --config java


en_linux-java-versions.png

Wybierz z listy potrzebną wersję.

Aby uzyskać pomoc przy używaniu tego narzędzia:

sudo update-alternatives -l


Revision #3
Created 9 May 2025 07:07:44 by frederic
Updated 11 May 2025 12:49:30 by Dawid