Téléchargement

Cette page fournit les étapes d'installation de base de JOSM et des informations de dépannage. Pour commencer à travailler avec JOSM, veuillez consulter les pages d'Introduction à JOSM et d'Aide. Et pour les questions très complexes, voir les Notes d'Installation.

Options recommandées

Lancer josm.jnlp (dernière version stable)
Utilisation recommandé, toutes les plateformes ; la mise à jour est (contrairement aux autres options) automatique mensuelle vers la dernière version stable (comment Démarrer)
actuellement la dernière version stable de JOSM est 19265

Télécharger josm-tested.jar (version stable 19265)
toutes plateformes (comment le lancer).

Toutes les options de téléchargement

Chaque mois l'équipe de JOSM livre une version stable (tested version) à télécharger. Les variantes MS Windows et Apple macOS sont produites sur cette version stable. Lorsque vous cliquez sur josm.jnlp pour lancer JOSM, vous obtiendrez toujours la dernière version stable. Le Web Start de Java est le mécanisme derrière tout cela.

Chaque nuit, les systèmes de compilation génèrent une nouvelle version de développement (latest version). Ces versions peuvent contenir de graves erreurs. Mais la plupart du temps, elles fonctionnent bien aussi. Pour la dernière version de développement, une variante Web Start est également disponible.

	Pour tous les systèmes d'exploitation						Développement
Version	Web Start	Télécharger	Windows	Apple macOS	Ubuntu, Debian…	openSUSE	Jar / Javadoc / Source
stable 19265	josm.jnlp	josm-tested.jar	josm-setup.exe josm-setup.msi ​Microsoft Store (voir ci-dessous)	package .zip macOS de JOSM ou (homebrew)	voir ci-dessous	voir ci-dessous	josm : version 19265
développement 19272	latest.jnlp	josm-latest.jar	voir ​les versions sur github	voir ​les versions sur github	voir ci-dessous		Utiliser snapshots
plus anciennes		répertoire de téléchargement download/	voir ​les versions sur github	voir ​les versions sur github	répertoire de téléchargement pool/		versions stables

Lorsque vous exécutez des scripts, veuillez d'abord vérifier sur la version de développement, stable ou toutes pour réduire la bande passante de téléchargement.

