# Installazione di Java

Ancestris necessita di Java ed è compatibile con Java 8 fino a Java 18.

**Se Ancestris non si avvia** o mostra la schermata iniziale di Ancestris e si interrompe, in genere è dovuto a un problema con l'installazione di Java. Java non è installato oppure Ancestris non lo trova o trova una versione incompatibile o trova una versione danneggiata .

Le sezioni seguenti offrono un controllo passo passo per assicurarsi che Ancestris stia utilizzando una versione Java 8 valida.

### ## Principio generale - **È necessario un Java Runtime Environment (JRE)** . Il JDK (Java Development Kit) non è richiesto, ma poiché il JDK include un JRE, è sufficiente anche un JDK da solo. - **Ancestris funziona con le versioni Java 8 fino alla versione 18 di Java** . È compilato nella versione 8 per una migliore compatibilità con la maggior parte degli utenti. È stato testato e funziona su Java 8, 11, 17 e 18, che sono versioni LTS (Long Term Support). Non controlliamo le versioni a breve termine che sono obsolete e non possono essere scaricate dopo 18 mesi. Tuttavia, alcuni utenti hanno indicato che Ancestris funziona con Java versione 18. - **Puoi installare Java da qualsiasi fornitore** : Oracle, OpenJdk o [Adoptium](https://adoptium.net/ "Vai su Adptium.net") . - **Se opti per una distribuzione gratuita** , dovrai dire ad Ancestris dove si trova la tua installazione. In questo caso, [come indicato di seguito](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-using-several-java-v "Imposta la versione Java che deve essere utilizzata da Ancestris") , decommenta la `jdkhome`riga nel `ancestis.conf`file di configurazione che si trova nella `etc`directory " " della tua installazione di Ancestris e imposta il percorso appropriato. ## Identifica quale versione di Java è impostata di default Se non sai se Java è installato o quale versione è installata, visita la [pagina di spiegazione dettagliata ufficiale](https://www.java.com/en/download/help/version_manual.xml "Controllo delle versioni installate") o apri direttamente un terminale della riga di comando e digita sulla riga di comando:
``` java -version ```

