Scaricare

Questa pagina fornisce i passaggi di base per l'installazione di JOSM e le informazioni per la risoluzione dei problemi. Per iniziare a lavorare con JOSM, consulta le pagine Introduction e Help. E per questioni molto complesse vedi le Note d'Installazione (en).

Opzioni raccommandate

Avvia josm.jnlp (versione testata più recente)
Versione raccomandata, per tutte le piattaforme, aggiornata automaticamente, con cadenza mensile, alla più recente versione testata (how to start).

Scarica josm-tested.jar (versione testata 19396)
Tutte le piattaforme (how to run).

Tutte le opzioni di download

Ogni mese il team di JOSM rilascia (en) una versione testata per il download. Le varianti per MS Windows ed Apple macOS sono compilate su questa versione testata. Quando si clicca su josm.jnlp per lanciare JOSM, si otterrà sempre la versione testata più recente. Web Start (en) di Java è il meccanismo che lo rende possibile.

Ogni notte il sistema di compilazione genera un'ultima versione. Queste versioni possono contenere errori anche gravi ma, di solito, funzionano bene. Per l'ultima versione è disponibile anche una variante Web Start.

	Per tutti i sistemi operativi						In sviluppo
Versione	Web Start	Download	Windows	Apple macOS	Ubuntu, Debian…	openSUSE	Jar / Javadoc / Source
testata 19396	josm.jnlp	josm-tested.jar	josm-setup.exe josm-setup.msi ​Microsoft Store (vedi sotto)	JOSM macOS .zip package o (homebrew)	vedi sotto	vedi sotto	josm:19396
latest 19405	latest.jnlp	josm-latest.jar			vedi sotto		Usa gli snapshots
older		download/		​compilazioni automatiche della JOSM.app	pool/		versioni testate

Quando si avviano gli script si prega di controllare prima su ultima, testata o tutte per ridurre il consumo di banda in download.

Eliminare le traduzioni
Se la dimensione del download è un problema, sono disponibili file più piccoli della versione testata. Per i download contenenti solo inglese, aggiungi ?lang=en all'URL. Per includere una traduzione, sostituisci en con il codice della lingua (en) che desideri (primo carattere minuscolo, solo per le lingue supportate). È possibile ridurre ulteriormente le dimensioni del file eliminando le informazioni di firma aggiungendo ?unsigned=1.

Repository Linux

JOSM basato su Debian, principalmente per Ubuntu

Questo è il nostro repository di pacchetti principalmente per Ubuntu. Dovrebbe funzionare anche con altre distribuzioni basate su Debian (soprattutto basate su Ubuntu), ma non testiamo e manteniamo attivamente alcuna distribuzione diversa da Ubuntu.

Il repository contiene due pacchetti:

• josm – Fornisce la versione testata (stabile). Sostituisce il pacchetto fornito dal repository ufficiale della tua distribuzione. Il nome predefinito delle cartelle JOSM è impostato su JOSM.
• josm-latest – L'ultima versione (nightly). Può essere installata parallelamente al pacchetto josm, perchè il nome predefinito delle cartelle di questa versione JOSM è impostato su JOSM-latest.

Entrambi i pacchetti forniscono rispettivamente /etc/default/josm e /etc/default/josm-latest come file di configurazione per le opzioni java (en).

Oltre alla normale procedura descritta di seguito, i DEB precedenti possono essere scaricati manualmente dagli archivi dei file.

Installazione

Modifica la lista delle risorse dei pacchetti /etc/apt/sources.list.d/josm.list:

sudo editor /etc/apt/sources.list.d/josm.list

ed aggiungi una delle linee seguenti in base alla tua versione di Ubuntu:

deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt lunar universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt kinetic universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt impish universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt hirsute universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt groovy universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt eoan universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt disco universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe

# Per le altre distribuzioni basate su Debian aggiungi:
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe

In alternativa, tutto ciò può essere fatto in Ubuntu con la seguente linea di comando unica (non per le distribuzioni basate su Ubuntu tipo Linux Mint):

echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(lsb_release -sc) universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null

o per Linux Mint:

echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(grep ^DISTRIB_CODENAME= /etc/upstream-release/lsb-release| awk -F = '{print $(2)}') universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null

Scarica la chiave pubblica:

# Creare la cartella per le chiavi scaricate manualmente se non è già stata creata
sudo mkdir -p /usr/local/share/keyrings
# Scarica la chiave
wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg

In passato, era usata l'istruzione apt-key. Se la chiave è stata aggiunta al portachiavi di sistema, la linea di comando seguente la rimuoverà:

