[[TranslatedPages(revision=213)]] [[PageOutline(2-3,Table des Matières)]] = 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'[wikitr:/Introduction Introduction à JOSM] et d'[wikitr:/Help Aide]. Et pour les questions très complexes, voir les [wikitr:/InstallNotes Notes d'Installation]. == Options recommandées ==#Recommendedoptions [[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Lancer [/download/josm.jnlp 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'' ([#Webstart comment Démarrer]) \\ actuellement la dernière version stable de JOSM est [[Version(tested)]] [[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **Télécharger [/josm-tested.jar josm-tested.jar]** (version stable [[Version(tested)]]) \\ toutes plateformes ([#Java comment le lancer]). \\ \\ == Toutes les options de téléchargement ==#Moredownloadoptions Chaque [/roadmap mois] l'équipe de JOSM [wikitr:/Releases 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 [wikitr:/InstallNotes#Webstart Web Start] de Java est le mécanisme derrière tout cela. [=#DevelopmentVersion] Chaque [/log/josm/?verbose=on&limit=20 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 [[Version(tested)]]** || \ || [/download/josm.jnlp josm.jnlp] || \ || [/josm-tested.jar] || \ || \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ [/download/windows/josm-setup.msi josm-setup.msi] \\ [https://apps.microsoft.com/store/detail/josm/XPFCG1GV0WWGZX Microsoft Store]\\ ''([#Mswindowswrapper voir ci-dessous])'' || \ || \\ [/download/macosx/josm-macosx.zip package .zip macOS de JOSM] \\ ''ou ([#macOS homebrew])'' || \ || ''[#Ubuntu voir ci-dessous]'' || \ || ''[#Opensuse voir ci-dessous]'' || \ || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm] : version [[Version(tested)]] || ||**développement [[Version(latest)]]** || \ || [/download/josm-latest.jnlp latest.jnlp] || \ || [/josm-latest.jar] || || || \ || ''[#Ubuntu voir ci-dessous]'' || || \ || [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Utiliser snapshots] || ||=''**plus anciennes**'' =|| || \ || [/download/ répertoire de téléchargement download/] || || \ || [https://github.com/openstreetmap/josm/releases automatic JOSM.app builds] || \ || [/apt/pool/universe/j/ répertoire de téléchargement pool/] || || \ || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ versions stables] || Lorsque vous exécutez des scripts, veuillez d'abord vérifier sur la version de [/latest développement], [/tested stable] ou [/version toutes] pour réduire la bande passante de téléchargement. ** Strip translations **[=#Striptranslations] \\ 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 [/josm-tested.jar?lang=en ?lang=en] à l'URL. Pour inclure une traduction, remplacez `en' par le [wikitr:/TracLanguages code de langue] 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 [/josm-tested.jar?lang=en&unsigned=1 ?unsigned=1]. == Dépôts Linux == === Le Debian de JOSM basé principalement pour Ubuntu ===#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 [wikitr:Help/CommandLineOptions#Javaoptions 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 [/apt/pool/universe/j/ archives]. ==== Installation ==== Modifier la liste des ressources du paquet `/etc/apt/sources.list.d/josm.list` : {{{#!sh sudo editor /etc/apt/sources.list.d/josm.list }}} {{{#!comment ### la ligne ci-dessous ne fonctionne pas sur les systèmes GNU Debian `sudo $EDITOR /etc/apt/sources.list.d/josm.list` }}} et ajoutez l'une des lignes suivantes selon votre version Ubuntu : {{{#!sh 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 mantic universe 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 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) : {{{#!sh 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 : {{{#!sh 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 }}} {{{#!comment ### ci-dessous n'a pas fonctionné sur tous les systèmes et ajoutez la ligne suivante : {{{#!sh `deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` }}} }}} Téléchargez la [/josm-apt.key clé publique]: {{{#!sh # 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 : {{{#!sh sudo apt-key del $(apt-key list | grep -B1 "" | sed '$d' | cut -b 48-51,53-57) }}} Rafraîchissez maintenant vos sources : {{{#!sh # 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 : {{{#!sh # 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 ===#GNUDebian Nos propres paquets Ubuntu, [#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`. Depuis Debian 11 (bullseye), l'[https://packages.debian.org/stable/josm-installer 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. La version stable de [https://packages.debian.org/stable/josm JOSM] est disponible sous **''main''** dans la section **''utils''**, mais la version est généralement assez ancienne. \\ Veuillez utiliser le [https://backports.debian.org dépôt backports] pour obtenir la version actualisée, voir les [https://backports.debian.org/Instructions instructions (en)]. Cette version peut toutefois être assez ancienne. === openSUSE ===#Opensuse La version stable de JOSM est disponible dans le dépôt Application:Geo. [=#openSUSE] 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**) {{{#!sh 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 ==#Troubleshooting === Java ===#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 [https://www.azul.com/downloads/?version=java-21-lts&package=jdk-fx#zulu Azul] ou [https://bell-sw.com/pages/downloads/?package=jre-full#mn 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 [source:/trunk/README README (en)] pour connaître les recommandations actuelles. Mais, essayez d'abord le Java déjà distribué avec le système d'exploitation, [https://en.wikipedia.org/wiki/OpenJDK 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 [InstallNotes Notes d'Installation] et et les pages de Résolution des problèmes [https://www.java.com/en/download/help/troubleshoot_java.xml 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 ====#JavaTest [=#Troubleshootingjarfile] 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 josm-tested.jar] sur votre bureau. 1. Ouvrir une "Invite de commandes" (Terminal) 1. Tapez `cd %homepath%`⏎ puis `cd Desktop`⏎ 1. 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é. 1. Tapez `java -jar josm-tested.jar`⏎. Maintenant, JOSM devrait fonctionner, démarré à partir de la [wikitr:/Help/CommandLineOptions ligne de commande]. 1. Quittez JOSM. 1. Tapez `josm-tested.jar`⏎. Si JOSM redémarre, l'explorateur Windows est prêt pour un double clic sur les fichiers jar. === Web Start ===#Webstart [=#Troubleshootingjhlplink] Vous devez d'abord installer [https://openwebstart.com/ 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 [/newticket 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'[https://openwebstart.com/docs/OWSGuide.html#_jnlp_file_association 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 ====#Webstarttest 1. Téléchargez [/download/josm.jnlp josm.jnlp] sur votre bureau. 1. Ouvrez un terminal et déplacez-vous sur le bureau comme ci-dessus. 1. Tapez `javaws josm.jnlp`⏎. Ceci devrait d'abord télécharger JOSM, afficher une fenêtre de sécurité et ensuite lancer JOSM. 1. 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 ===#Troubleshootingjvm ==== 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 [wikitr:/Help/CommandLineOptions ligne de commande] pour définir l'[https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI 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 ====#VMselectiononWindowsx64 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 : {{{ #!sh javaws.exe -J-d64 -J-Xmx2048m josm.jnlp }}} === josm.exe Windows ===#Mswindowswrapper 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 [wikitr:/USB_Stick 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 [wikitr:/Help/CommandLineOptions#Programarguments arguments] habituels du programme JOSM. Voir l'exemple : {{{ #!sh # Il charge les données OSM josm.exe https://www.osm.org/way/476702262 }}} Pour donner les [wikitr:/Help/CommandLineOptions#Javaoptions 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 nécessite une ligne séparée. === macOS ===#macOS [=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors] {{{ #!comment titre de l'ancienne section, en gardant comme ancre pour les anciens liens }}} ==== en utilisant le gestionnaire de paquets ====#brew Les utilisateurs de macOS peuvent utiliser le gestionnaire de paquets [https://brew.sh/ 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. === Problèmes connus === Problèmes non clos sur ..... : * [/query?status=!closed&type=defect&keywords=~java Problèmes Java] - certains des bogues mènent à des blocages dans Oracle JVM (covered at [[JavaBugs]]). * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux] * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu] * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority macOS] * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows] == Voir également == * La version originale de cette page en [wiki:Download anglais]