Strip translations
Si la taille de téléchargement est un problème, des fichiers plus petits de la version stable sont disponibles. Pour les téléchargements ne contenant que de l'anglais, ajoutez ?lang=en à l'URL. Pour inclure une traduction, remplacez `en' par le code de langue (en) nécessaire (premier caractère en minuscule, uniquement pour les langues supportées). Vous pouvez réduire encore plus la taille du fichier en supprimant les informations de signature en ajoutant ?unsigned=1.

Dépôts Linux

Le Debian de JOSM basé principalement pour Ubuntu

Il s'agit de notre propre dépôt de paquets, principalement pour Ubuntu. Il devrait aussi fonctionner avec d'autres distributions basées sur Debian (en particulier basées sur Ubuntu), mais nous ne testons et ne maintenons pas activement d'autres distributions qu'Ubuntu.

Le dépôt contient deux paquets:

• josm – Fournit la version stable. Remplace le paquet du dépôt officiel de votre distribution. Le nom par défaut des répertoires JOSM est défini comme suit : JOSM.
• josm-latest – La version de développement (nightly). Peut être installé en parallèle avec le paquet josm, par conséquent le nom par défaut des répertoires JOSM est défini comme suit : JOSM-latest.

Les deux paquets fournissent respectivement /etc/default/josm et /etc/default/josm-latest comme fichiers de configuration pour les options java.

En plus de la procédure normale décrite ci-dessous, les anciens DEB peuvent être téléchargés manuellement à partir des archives.

Installation

Modifier la liste des ressources du paquet /etc/apt/sources.list.d/josm.list :

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

et ajoutez l'une des lignes suivantes selon votre version Ubuntu :

deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt oracular universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble 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 focal universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe

# Pour les autres distributions basées sur Debian, ajoutez :
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe

Alternativement, cela peut être fait avec l'uniligne suivante avec Ubuntu (pas pour les distributions basées sur Ubuntu comme 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

ou pour 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

Téléchargez la clé publique:

# Créez le répertoire pour les clés téléchargées manuellement s'il n'a pas déjà été créé
sudo mkdir -p /usr/local/share/keyrings
# Téléchargez la clé
wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg

Dans le passé, les instructions utilisaient apt-key. Si la clé a été ajoutée au trousseau du système, la ligne suivante la supprimera :

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

Rafraîchissez maintenant vos sources :

# au préalable vous devrez peut-être installer le support ssl pour apt :
sudo apt-get install apt-transport-https
# Rafraîchissez les sources
sudo apt-get update

et installez :

# Vous pouvez ignorer la première ligne si vous n'avez pas installé ces paquets précédemment.
sudo apt-get remove josm josm-plugins

# Pour la version stable
sudo apt-get install josm
# Pour la version de développement 
sudo apt-get install josm-latest

GNU Debian

Nos propres paquets Ubuntu, ci-dessus, fonctionnent sur Debian et nous vous recommandons de les utiliser. Selon la configuration de sudo, certaines instructions ne fonctionneront pas en tant qu'utilisateur "normal" mais uniquement en tant que root.

La version stable de ​JOSM est disponible sous main dans la section utils, mais la version est généralement assez ancienne.
Veuillez utiliser le ​dépôt backports pour obtenir la version actualisée, voir les ​instructions (en). Cette version peut encore être plus ancienne que nos propres paquets.

Depuis Debian 11 (bullseye), l'​installateur de josm est disponible sous main dans la section utils. Il télécharge le fichier .jar courant depuis ce site et le met à jour si nécessaire.

openSUSE

La version stable de JOSM est disponible dans le dépôt Application:Geo.

Ajoutez d'abord en tant qu'utilisateur root (root user) dans yast ou avec zypper le dépôt : ((pour Tumbleweed, remplacez $releasever par openSUSE_Tumbleweed)

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

Ensuite, installez simplement les paquets josm et josm-fonts.

Résolution des problèmes

Java

Lorsque vous double-cliquez sur un fichier jar et que rien ne se passe, dans la plupart des cas, cela signifie que Java n'est pas installé.

JOSM recommande désormais les JDK ​Azul ou ​Bellsoft Liberica. D'une manière générale, la version actuelle de Java LTS est préférable (à l'heure où nous écrivons ces lignes, il s'agit de Java 17), mais Java 11 fonctionne également. Consultez le fichier README (en)​ pour connaître les recommandations actuelles. Mais, essayez d'abord le Java déjà distribué avec le système d'exploitation, ​par exemple (en).

Lorsque vous choisissez un téléchargement, gardez à l'esprit :

• Un plug-in Java pour les navigateurs Web n'est pas nécessaire pour exécuter JOSM. Par conséquent, les résultats de pages comme www.java.com/en/download/installed8.jsp ne sont pas pertinents.
• Une variante Java avec 64 bits est recommandée pour JOSM. L'architecture du système d'exploitation est importante pour choisir entre Java 32 bits ou Java 64 bits. Parce que JOSM n'est pas affecté par l'architecture des navigateurs web, la plupart des recommandations sur cette page www.java.com/en/download/faq/java_win64bit.xml ne sont pas pertinentes.
• Évitez les pages comme www.java.com/en/download qui ont l'intention de placer des plug-ins Java dans les navigateurs web. Et ce n'est pas important pour JOSM.

Pour plus d'informations, consultez les Notes d'Installation et et les pages de Résolution des problèmes ​troubleshooting. Java dans cette section signifie un JRE (Java Runtime Engine) qui fournit une JVM (Java Virtual Machine) pour exécuter JOSM, un programme Java qui est développé avec JDK (Java Development Kit) et parfois lancé avec le JNLP (Java Network Launch Protocol également connu sous le nom de Web Start et successeur des plug-ins Java).

Tester Java

Vérifie si Java est installé et pourquoi JOSM ne démarre pas (exemple principalement pour MS Windows).

1. Téléchargez josm-tested.jar sur votre bureau.
2. Ouvrir une "Invite de commandes" (Terminal)
3. Tapez cd %homepath%⏎ puis cd Desktop⏎
4. Tapez java -version ⏎ Trois lignes avec les données de version doivent apparaître. Si vous voyez autre chose, Java n'est pas correctement installé.
5. Tapez java -jar josm-tested.jar⏎. Maintenant, JOSM devrait fonctionner, démarré à partir de la ligne de commande.
6. Quittez JOSM.
7. Tapez josm-tested.jar⏎. Si JOSM redémarre, l'explorateur Windows est prêt pour un double clic sur les fichiers jar.

Web Start

Vous devez d'abord installer ​OpenWebStart. Il téléchargera et exécutera Java tout seul. Veuillez utiliser la version 64 bits (x64) d'OpenWebStart si vous êtes sous Microsoft Windows. La transition de WebStart (Oracle) à OpenWebStart est toujours en cours, donc en cas de problème, veuillez créer un nouveau ticket ou poster un commentaire à #17858.

Vous devrez peut-être mettre à jour l'application par défaut pour l'ouverture des fichiers JNLP si vous utilisiez auparavant Oracle WebStart. Voir l'​association de fichiers jnlp pour obtenir des instructions sur le paramétrage d'OpenWebStart comme programme par défaut pour les fichiers jnlp.

Tester Web Start

1. Téléchargez josm.jnlp sur votre bureau.
2. Ouvrez un terminal et déplacez-vous sur le bureau comme ci-dessus.
3. Tapez javaws josm.jnlp⏎. Ceci devrait d'abord télécharger JOSM, afficher une fenêtre de sécurité et ensuite lancer JOSM.
4. Si cela échoue, tapez javaws -verbose josm.jnlp⏎. Ceci devrait d'abord afficher une fenêtre contenant des informations sur la JVM, puis lancer JOSM.

Machine virtuelle

Manque de mémoire

De nos jours, le contrôle manuel de la mémoire Java est rarement nécessaire car la RAM disponible sur les ordinateurs a augmenté. Des valeurs mal choisies peuvent diminuer les performances du JOSM.

Pour certaines tâches, JOSM a un grand appétit de mémoire. D'une part, il peut être nécessaire de configurer une taille de mémoire qui supporte plus de greffons et de fonctionnalités. D'autre part, il est possible de stabiliser les machines lentes en limitant l'utilisation de la mémoire Java. Si nécessaire, utilisez la ligne de commande pour définir l'​Option Java -Xmx…m, par exemple -Xmx512m ou -Xmx1536m. Dans Debian/Ubuntu, vous pouvez modifier le fichier /etc/default/josm respectivement /etc/default/josm-latest.
Auparavant, les anciens programmes java acceptaient -Xmx=512m ou même -Xmx 512m. Maintenant, ces arguments malformés lancent des messages d'erreur.

Sélection VM

Sur les versions actuelles de MS Windows, Java est installé par défaut, principalement dans le répertoire C:\Program Files\Java\. Des éléments supplémentaires sont placées dans C:\Program Files\Oracle\Java\. Il y a un répertoire .\javapath\ comme cible pour la variable d'environnement PATH. C'est le répertoire où se trouvent les trois fichiers virtuels java.exe, javaw.exe and javaws.exe. Ces fichiers sont des liens symboliques à partir des installations Java actuelles.

Sur les anciennes versions de Windows 64 bits, le mode 32 bits JRE était parfois installé en plus. De plus, certains navigateurs ont apporté leur propre JVM avec des capacités limitées. Dans ces cas, un Web Start à partir du navigateur n'utiliserait pas votre installation Java mais celle du navigateur.

Vérifiez qu'il n'y a pas d'autre javawebstart dans \Windows\SysWow64. Le panneau de contrôle Java ne le détectera pas et vous pouvez le supprimer en toute sécurité. Effectuez le nettoyage et ne conservez que les dernières versions de chaque JRE (un ou le mode 32-bit, un autre pour le mode 64-bit).

Pour les raccourcis créés sur le bureau pour JNLP et exécutant le lanceur Javawebstart, assurez-vous de passer les paramètres VM préfixés avec -J et sans aucun espace intermédiaire avant l'option VM. Si vous avez installé ensemble les versions 32-bit et 64-bit, vous devez passer l'option "-d64" si vous voulez sélectionner la VM 64 bits préférée. Notez que certaines pages de documentation Oracle indiquent l'option "-D64" avec une majuscule incorrecte !)

Exemple d'une ligne de commande éditée pour un raccourci sur le bureau Windows :

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

Microsoft Windows

josm.exe

L'utilisation de josm-setup.exe pour l'installation sous Microsoft Windows fait ce qui suit :

• Il place les deux fichiers exécutables JOSM.exe et HWConsole.exe dans le répertoire %LOCALAPPDATA%\JOSM.
• Il définit JOSM.exe comme cible pour les extensions de fichiers *.osm, *.geojson, *.gpx, *.jos et *.joz.
• Il place des icônes de raccourci JOSM sur le Bureau et dans le menu Démarrer.
• Ajoute les données de désinstallation aux endroits appropriés.

Au démarrage, JOSM.exe lance JOSM avec une version intégrée de Java maintenue par les développeurs de JOSM, basée sur Azul Zulu. JOSM.exe agit comme une enveloppe et il est portable.

HWConsole.exe est similaire à JOSM.exe mais lance JOSM tout en gardant ouverte une console Windows affichant la sortie standard de JOSM (fichier journal).

JOSM.exe accepte tous les arguments habituels du programme JOSM. Voir l'exemple :

# Il charge les données OSM
josm.exe https://www.osm.org/way/476702262

Pour donner les options Java à la VM Java, JOSM.exe utilise le fichier de configuration JOSM.cfg dans son sous-répertoire app. Dans ce fichier, chaque option doit figurer sur une ligne distincte.

Par exemple, pour modifier l'allocation de mémoire, ouvrez %LOCALAPPDATA%\JOSM\JOSM.cfg et ajoutez java-options=-Xmx8192m (pour 8 GB) à une nouvelle ligne sous l'en-tête [JavaOptions].

Graphiques

Certaines installations Windows ont des problèmes avec les pilotes graphiques (voir #23784 pour un exemple). Les symptômes suivants peuvent apparaître :

• Barres noires dans les barres d'outils de JOSM.
• Scintillement.
• D'autres problèmes inattendus liés à l'interface utilisateur.

1. Téléchargez et installez Display Driver Uninstaller (DDU, ​source) depuis le site miroir officiel => ​https://www.wagnardsoft.com/display-driver-uninstaller-DDU-
2. Dans le menu déroulant "Device Type" à droite, sélectionnez "GPU". DDU détectera automatiquement le GPU que vous utilisez.
3. Cliquez sur "Clean and Restart" en haut. Cela désinstallera les pilotes graphiques et redémarrera votre PC.
4. Réinstallez les pilotes.

AVERTISSEMENT : Créez une sauvegarde de votre PC avant d'utiliser DDU. Bien qu'il crée lui-même un point de récupération, il est préférable d'en créer un vous-même, au cas où.

macOS

en utilisant le gestionnaire de paquets

Les utilisateurs de macOS peuvent utiliser le gestionnaire de paquets ​homebrew pour installer et mettre à jour leur instance JOSM.

Dans le Terminal, exécutez les commandes brew install --cask josm pour installer ou brew upgrade --cask josm pour le mettre à niveau vers la dernière version stable de JOSM.

Linux

Arch Linux

En utilisant AUR, vous pouvez installer ​openwebstart-bin.

Si vous utilisez ​icedtea-web au lieu de l'openwebstart recommandé, vous obtiendrez une erreur avec la dernière version de java. java-17-openjdk est connu pour fonctionner, mais java-22-openjdk ne fonctionne pas.

Problèmes connus

Problèmes non clos sur ..... :

• Problèmes Java - certains des bogues mènent à des blocages dans Oracle JVM (covered at JavaBugs).
• Linux
• Ubuntu
• macOS
• Windows

Voir également

• La version originale de cette page en anglais