Elŝuto

Ĉi tiu paĝo provizas bazajn paŝojn por instali JOSM kaj informojn pri solvado de problemoj. Por komenci labori kun JOSM bonvolu viziti la paĝojn Introduction kaj Help. Kaj por tre kompleksaj problemoj vidu Instalaj Notoj.

Rekomenditaj opcioj

Startu josm.jnlp (plej nova testita versio)
Rekomendita versio, ĉiuj platformoj, aŭtomata ĝisdatigo al la plej nova testita versio ĉiumonate (kiel starti).

Elŝutu josm-tested.jar (testita versio 19396)
Ĉiuj platformoj (kiel ruli).

Ĉiuj elŝutaj opcioj

Ĉiu monato la teamo de JOSM eldonas testitan version por elŝuto. La MS Windows kaj Apple macOS variantoj estas konstruitaj sur ĉi tiu testita versio. Kiam vi klakas sur josm.jnlp por lanĉi JOSM, vi ĉiam ricevos la plej novan testitan version. La Web Start de Java estas la mekanismo malantaŭ ĉi tio.

Ĉiu nokto la konstruaj sistemoj generas plej novan version. Ĉi tiuj versioj povus havi gravajn erarojn. Sed plejparte ili ankaŭ funkcias bone. Por la plej nova versio ankaŭ estas havebla Web Start varianto.

	Por ĉiuj operaciumoj						Disvolvo
Versio	Web Start	Elŝuto	Windows	Apple macOS	Ubuntu, Debian…	openSUSE	Jar / Javadoc / Fonto
testita 19396	josm.jnlp	josm-tested.jar	josm-setup.exe josm-setup.msi ​Microsoft Store (vidu sube)	JOSM macOS .zip pako aŭ (homebrew)	vidu sube	vidu sube	josm:19396
plej nova 19405	latest.jnlp	josm-latest.jar	vidu ​eldonoj en github	vidu ​eldonoj en github	vidu sube		Uzu momentfotojn
pli malnovaj		elŝuto/	vidu ​eldonoj en github	vidu ​eldonoj en github	pool/		testitaj versioj

Kiam vi rulas skriptojn, bonvolu unue kontroli ĉe plej nova, testita aŭ ĉiuj por redukti elŝutan bendolarĝon.

Forigu tradukojn
Se elŝuta grandeco estas problemo, pli malgrandaj dosieroj de la testita versio estas haveblaj. Por elŝutoj enhavantaj nur la anglan, aldonu ?lang=en al la URL. Por inkludi unu tradukon, anstataŭigu en per la lingva kodo (en) kiun vi volas (minuskle la unuan literon, subtenataj lingvoj nur). Vi povas plu redukti la dosiergrandecon per forigi la subskriban informon per aldoni ?unsigned=1.

Linuksaj Deponejoj

JOSM's Debia bazo ĉefe por Ubuntu

Ĉi tiu estas nia propra paka deponejo ĉefe por Ubuntu. Ĝi devus ankaŭ funkcii kun aliaj Debia bazitaj (precipe Ubuntu bazitaj) distribuaĵoj, sed ni ne aktive testas kaj prizorgas iujn ajn distribuaĵojn krom Ubuntu.

La deponejo enhavas du pakojn:

• josm – Provizas la testitan version (stabila). Anstataŭas la pakon el la oficiala deponejo de via distribuaĵo. La defaŭlta nomo de JOSM dosierujoj estas agordita al JOSM.
• josm-latest – La plej nova versio (nokta). Povas esti instalita paralela al la josm pako, tial la defaŭlta nomo de JOSM dosierujoj estas agordita al JOSM-latest.

Ambaŭ pakoj provizas /etc/default/josm respektive /etc/default/josm-latest kiel agordan dosieron por java opcioj.

Krom la regula procedo priskribita sube, pli malnovaj DEB-oj povas esti mane elŝutitaj el la arkivoj.

Instalado

Redaktu la pakan resursan liston /etc/apt/sources.list.d/josm.list:

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

kaj aldonu unu el la sekvaj linioj laŭ via Ubuntu-Versio:

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

# Por aliaj Debian bazitaj distribuaĵoj aldonu:
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe

