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 - **Ancestris działa ze wszystkimi wersjami Javy wymienionymi na górze tej strony.** - Ancestris jest kompilowany z użyciem wersji 8 dla lepszej kompatybilności z większością użytkowników. - Ancestris był testowany z kilkoma wersjami typu LTS (Long Term Support – długoterminowe wsparcie). - Nie testujemy systematycznie Ancestris z wersjami krótkoterminowymi (Short Term), ponieważ szybko stają się przestarzałe i nie można ich pobrać po 18 miesiącach, ale niektórzy użytkownicy regularnie potwierdzają, że Ancestris działa poprawnie ze wszystkimi wersjami Javy. - Jeśli na Twoim systemie jest dostępna działająca wersja Javy, **Ancestris ją znajdzie bez konieczności jakiejkolwiek konfiguracji**. - W przeciwnym razie możesz [zainstalować Javę](https://docs.ancestris.org/link/902#bkmrk-install-java) od dowolnego dostawcy. Użytkownicy najczęściej wybierają pobranie jej z [Adoptium](https://adoptium.net/), ponieważ jest to najłatwiejsze. - Aby sprawdzić, czy Java jest zainstalowana w Twoim systemie, wykonaj [te instrukcje](https://docs.ancestris.org/link/902#bkmrk-identify-which-java-). - Jeśli Ancestris nie uruchamia się mimo zainstalowanej Javy, sprawdź sekcję [Rozwiązywanie problemów](https://docs.ancestris.org/link/902#bkmrk-troubleshooting) - Możesz mieć zainstalowanych kilka wersji Javy na swoim systemie. Aby wskazać Ancestris, której wersji ma używać, musisz: - albo zaktualizować plik konfiguracyjny Ancestris. W tym celu postępuj według [tych instrukcji](https://docs.ancestris.org/link/902#bkmrk-identify-which-java--0). - albo zmienić domyślną wersję Javy. W tym celu postępuj według [tych instrukcji](https://docs.ancestris.org/link/902#bkmrk-using-several-java-v). ## Instalacja JavaProstym sposobem na uzyskanie oficjalnej wersji Javy jest pobranie jej ze strony [Adoptium.net](https://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 ``` - **Jeśli zobaczysz komunikat o błędzie** w terminalu, oznacza to, że Java nie jest zainstalowana na Twoim systemie. Ancestris nie może działać. Proszę postępować zgodnie z [sekcją instalacji](https://docs.ancestris.org/link/902#bkmrk-install-java) powyżej, aby zainstalować Javę. - **Jeśli zobaczysz coś takiego, jak poniżej, gdzie wyświetlana jest wersja Javy**, oznacza to, że Java jest zainstalowana z wskazaną wersją. Możesz mieć zainstalowane kilka wersji, ale ta wersja będzie tą, którą Ancestris znajdzie, chyba że skonfigurowałeś Ancestris, aby działało inaczej. ``` 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](https://docs.ancestris.org/link/902#bkmrk-identify-which-java--0), 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](https://docs.ancestris.org/link/902#bkmrk-using-several-java-v) na swoim systemie. - Domyślna wersja Javy to ta, która pojawia się po wpisaniu komendy `java -version`, jak pokazano w poprzedniej sekcji. Jest to wersja, której Ancestris użyje, jeśli plik konfiguracyjny Ancestris nie istnieje lub nie zawiera instrukcji wskazującej, gdzie znaleźć Javę. ##### 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. - Bez względu na system operacyjny, który używasz, otwórz okno terminala. - Przejdź do katalogu aplikacji, który nazywa się `ancestris/bin` - Uruchom Ancestris ręcznie, wpisując: - `./ancestris` na macOS lub Linux, - `ancestris.exe` lub `ancestris64.exe` na Windows - Okno terminala wyświetli, co się dzieje. - Prześlij nam wyświetlaną odpowiedź (log). ## Aktualizacja pliku konfiguracyjnego AncestrisMusisz się tym zająć tylko wtedy, gdy Java jest zainstalowana, ale Ancestris nie uruchamia się.
Musisz zaktualizować [plik konfiguracyjny Ancestris](https://docs.ancestris.org/books/podrecznik-uzytkownika/page/pliki-oprogramowania-i-pliki-ustawien-uzytkownika "Pliki oprogramowania i pliki ustawień użytkownika"), aby wskazać, gdzie Ancestris powinien szukać Javy, jeśli aplikacja nie może jej znaleźć. Zasada jest następująca: - Jeśli istnieje plik konfiguracyjny, który zawiera parametr `jdkhome` wskazujący, gdzie znaleźć Javę, Ancestris użyje odpowiedniej wersji Javy. W przeciwnym razie Ancestris użyje domyślnej wersji Javy, wskazanej w poprzedniej sekcji.{{@904#bkmrk-ancestris-uses-two-c}}
Sprawdź [tutaj](https://docs.ancestris.org/books/podrecznik-uzytkownika/page/pliki-oprogramowania-i-pliki-ustawien-uzytkownika "Pliki oprogramowania i pliki ustawień użytkownika"), 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: -