# Krok po kroku instalacja na systemie macOS

Ta strona dokumentuje szczegółową instalację Ancestris na systemie macOS.

<p class="callout info">Pokażemy przykład, który miał miejsce w marcu 2024 roku, instalacji wersji 12 Ancestris na macOS Sonoma.</p>

[![A-Intro-01.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/a-intro-01.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/a-intro-01.png)

## Instalacja Javy

##### 1. Z pulpitu macOS...

[![A-Intro-02.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/a-intro-02.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/a-intro-02.jpg)

##### 2. Otwórz terminal i wpisz „java -version”, aby sprawdzić, czy Java jest już zainstalowana.

[![B-JAVA-02.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-02.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-02.png)

Jeśli Java jest zainstalowana, odpowiedź wskaże, że Java została znaleziona i poda numer wersji. W tym przypadku zainstalowana jest wersja 17.  
W takim przypadku wszystko jest w porządku,[ przejdź do kroku 5](https://docs.ancestris.org/link/898#bkmrk-installation-of-ance), aby zainstalować Ancestris.

[![B-JAVA-04.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-04.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-04.png)

Jeśli Java nie jest zainstalowana, odpowiedź wskaże, że Java nie może zostać znaleziona.  
W takim przypadku zainstaluj ją, postępując zgodnie z następującymi krokami.

[![B-JAVA-03.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-03.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-03.png)

##### 3. Zainstaluj Javę, przechodząc na stronę internetową [Adoptium](https://adoptium.net/).

Tutaj Adoptium sugeruje zainstalowanie wersji LTS (Long Term Support) Java 21 dla macOS.

[![B-JAVA-05.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-05.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-05.png)

**Kliknij przycisk „Latest LTS Release”**. Powinieneś teraz zobaczyć tę stronę.

Uwaga: Jeśli chcesz zainstalować inną wersję, kliknij przycisk „Other platforms and versions”.

[![B-JAVA-06.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-06.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-06.png)

Pobieranie zostało rozpoczęte... Kliknij przycisk pobierania w swojej przeglądarce i poczekaj.

[![B-JAVA-07.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-07.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-07.png)

Po krótkiej chwili pobieranie zostanie zakończone.

[![B-JAVA-08.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-08.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-08.png)

Uruchom pakiet JDK z tego okna pobierania. Powinno pojawić się okno instalacji.

[![B-JAVA-10.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/4QJb-java-10.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/4QJb-java-10.png)

Kliknij „Continue”.

[![B-JAVA-11.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-11.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-11.png)

Kliknij „Continue”.

[![B-JAVA-12.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-12.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-12.png)

Kliknij „Agree”.

[![B-JAVA-13.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-13.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-13.png)

Kliknij „Install”.

[![B-JAVA-14.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-14.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-14.png)

Zweryfikuj za pomocą odcisku palca lub podaj hasło do swojego Maca.

[![B-JAVA-15.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-15.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-15.png)

Instalacja rozpoczyna się.

[![B-JAVA-16.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-16.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-16.png)

Instalacja została zakończona. Zostanie wyświetlona informacja o miejscu, w którym została zainstalowana. Kliknij „Close”.

[![B-JAVA-17.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-17.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-17.png)

Na koniec zostaniesz poproszony o zachowanie lub przeniesienie pakietu instalacyjnego do kosza. Zrób to, co uważasz za stosowne.

##### 4. Sprawdź, czy Java jest teraz widoczna w oknie Terminala.

Wpisz „java -version”.

[![B-JAVA-18.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-18.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-18.png)

Powinien pojawić się następujący wynik, który wskazuje, że Java 21 jest zainstalowana.

[![B-JAVA-19.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/b-java-19.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/b-java-19.png)

Teraz zakończyłeś instalację Javy. Przejdźmy teraz do instalacji Ancestris.

## Instalacja Ancestris

##### 5. Przejdź na stronę [https://www.ancestris.org](https://www.ancestris.org).

[![C-Ancestris-01-en.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-01-en.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-01-en.jpg)

W menu kliknij na „POBIERANIE”.

[![C-Ancestris-02-en.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-02-en.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-02-en.jpg)

Zostaniesz przeniesiony do sekcji pobierania na stronie.

[![C-Ancestris-03-en.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-03-en.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-03-en.jpg)

Kliknij przycisk Ancestris 13 w kolumnie macOS. Wersja 13 jest najnowszą wersją od czerwca 2024 roku.

[![C-Ancestris-04-en.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-04-en.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-04-en.jpg)

Pobieranie się rozpoczęło. Kliknij przycisk pobierania w swojej przeglądarce, aby zobaczyć pasek postępu i poczekaj.

[![C-Ancestris-05.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-05.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-05.png)

Po zakończeniu pobierania powinieneś zobaczyć, że pakiet Ancestris ma około 94 MB.

[![C-Ancestris-06.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-06.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-06.png)

Uruchom go z tego okna popup, klikając małą ikonę „Open”.

[![C-Ancestris-07.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-07.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-07.png)

Powinno pojawić się okno instalacji Ancestris.

[![C-Ancestris-08.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-08.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-08.png)

Kliknij "Continue".

[![C-Ancestris-09.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-09.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-09.png)

Kliknij "Install".[![C-Ancestris-10.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-10.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-10.png)Zweryfikuj za pomocą odcisku palca lub podaj hasło do swojego Maca.

[![C-Ancestris-11.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-11.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-11.png)

Instalacja postępuje...

![C-Ancestris-12.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-12.png)Instalator poprosi o twoje pozwolenie na umieszczenie plików na twoim komputerze. Naciśnij „Allow”.

[![C-Ancestris-13.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-13.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-13.png)

Instalacja kończy się szybko. Naciśnij „Close”.

[![C-Ancestris-14.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-14.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-14.png)

Na koniec zostaniesz poproszony o zachowanie lub przeniesienie pakietu instalacyjnego do kosza. Zrób to, co uważasz za stosowne.

##### 6. Uruchom Ancestris z ekranu Launchpad.

Na ekranie Launchpad Ancestris powinien pojawić się wśród innych aplikacji. Uruchom go.

[![C-Ancestris-15.png](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-15.png)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-15.png)

Ancestris się uruchamia.

[![C-Ancestris-16.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-16.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-16.jpg)

Główne okno Ancestris pojawi się na ekranie. Instalacja została zakończona.

[![C-Ancestris-17.jpg](https://docs.ancestris.org/uploads/images/gallery/2024-03/scaled-1680-/c-ancestris-17.jpg)](https://docs.ancestris.org/uploads/images/gallery/2024-03/c-ancestris-17.jpg)

Język interfejsu powinien automatycznie zostać ustawiony na język systemowy.

Gratulacje!

---

## Uwaga specjalna dla użytkowników korzystających z wersji macOS starszych niż 10.14.4:

Jeśli nie możesz zaktualizować swojej wersji macOS do tego poziomu, będziesz musiał uruchomić Ancestris ręcznie, korzystając bezpośrednio ze skryptu Ancestris, który znajduje się tutaj:` /Applications/Ancestris.app/Contents/Resources/ancestris/bin/ancestris`

Jeśli uruchamiasz Ancestris ręcznie, nie będziesz mógł odczytywać ani zapisywać plików znajdujących się w folderach Documents, Desktop oraz Downloads ze względu na ograniczenia bezpieczeństwa Apple — nawet jeśli Ancestris jest podpisany i zatwierdzony (notarized) na platformie Apple. Alternatywnie możesz przechowywać swoje pliki w folderze **/Public**.

Istnieją dwa sposoby ręcznego uruchomienia Ancestris.

Najpierw upewnij się, że Java i Ancestris zostały zainstalowane zgodnie z instrukcjami zawartymi na tej stronie. Następnie skorzystaj z jednej z poniższych dwóch opcji.

### Z Findera

- Otwórz **Finder**.
- Przejdź do folderu **/Applications**.
- Znajdź aplikację **Ancestris.app**.
- Kliknij prawym przyciskiem myszy i wybierz „Pokaż zawartość pakietu” (Show Package Contents).
- Wejdź do folderu **Contents**.
- Następnie przejdź do folderu **Resources**.
- Otwórz folder **ancestris**, a potem **bin**.
- Powinieneś zobaczyć plik o nazwie **ancestris**. Kliknij go dwukrotnie.
- Otworzy się okno terminala i Ancestris zostanie uruchomiony.

### Z terminala

- Otwórz **Terminal**.
- Wpisz polecenie `cd /Applications/Ancestris.app/Contents/Resources/ancestris/bin` Aby przejść do katalogu **bin** (gdzie przechowywane są pliki binarne)
- Wpisz `./ancestris`
- Ancestris powinien się uruchomić. Jeśli jednak program nie startuje, proszę wyślij nam tekst, który pojawi się w terminalu po wykonaniu powyższego polecenia.