Alternative, ĉi tio povas esti farita per la sekva unulinio en Ubuntu (ne por Ubuntu bazitaj distribuaĵoj kiel 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

aŭ por 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

Elŝutu la publikan ŝlosilon:

# Kreu la dosierujon por mane elŝutitaj ŝlosiloj se ĝi ne estis jam kreita
sudo mkdir -p /usr/local/share/keyrings
# Elŝutu la ŝlosilon
wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg

En la pasinteco, instrukcioj uzis apt-key. Se la ŝlosilo estis aldonita al la sistems ŝlosilaro, la sekva linio forigos ĝin:

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

Nun refreŝigu viajn fontojn:

# Vi eble bezonas instali ssl subtenon por apt antaŭe:
sudo apt-get install apt-transport-https
# Refreŝigu fontojn
sudo apt-get update

kaj instalu:

# Vi povas ignori ĉi tiun unuan linion se ĉi tiuj pakoj ne estis instalitaj antaŭe.
sudo apt-get remove josm josm-plugins

# Por la testita versio
sudo apt-get install josm
# Por la disvolva versio
sudo apt-get install josm-latest

GNU Debian

Niaj propraj Ubuntu pakoj, supre, funkcias sur Debian kaj ni rekomendas uzi ilin. Depende de la agordo de sudo, kelkaj instrukcioj ne funkcios kiel "normala" uzanto sed nur kiel root.

La testita versio de ​JOSM estas havebla sub main en sekcio utils, sed la versio kutime estas sufiĉe malnova.
Bonvolu uzi la ​malantaŭenportan deponejon por ricevi pli ĝisdatigitan version, vidu ​Instrukcioj. Ĉi tiu versio povus ankoraŭ esti pli malnova ol niaj propraj pakoj.

Ekde Debia 11 (bullseye) la ​josm-installer estas havebla sub main en sekcio utils. Ĝi elŝutas la aktualan .jar dosieron de ĉi tiu retejo kaj ĝisdatigas ĝin se necese.

openSUSE

La testita versio de JOSM estas havebla en la Application:Geo deponejo.

Unue aldonu kiel radika uzanto en yast aŭ per zypper la deponejon (por Tumbleweed anstataŭigu $releasever per openSUSE_Tumbleweed):

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

Tiam simple instalu josm kaj josm-fonts pakojn.

Solvado de problemoj

Java

Kiam vi duoble klakas sur jar dosiero kaj nenio okazas, en plej multaj kazoj ĉi tio signifas ke Java ne estas instalita.

JOSM nun rekomendas ​Azul aŭ ​Bellsoft Liberica JDK-ojn. Ĝenerale, la aktuala Java LTS devus esti preferata (nuntempe, tio estus Java 17), sed Java 11 funkcios. Vidu la README​ por aktualaj rekomendoj. Sed unue provu la Java jam distribuitan kun la operaciumo, ​ekzemple.

Kiam vi elektas elŝuton, memoru:

• Java Kromprogramo por retumiloj ne estas bezonata por ruli JOSM. Tial rezultoj de paĝoj kiel www.java.com/en/download/installed8.jsp ne estas gravaj.
• Java varianto kun 64 bitoj estas rekomendita por JOSM. La arkitekturo de la operaciumo estas grava por decidi inter 32 bita Java aŭ 64 bita Java. Ĉar JOSM ne estas influita de la arkitekturo de la retumilo, plej multaj rekomendoj sur ĉi tiu paĝo www.java.com/en/download/faq/java_win64bit.xml ne estas gravaj.
• Evitu paĝojn kiel www.java.com/en/download kiuj intencas meti Java Kromprogramojn en retumiloj. Kaj ĉi tio ne estas grava por JOSM.

Por plia informo vizitu la Instalaj Notoj kaj ​solvado de problemoj paĝojn. Java en ĉi tiu sekcio signifas JRE (Java Runtime Engine) kiu provizas JVM (Java Virtual Machine) por ruli JOSM, Java programo kiu estas disvolvita uzante JDK (Java Development Kit) kaj kelkfoje lanĉita per JNLP (Java Network Launch Protocol aka Web Start kaj posteulo de Java Kromprogramoj).

Testado de Java

Kontrolas ĉu Java estas instalita kaj kial JOSM ne startas (ekzemplo ĉefe por MS Windows).

1. Elŝutu josm-tested.jar al via labortablo.
2. Malfermu Komandan Prompton aka Terminalo
3. Tajpu cd %homepath%⏎ kaj tajpu cd Desktop⏎
4. Tajpu java -version ⏎ Tri linioj kun la versiaj datumoj devus aperi. Se vi vidas ion alian, tiam Java ne estas ĝuste instalita.
5. Tajpu java -jar josm-tested.jar⏎. Nun JOSM devus ruliĝi, startita de la Komanda Linio.
6. Fermu JOSM.
7. Tajpu josm-tested.jar⏎. Se JOSM startas denove, la Windows Explorer estas preta por duoblaj klakoj sur jar dosieroj.

Web Start

Vi devas unue instali ​OpenWebStart. Ĝi elŝutos kaj rulos Java per si mem. Bonvolu uzi la 64-bitan (x64) version de OpenWebStart se vi estas en Microsoft Windows. La transiro de Oracle WebStart al OpenWebStart estas daŭranta, do en kazo de problemo bonvolu krei novan bileton aŭ afiŝi komenton al #17858.

Vi eble bezonos ĝisdatigi la defaŭltan aplikaĵon por malfermi JNLP-dosierojn se vi antaŭe uzis Oracle WebStart. Vidu ​jnlp-dosierasocion por instrukcioj pri agordado de OpenWebStart kiel la defaŭlta programo por jnlp-dosieroj.

Testado de Web Start

1. Elŝutu josm.jnlp al via labortablo.
2. Malfermu Terminalon kaj movu vin al la Labortablo kiel supre
3. Tajpu javaws josm.jnlp⏎. Ĉi tio unue elŝutos JOSM, montros sekurecan dialogon kaj poste lanĉos JOSM.
4. Se tio malsukcesas, tajpu javaws -verbose josm.jnlp⏎. Ĉi tio unue montros dialogon kun informoj pri la JVM kaj poste lanĉos JOSM.

Virtuala Maŝino

Memoro elĉerpita

Nuntempe mane kontroli la memoron de Java estas malofte necesa ĉar la disponebla RAM en komputiloj kreskis. Malĝuste elektitaj valoroj povas malpliigi la efikecon de JOSM.

Por kelkaj taskoj, JOSM havas grandan apetiton por memoro. Unuflanke, eblas necese agordi memorgrandecon kiu subtenas pli da kromprogramoj kaj funkcioj. Aliflanke, malrapidaj maŝinoj povas esti stabiligitaj per limigado de la memora uzo de Java. Se necese, uzu la komandan linion por agordi la ​Java Option -Xmx…m, ekzemple -Xmx512m aŭ -Xmx1536m. En Debian/Ubuntu vi povas redakti la dosieron /etc/default/josm respektive /etc/default/josm-latest.
Antaŭe, malnovaj java programoj akceptis -Xmx=512m aŭ eĉ -Xmx 512m. Nun tiuj misformitaj argumentoj ĵetas erarmesaĝojn.

VM-elekto

En aktualaj versioj de MS Windows defaŭlte Java estas instalita ĉefe en la dosierujo C:\Program Files\Java\. Aldonaj partoj estas metitaj en C:\Program Files\Oracle\Java\. Ekzistas dosierujo .\javapath\ kiel celo por la PATH media variablo. Ĝi estas la hejmo por la tri virtualaj dosieroj java.exe, javaw.exe kaj javaws.exe. Ĉi tiuj dosieroj estas simbolaj ligoj de la aktualaj Java instalaĵoj.

En malnovaj versioj de 64-bitaj Windows kelkfoje la 32-bita reĝimo JRE estis aldone instalita. Ankaŭ kelkaj retumiloj alportis sian propran JVM kun limigitaj kapabloj. En tiuj kazoj Web Start el la retumilo ne uzus vian Java instalaĵon sed tiun de la retumilo.

Kontrolu, ke ne ekzistas alia javawebstart en \Windows\SysWow64. La Java kontrolpanelo ne detektos ĝin kaj vi povas sekure forigi ĝin. Faru purigon kaj konservu nur la plej novajn versiojn de ĉiu JRE (Unu por la 32-bita reĝimo, alia por la 64-bita reĝimo).

Por fulmoklavoj kreitaj sur la labortablo por JNLP kaj rulado de la Javawebstart lanĉilo, certigu, ke vi pasas VM-parametrojn kun prefikso -J kaj sen intera spaco antaŭ la VM-opcio. Se vi instalis ambaŭ la 32-bitajn kaj 64-bitajn versiojn, vi devus pasi la opcion "-d64" se vi volas elekti la preferatan 64-bitajn VM. Notu, ke kelkaj Oracle dokumentaj paĝoj indikas la opcion "-D64" kun malĝusta majusklo!)