Esistono metodi alternativi per MacOS e Windows. - per i sistemi MacOS, [controlla le istruzioni passo passo](https://docs.ancestris.org/books/user-guide/page/step-by-step-installation-on-macos#bkmrk-2.-open-a-terminal-a) . - per i sistemi Windows, [controlla le istruzioni passo passo](https://docs.ancestris.org/books/user-guide/page/step-by-step-installation-on-windows#bkmrk-knowing-which-java-v) .

- **Se vedi un messaggio di errore** nel terminale, allora Java non è installato sul tuo sistema. Ancestris non può correre. Si prega di [seguire la sezione Installazione](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-install-java "Installa Java 1.8") di seguito per installare Java 1.8 e quindi avviare Ancestris. - **Se vedi qualcosa di simile dove viene visualizzato Java 1.8** , significa che hai la versione corretta installata e impostata per impostazione predefinita. ``` 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) ``` Secondo il display sopra, possiamo vedere che la versione Java installata impostata per impostazione predefinita è la versione 1.8, ovvero la versione 8. Se Ancestris non si avvia, Ancestris non lo trova o trova una versione incompatibile o trova una versione danneggiata . Si prega di [seguire le istruzioni per identificare quali Java versione Ancestris trova](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-identify-which-java- "Identifica quale versione Java trova Ancestris") . - **Se vedi una versione Java diversa dalla 1.8,** significa che hai un'altra versione Java per impostazione predefinita. ``` 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) ``` In base alla visualizzazione sopra, possiamo vedere che la versione Java installata impostata per impostazione predefinita è la versione 10. Ancestris non verrà eseguito. Si prega di [seguire la sezione Installa di](#bkmrk-install-java "Installa Java 1.8") seguito per installare Java 8. Una volta fatto, avrai diverse versioni di Java installate sul tuo sistema. Se sei felice di impostare Java 8 come versione predefinita, [segui le istruzioni per impostare la versione Java predefinita](#bkmrk-using-several-java-v "Imposta la versione Java predefinita") sul tuo sistema e quindi avvia Ancestris. Se preferisci mantenere la versione Java impostata così com'è, devi dire ad Ancestris di non utilizzare la versione Java predefinita. Si prega di [seguire le istruzioni per costringere Ancestris di utilizzare una versione specifica di Java](#bkmrk-forcing-ancestris-to "Forza Ancestris a utilizzare una versione Java specifica") e quindi avviare Ancestris. ## Identifica quale versione Java trova Ancestris Per sapere quale versione Java trova Ancestris, dovrai controllare il [file di configurazione di](https://docs.ancestris.org/books/user-guide/page/software-files-and-user-settings-files#bkmrk-the-configuration-fi "Posizione dei file di configurazione") Ancestris . **1. Controlla la definizione della linea `default_options`** Questa riga dovrebbe assomigliare a questa: `default_options="--branding ancestris -J-Xms96m -J-Xmx1g --laf javax.swing.plaf.nimbus.NimbusLookAndFeel"` Se una delle opzioni in questa riga include `--jdkhome="/path/to/java`, assicurati che il percorso specificato in questa opzione sia il percorso di Java versione 1.8. Altrimenti, modifica il file di configurazione e cambialo. Quindi avvia Ancestris. Se questa riga non include un percorso java, seguire le istruzioni di seguito. **2. Controlla la definizione della linea `jdkhome`** Se la riga è simile a `jdkhome="/path/to/java"`, assicurati che il percorso specificato in questa opzione sia il percorso della versione 8 di Java. Altrimenti, modifica il file di configurazione e cambialo. Quindi avvia Ancestris. Se la riga inizia con "#" o se la riga non esiste, significa che la riga non è utilizzata da Ancestris e che Ancestris utilizza la versione Java predefinita impostata sul sistema. Se la versione predefinita selezionata sopra era Java 8, significa che la versione Java 8 installata potrebbe essere danneggiata. Prova a reinstallarlo utilizzando le [istruzioni di installazione](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-install-java "Installa Java") e riavvia Ancestris. --- ## Installa Java

Per installare Java versione 8 sul tuo sistema, puoi [scaricarlo dalla pagina ](https://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html "Pagina di download Oracle versione utente Java 8 ")[principale di Oracle](http://www.java.com/en/ "Sito Java.com") , o più precisamente: - **Versione di utilizzo semplice** : [dalla pagina di download di JRE (MacOS, Windows, Linux)](https://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html "Pagina di download Oracle versione utente Java 8 ") - **Versione per sviluppatori** : [dalla pagina di download di JDK ( Mac OS, Windows, Linux)](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html "Java 8 Developer Version Pagina di download di Oracle ")

Un modo semplice per ottenere una versione ufficiale di Java è ottenerla anche da [Adoptium.net](https://adoptium.net/releases.html "Ultime versioni Java ufficiali da Adoptium.net")

- Se hai bisogno di **sapere se il tuo dispositivo può eseguire Java** , vai a questa [pagina di configurazione](http://www.oracle.com/technetwork/java/javase/config-417990.html#os "Configurazione richiesta per eseguire Java") per conoscere la configurazione minima necessaria. - Se vuoi **scegliere tra tutte le versioni Oracle Java disponibili** , controlla questa [pagina delle versioni disponibili](http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html "Pagina di download delle versioni Java") . - Si consiglia Java versione 8 in quanto supporta tutte le funzionalità di Ancestris. - Per tutti i dettagli su come installare la versione 8 - Per MacOS, vedere [Installazione di JRE 8 per MacOS](https://docs.oracle.com/javase/8/docs/technotes/guides/install/mac_jre.html#CHDGECEB) . - Per Windows, vedere [Installazione di JRE per Windows](https://docs.oracle.com/javase/8/docs/technotes/guides/install/windows_jre_install.html#CHDEDHAJ) . - Per Linux, vedere [Installazione di JRE per Linux](https://docs.oracle.com/javase/8/docs/technotes/guides/install/linux_jre.html) . - - Java versione 11 supporta la maggior parte delle funzionalità di Ancestris. - Scarica e installa [Java Development Kit (JDK) versione 11](https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html) - Per MacOS, scegli il file .dmg. - Per tutti i dettagli su come installare la versione 11 - Per MacOS, vedere [Installazione di JDK per MacOS](https://docs.oracle.com/en/java/javase/11/install/installation-jdk-macos.html#GUID-2FE451B0-9572-4E38-A1A5-568B77B146DE) . - Per Windows, vedere [Installazione di JDK per Windows](https://docs.oracle.com/en/java/javase/11/install/installation-jdk-microsoft-windows-platforms.html#GUID-A7E27B90-A28D-4237-9383-A58B416071CA) . - Per Linux, vedere [Installazione del JDK su Linux](https://docs.oracle.com/en/java/javase/11/install/installation-jdk-linux-platforms.html) . - Se **preferisci una versione Java Open Source** , è possibile utilizzare [OpenJDK ](http://openjdk.java.net/ "Scarica il sito OpenJDK")e puoi anche installare Java dalla soluzione gratuita [Adoptium](https://adoptium.net/ "adozione") . ## Imposta la versione Java predefinita Le procedure dipendono dal tuo sistema operativo. - [Per MacOS](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-set-the-default-java "Scelta della versione Java per MacOS") - [Per Windows](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-swaping-java-version-0 "Scelta della versione Java per Windows") - [Per Linux](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-swaping-java-version-1 "Scelta della versione Java per Linux") ### Imposta la versione predefinita per MacOS La versione di Java in esecuzione sul sistema potrebbe non essere compatibile con Ancestris, quindi non verrà eseguita. Se vuoi mantenere la tua versione attuale di Java e, ad esempio, eseguire Java Version 8 (aka 1.8) contemporaneamente, devi scambiare le versioni di Java. Per scambiare tra diverse versioni di Java, apri una finestra di Terminale e segui i passaggi seguenti. Nell'esempio seguente, le istruzioni consentono di impostare la versione 8 (alias 1.8) per impostazione predefinita, senza rimuovere la versione 10 di Java: **1/6 - Verifica quale versione di Java è impostata di default** ``` java -version echo $jdkhome ``` Puoi vedere la versione Java che stai utilizzando. **2/6 - Ottieni un elenco di tutte le versioni installate sul tuo sistema e controlla che la versione 8 o 11 sia tra queste**
``` /usr/libexec/java_home -V ```
Se la versione che desideri non è nell'elenco, installala come spiegato in [questa sezione](https://docs.ancestris.org/books/user-guide/page/java-installation#bkmrk-install-java) . Se è nell'elenco, ma non in quello che avevi sopra, forza il percorso alla versione java con il seguente passaggio. **3/6 - Digita le seguenti 2 righe nel Terminale** ``` 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 ``` Queste due righe aggiungeranno il comando per impostare la tua versione Java predefinita nel tuo profilo personale. Qui forziamo la versione 1.8 (o 8). Sostituisci con la tua versione Java. La prima riga definisce la versione Java predefinita per tutti i programmi (JAVA\_HOME, in maiuscolo). La seconda riga definisce la versione Java predefinita da utilizzare per Ancestris (jdkhome, minuscolo). **4/6 - Chiudi il Terminale**
``` Exit ```
**5/6 - Riapri un Terminale e controlla che Java in esecuzione sia ora quello che desideri (versione 8 nel nostro esempio)** ``` java -version echo $jdkhome ``` Ora puoi avviare Ancestris. **6/6 - Inizio Ancestris** All'avvio di Ancestris, si apre contemporaneamente una finestra di Terminale. Puoi vedere nella barra del titolo che la versione 8 di Java è utilizzata da Ancestris. ### Imposta la versione predefinita per Windows Devi creare un file BAT per la versione Java che desideri conservare. Usa il tuo editor di testo preferito per creare quei file, usando il codice qui sotto, e mettili in una cartella disponibile dal tuo 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 ``` Durante la creazione di questi file, assicurati di specificare il nome corretto per i file Java per le righe JAVA\_HOME, a seconda della tua installazione Java Quando si decide di cambiare la versione di Java, è sufficiente eseguire il file BAT corrispondente: JAVA8 per la versione 1.8 o JAVA11 per la versione 11. La versione di Java in uso verrà mostrata sul terminale. Per verificare se la modifica è effettivamente in vigore, digita `java -version`su una console o controlla [questa pagina](https://www.java.com/en/download/help/version_manual.xml) . Se desideri mantenere l'ultima versione di Java e forzare l'utilizzo di un'altra versione di Java per Ancestris, devi modificare il [file di configurazione](https://docs.ancestris.org/books/user-guide/page/software-files-and-user-settings-files#bkmrk-the-configuration-fi "Posizione dei file di configurazione") , riga`jdkhome="C:\path\to\java" ` ### Imposta la versione predefinita per Linux Digita quanto segue su una console:
``` sudo update-alternatives --config java ```
[![en_linux-java-versions.png](https://docs.ancestris.org/uploads/images/gallery/2020-05/scaled-1680-/en_linux-java-versions.png)](https://docs.ancestris.org/uploads/images/gallery/2020-05/en_linux-java-versions.png) Selezionare dall'elenco la versione necessaria. Se desideri mantenere l'ultima versione di Java e forzare l'utilizzo di un'altra versione di Java per Ancestris, devi modificare il [file di configurazione](https://docs.ancestris.org/books/user-guide/page/software-files-and-user-settings-files#bkmrk-the-configuration-fi "Posizione dei file di configurazione") , riga`jdkhome="/path/to/java" ` Per ottenere aiuto utilizzando questo strumento:
``` sudo update-alternatives -l ```
## Forza Ancestris a utilizzare una versione Java specifica Qualunque sia il tuo sistema operativo, se la versione Java attiva predefinita è diversa da quella da utilizzare con Ancestris, devi modificare il [file di configurazione](https://docs.ancestris.org/books/user-guide/page/software-files-and-user-settings-files#bkmrk-the-configuration-fi "Dove sono i file di configurazione?") di Ancestris in questo modo:
``` jdkhome="/percorso/a/java" ```
Nota: devi escludere /bin/java nella descrizione del percorso. Ad esempio: se l'eseguibile java è /usr/java/jdk1.8.0\_291-amd64/bin/java, allora dovresti indicare ``` jdkhome="/usr/java/jdk1.8.0_291-amd64/" ```

Al contrario, se questa riga non è commentata, cioè se non inizia con il carattere "#", Ancestris ne terrà conto per primo e **il percorso indicato alla versione Java deve esistere e corrispondere a una versione funzionante di Java** . In caso contrario, Ancestris non cercherà altre posizioni per una versione Java migliore e Ancestris non si avvierà.