Trin-for-trin installation på MacOS

Denne side viser dig detaljeret, hvordan du trin-for-trin installerer Ancestris på din MacOS.

Her kommer et eksempel som forekom i januar 2021, installation af Ancestris version 11 på MacOS Catalina.

macOS-01.png

Disse trin indeholder følgende:

Skærmbillederne vist undervejs kan se lidt anderledes ud hos dig.

Special bemrækning til brugere af MacOS Big Sur: fælg trinene nedenfor og læs derefter den specifikke sektion i bunden af denne side.

 

Installation af Java

1. Fra MacOS skrivebord...

macOS-02.png

 
2. Åben en terminal og skriv "java -version"

Hvis Java ikke er installeret, vil et popop window foreslå at installere det. Klik "Mere Info...".

Hvis Java er installeret, kan du gå direkte til punkt 11.

macOS-03.png

 
3. Du er på Javas hjemmeside. Klik påon "JDK Download"

Vi kan se, at Java 15 foreslås. Lad os installere denne version, selvom vi anbefaler version 8 eller 11, som er langtidsversioner (se krævet opsætning).

macOS-04.png

 
4. Gå ned til "MacOS Installer" linjen og klik på ".dmg' filen
en-macOS-05.png

 

5. Klik på den grønne download knap.
macOS-06.png

 

6. Download starter, vent...
macOS-07.png

 

7. Download er færdig. Åben Download mappen for at se filen.
macOS-08.png

 

8. Dobbeltklik på JDK pakken.

macOS-09.png

 

9. JDK installerer. Følg trinene.

en-macOS-10.png

 

10. Installationen bør være i orden. Luk vinduet.

macOS-11.png

 

11. Skriv igen "java -version" i terminalen.

Følgende resultat bør komme frem og indikere, at Java 15 er installeret.

macOS-12.png

Your are now done with the Java installation. Let's install Ancestris now.

 

Installation af Ancestris

12. Gå til https://www.ancestris.org

macOS-13.png

 

13. Vælg menuen DOWNLOAD

macOS-14.png

 

14. Klik på Ancestris 11 knappen under MacOS.

en-macOS-15.png

 

15. Tillad downloads fra Ancestris hjemmesiden, hvis det er første gang du gør det.

macOS-16.png

 

16. Download starter. Det tager et par minutter.

macOS-17.png

 

17. Vent lidt længere... vi sagde et par minutter!!

macOS-18.png

 

18. Når installationen er færdig, flyt filerne til din slægts-mappe.

macOS-19.png

 

19. Det er bedre at placere Ancestris programmet i en separat mappe fra dine slægtsfiler.
  • Gem f.eks. Ancestris i mappen Dokumenter/Slægt.
  • Og du kan senere lægge dine datafiler i mappen Home/Public/Slægtsfiler

Placér ikke dine slægtsfiler i Dokumenter. Skrivebord eller Downloads mapperne eller i undermapper dertil. MacOS vil ikke lade dig se dem fra Ancestris på grund af et sikkerhedscheck for ikke-autoriserede programmer som Ancestris.

en-macOS-20.png

 

20. Vær sikker på, at du har fået den version, du forventede, klik på "Quick Look "Ancestris" fra contextmenuen.

macOS-21.png

 
21. Programpaneletburde fortælle dig version og dato.

macOS-22.png

 

22. Klik på 'Åben ancestris' eller gå tilbage til Slægtsmappen og klik på ikonet for at starte Ancestris.

macOS-23.png

 

 

Bekræftelse af sikkerhedscheck

23. Ancestris starter, men MacOS fortæller dig, at programmet kommer fra en uautoriseret udvikler. Ikke noget problem. Ancestris er et open-source-program og har ikke noget 'snavs. Lad os autorisere det.

macOS-24.png

 

24. Så til System Preferences

en-macOS-25.png

 

25. Klik på "Security & Privacy"

macOS-26.png

 

26. Klik på "Åben alligevel"

macOS-27.png

 

27. Hvis det er første gang du gør dette, bekræft med dit password.

macOS-28.png

 

28. Ja, du er sikker, klik på 'Åben'.

macOS-29.png

 

29. Endelig, Ancestris starter.

en-macOS-30.png

 

30. Du kan nu se velkomstvinduet.

macOS-31.png

 

31. Bemærk venligst, at du fra the application Menu kan tilgå opsætning og "Om Ancestris" panelet.

macOS-32.png

 

Genvej i dock-linjen

32. Lad os lave en genvej i Dock ved at klikke på Ancestrisikonet idockpanelet.

macOS-33.png

 

33. Vælg "Valg" og "Bevar i Dock".

macOS-34.png

 

34. Det var det. Ancestris er installeret og i Dock. Yessss!

en-macOS-35.png

 

 


 

Special note for brugere af MacOS Big Sur

There are additional steps for MacOS Bug Sur users, in case Ancestris does not start after the installation above:

  • It might be necessary to store Gedcom files in another folder than the 'Documents', 'Desktop' and 'Downloads' folders. For instance, you can use the "Public" folder.
    • Indeed, for security reasons, MacOS might prevent access to these folders by non-signed applications.
    • It can also happen that an error message "Wrong line n° null" is displayed when opening a Gedcom file that is placed under one of these folders.

 

  • It might be also necessary to specify the path to the java version in the ancestris configuration file. This is explained below.

Please follow these additional steps to specify the path to the java version in the ancestris configuration file:

Basic principles:
  • The configuration file is here : ${HOME}/Library/Application Support/ancestris/trunk/etc/ancestris.conf
  • Java's location is given by the following line command : /usr/libexec/java_home -V

These are the steps.

1. Open a terminal, and check and copy the location of the installed java version
  • Type /usr/libexec/java_home -V on ther command line and press Enter
  • You shoud see the path of the installed java version.
  • Select the line indicating the path, and click on the mouse to copy it in the clipboard. This line could be different in your case.
    • Here it is /Library/Java/JavaVirtualMachines/jdk-15.0.1.jdk/Contents/Home

en-force-java-path-01.png

2. Open the editor on the Ancestris configuration file
  • Type the following command:  nano ${HOME}/Library/'Application Support'/ancestris/trunk/etc/ancestris.conf

en-force-java-path-02.png

3. The nano editor opens and shows the content of the Ancestris configuration file

en-force-java-path-03.png

4. Add - or modify - the line that says jdkhome="" and paste the java path between the double quotes
  • Add the line if it does not exist
  • Or update it otherwise. Make sure in this case that there is no pond sign "#" at the beggining of the line, your change would not be taken into account.

en-force-java-path-04.png

5. Exit and save your change

en-force-java-path-05.png

6. Check that the Ancestris configuration file has your change, and start Ancestris.
  • Type the command starting with "cat ${home}/..." below.
  • The terminal displays the configuration file with the added line.

en-force-java-path-06.png

The configuration file is updated. You can start Ancestris and Ancestris should find java.