Ekzemplo de redaktita komanda linio por fulmoklavo sur la windows labortablo:

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

Microsoft Windows

josm.exe

Uzado de josm-setup.exe por instalado en Microsoft Windows faras la jenon:

• Metas du ruleblajn dosierojn JOSM.exe kaj HWConsole.exe en la dosierujon %LOCALAPPDATA%\JOSM
• Registras JOSM.exe kiel celon por la dosieraj etendaĵoj *.osm, *.geojson, *.gpx, *.jos kaj *.joz.
• Metas JOSM fulmoklavajn ikonojn sur la Labortablon kaj en la Startmenuon.
• Aldonas malinstalajn datumojn en la konvenajn lokojn.

Kiam startas, JOSM.exe startas JOSM kun enigita versio de Java prizorgata de JOSM disvolvistoj, bazita sur Azul Zulu. JOSM.exe agas kiel envolvaĵo kaj estas portebla.

HWConsole.exe similas al JOSM.exe sed startas JOSM dum tenante malferma Windows konzolon montranta la norman eligon de JOSM (protokolojn).

JOSM.exe akceptas ĉiujn kutimajn JOSM Programajn argumentojn. Vidu ekzemplon:

# Ŝarĝu OSM-datumojn
josm.exe https://www.osm.org/way/476702262