sudo apt-key del $(apt-key list | grep -B1  "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57)

Ora aggiorna i sorgenti dei pacchetti:

# Prima potresti aver bisogno di installare il supporto ssl per apt:
sudo apt-get install apt-transport-https
# Aggiorna i sorgenti
sudo apt-get update

ed installa:

# Puoi saltare questa prima linea se questi pacchetti non sono mai stati installati.
sudo apt-get remove josm josm-plugins

# Per la versione testata
sudo apt-get install josm
# Per la versione in sviluppo
sudo apt-get install josm-latest

GNU Debian

I nostri pacchetti Ubuntu, vedi su, funzionano su Debian e noi ne consigliamo l'uso. In base al setup di sudo, alcune istruzioni non funzioneranno come utente "normale" ma solo root.

A partire da Debian 11 (bullseye) il ​josm-installer è disponibile sotto main nella sezione utils. Esso scarica il file .jar attuale da questo sito e lo aggiorna se necessario.

La versione testata di ​JOSM è disponibile sotto main nella sezione utils, ma la versione di solito è piuttosto vecchia.
Usare il ​backports repository per ottenere una versione più aggiornata, vedere le ​Istruzioni. Anche questa versione potrebbe essere piuttosto vecchia.

openSUSE

La versione testata di JOSM è disponibile nel repository the Application:Geo.

Per prima cosa aggiungere come utente root in yast o con zypper il repository (per Tumbleweed sostituire $releasever con openSUSE_Tumbleweed):

zypper ar -f 'https://download.opensuse.org/repositories/Application:/Geo/$releasever' Application:Geo

Quindi installare semplicemente i pacchetti josm e josm-fonts.

Risoluzione dei problemi

Java

Quando fai doppio clic su un file jar e non succede nulla nella maggior parte dei casi significa che Java non è installato.

JOSM è stato testato con una variante di Oracle, perciò raccomandiamo di ottenere Java dalle loro pagine di download per le versioni ​manuale o ​intermedia.

JOSM ora raccomanda i JDK ​Azul o ​Bellsoft Liberica. In generale, l'attuale Java LTS sarebbe da preferire (nel momento della scrittura di questo wiki dovrebbe essere Java 17), ma dovrebbe funzionare anche Java 8. Vedi il README​ per le raccomandazioni attuali. Ma, prima di tutto, prova con la versione di Java già presente nel tuo sistema operativo, ​ad esempio OpenJdk.

Quando si sceglie un download bisogna ricordare che:

• Un Plug-in Java per il web browsers non è necessario per eseguire JOSM. Pertanto i risultati di pagine come www.java.com/en/download/installed8.jsp non sono rilevanti.
• È raccomandata una variante Java a 64 bit per JOSM. L'architettura del sistema operativo è importante per decidere tra Java 32 bit e Java 64 bit. Siccome JOSM non è influenzato dall'architettura del web browsers la maggior parte delle raccomandazioni sulla pagina www.java.com/en/download/faq/java_win64bit.xml non sono rilevanti.
• Evita pagine come www.java.com/en/download che intendono installare plug-in Java nei browser web. Questi non sono importanti per JOSM.

Per ulteriori informazioni visita le pagine Note di Installazione e ​risoluzione dei problemi. Per Java, in questa sezione, si intende un JRE (Java Runtime Engine) che fornisce una JVM (Java Virtual Machine) per eseguire JOSM, un programma Java sviluppato usando JDK (Java Development Kit) e lanciato, a volte, con il JNLP (Java Network Launch Protocol aka Web Start e successore dei Plug-ins Java).

Testare Java

Verificare se Java è installeto e perchè JOSM non si avvia (esempio principalmente per MS Windows).

1. Scarica josm-tested.jar sul tuo desktop.
2. Apri un Promp dei Comandi aka Terminale
3. Scrivi cd %homepath%⏎ e scrivi cd Desktop⏎
4. Scrivi java -version ⏎ Dovrebbero comparire tre linee con i dati della versione. Se appare qualcosa di diverso allora Java non è installato correttamente.
5. Scrivi java -jar josm-tested.jar⏎. Ora si dovrebbe avviare JOSM, lanciato dall Linea di Comando (en).
6. Chiudi JOSM.
7. Scrivi josm-tested.jar⏎. Se JOSM si avvia di nuovo, l'Explorer di Windows è pronto per il doppio click sui file jar.

Web Start

È necessario prima installare ​OpenWebStart. Esso scaricherà ed avvierà Java da solo. La transizione da Oracle WebStart a OpenWebStart è ancora in corso, perciò, in caso di problemi, crea un nuovo ticket o posta un commento su #17858.

Potrebbe essere necessario aggiornare l'applicazione predefinita per aprire i file JNLP se in precedenza era usato Oracle WebStart. Vedi ​associazione dei file jnlp per le istruzioni sulle impostazioni di OpenWebStart come programma predefinito per i file jnlp.

Testare Web Start

1. Scarica josm.jnlp sul tuo desktop.
2. Apri un Terminale e spostati sul Desktop come scritto sopra
3. Scrivi javaws josm.jnlp⏎. Ciò prima scaricherà JOSM, mostrerà un avviso di sicurezza e quindi avvierà JOSM.
4. Se non funziona, allora scrivi javaws -verbose josm.jnlp⏎. Ciò prima mostrerà una finestra di dialogo con informazioni sulla JVM e quindi avvierà JOSM.

Macchina Virtuale

Fuori memoria

Al giorno d'oggi il controllo manuale della memoria Java è raramente necessario perché la RAM disponibile sui computer è aumentata. I valori scelti in modo errato possono ridurre le prestazioni di JOSM.

Per alcuni compiti, JOSM ha un grande appetito di memoria. Da un lato, potrebbe essere necessario configurare una dimensione di memoria che supporti più plug-in e funzionalità. Di contro, le macchine lente possono essere stabilizzate limitando l'uso della memoria di Java. Se necessario, usa la linea di comando (en) per impostare le ​Opzioni Java -Xmx…m, per esempio -Xmx512m o -Xmx1536m. In Debian/Ubuntu si può modificare il file /etc/default/josm o rispettivamente /etc/default/josm-latest.
Nei programmi java precedenti sono accettati -Xmx=512m o anche -Xmx 512m. Ora quegli argomenti malformati generano messaggi di errore.

Selezione della VM

Nella versione attuale di MS Windows, Java è installato principalmente nella cartella C:\Program Files\Java\. Parti aggiuntive si trovano in C:\Program Files\Oracle\Java\. C'è una cartella .\javapath\ indicata nella variabile d'ambiente PATH. Lì si trovano i tre file virtuali java.exe, javaw.exe e javaws.exe. Questi file sono link simbolici all'installazione attuale di Java.

Sulle vecchie versioni a 64 bit di Windows a volte è installato in aggiunta un JRE in modalità 32 bit. Anche alcuni browser hanno la propria JVM con capacità limitate. In questi casi un Web Start dal browser non userà la tua installazione di Java bensì quella del browser.

Verifica che non vi sia nessun altro javawebstart in \Windows\SysWow64. Il pannello di controllo di Java non lo rileverà ed è possibile cancellarlo con tranquillità. Esegui una pulizia e mantieni solo le ultime versioni di ogni JRE (Una per la modalità 32-bit , un'altra per quella a 64-bit).

Per i collegamenti creati sul desktop per JNLP e che eseguono il programma di avvio Javawebstart , assicurati di passare i parametri VM con prefisso -J e nessuno spazio intermedio prima dell'opzione VM. Se hai installato sia la versione a 32 bit che quella a 64 bit, dovresti passare l'opzione "-d64" se vuoi selezionare la VM a 64 bit preferita. Si noti che alcune pagine della documentazione Oracle indicano l'opzione "-D64" con la maiuscola errata!)

Esempio di una linea di comando modificata per creare un collegamento sul desktop di Windows:

javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp 

josm.exe per Windows

Usando josm-setup.exe per l'installazione su Microsoft Windows si verificano le seguenti azioni:

• I due file eseguibili JOSM.exe e HWConsole.exe sono installati nella cartella %LOCALAPPDATA%\JOSM
• JOSM.exe è registrato come programma predefinito per le estensioni di file *.osm, *.geojson, *.gpx, *.jos and *.joz.
• Le icone di collegamento a JOSM sono inserite sul Desktop e nel Menu Start.
• I dati di disinstallazione sono inseriti nei punti appropriati.

Quando si lancia JOSM.exe viene avviato JOSM con una versione incorporata di Java mantenuta dagli sviluppatori di JOSM, basata su Azul Zulu. JOSM.exe agisce come un contenitore ed è portatile (en).

HWConsole.exe è simile a JOSM.exe ma avvia JOSM aprendo una console Windows che mostra i messaggi standard di JOSM (logs).

JOSM.exe accetta tutti i consueti argomenti di programma JOSM (en). Vedere ad esempio:

# Caricare i dati OSM
josm.exe https://www.osm.org/way/476702262

Per passare le opzioni Java (en) alla VM Java, JOSM.exe usa il file di configurazione JOSM.cfg nella sotto-cartella della sua app. In questo file ogni opzione richiede una linea separata.

macOS

Usindo il gestore brew

Gli utenti macOS possono usare il gestore di pacchetti ​homebrew per installare ed aggiornare la loro versione JOSM.

Nel Terminale, esegui brew install --cask josm per installare o brew upgrade --cask josm per aggiornare l'attuale versione testata di JOSM.

Problemi noti

Problemi non risolti riguardanti …:

• problemi Java - alcuni dei bug portano a blocchi in Oracle JVM (elencati in JavaBugs).
• Linux
• Ubuntu
• macOS
• Windows