Por doni Java-opciojn al la Java VM, JOSM.exe uzas la agordan dosieron JOSM.cfg en sia app sub-dosierujo. En ĉi tiu dosiero, ĉiu opcio devas esti sur aparta linio.

Ekzemple, por ŝanĝi memoran asignadon, malfermu %LOCALAPPDATA%\JOSM\app\JOSM.cfg kaj aldonu java-options=-Xmx8192m (por 8 GB) al nova linio sub la titolo [JavaOptions].

Grafikaĵoj

Kelkaj Windows instalaĵoj havas problemojn kun grafikaĵaj peliloj (vidu #23784 por ekzemplo). Ĉi tio povas montri simptomojn kiel:

• Nigraj strioj en JOSM ilobretoj
• Flickering
• Aliaj neatenditaj uzantinterfazaj problemoj

1. Elŝutu kaj instalu Display Driver Uninstaller (DDU, ​fonto) de la oficiala spegulo => ​https://www.wagnardsoft.com/display-driver-uninstaller-DDU-
2. El la "Device Type" falmenuo dekstre, elektu "GPU". DDU aŭtomate detektos la GPU kiun vi uzas.
3. Klaku sur "Clean and Restart" ĉe la supro. Ĉi tio malinstalos la grafikaĵajn pelilojn kaj restartos vian PC.
4. Reinstalu la pelilojn.

AVERTO: Kreu sekurkopion de via PC antaŭ ol uzi DDU. Kvankam ĝi kreas restaŭran punkton per si mem, estas ideale fari unu mem por ĉiuokaze.

macOS

Uzado de brew

macOS uzantoj povas uzi la ​homebrew paka administrilo por instali kaj ĝisdatigi sian JOSM-instalon.

En Terminalo, rulu brew install --cask josm por instali aŭ brew upgrade --cask josm por ĝisdatigi al la aktuala testita versio de JOSM.

Linukso

Arch Linux

Uzante AUR vi povas instali ​openwebstart-bin.

Se vi uzas ​icedtea-web anstataŭ la rekomendita openwebstart vi ricevos eraron kun la plej nova java. java-17-openjdk estas konata funkcii, sed java-22-openjdk ne.

Konataj problemoj

Ne fermitaj problemoj pri …:

• Java-problemoj - kelkaj el la cimoj kondukas al blokiloj en Oracle JVM (kovrita ĉe JavaBugs).
• Linukso
• Ubuntu
• macOS
• Windows