Aðrar tungumál:
Innihaldstavla
Niðurhal
Henda síðan gevur grundleggjandi JOSM-installatiónstrinn og villuleitingar kunning. Fyri at byrja arbeiða við JOSM, vinaliga síggj Introduction og Help síðurnar. Og fyri sera flóknum trupulleikum, síggj Installatións notatir.
Tilráðnu valmøguleikar
Byrja josm.jnlp (nýggjasta provaða útgávan)
Tillikin útgáva, allar stýrikerfi, sjálvvirk uppdatering til nýggjasta provaða útgávan mánaðarliga (hvussu byrja skal).
Tak niður josm-tested.jar (provað útgáva 19439)
Allar stýrikerfi (hvussu koyra skal).
Allir niðurhal valmøguleikar
Eingin mánaðin gevur JOSM-bólkurin út eina provaða útgávu fyri niðurhal. MS Windows og Apple macOS variantirnar eru bygdar á hesi provaða útgávu. Tá ið tú klikkar á josm.jnlp fyri at byrja JOSM, fært tú altíð nýggjasta provaða útgávuna. Java's Web Start er mekanismin bakvið hetta.
Eingin nátt framleiða byggiskipanirnar eina síðstu útgávu. Hesar útgávur kunnu hava alvarlegar feilir. Men mest allar virka tey væl eisini. Fyri síðstu útgávuna er eisini ein Web Start-variant tøk.
| Fyri øll stýrikerfi | Útvikling | |||||||
|---|---|---|---|---|---|---|---|---|
| Útgáva | Web Start | Niðurhal | Windows | Apple macOS | Ubuntu, Debian… | openSUSE | Arch Linux | Jar / Javadoc / Kelda |
| provað 19439 | josm.jnlp | josm-tested.jar | josm-setup.exe josm-setup.msi Microsoft Store (sí niðanfyri) | JOSM macOS .zip-pakki ella (homebrew) | sí niðanfyri | sí niðanfyri | sí niðanfyri | josm:19439 |
| síðsta 19450 | latest.jnlp | josm-latest.jar | sí útgávur á github | sí útgávur á github | sí niðanfyri | sí niðanfyri | Nýt snapshots | |
| eldri | niðurhal/ | sí útgávur á github | sí útgávur á github | pool/ | provaðar útgávur | |||
Tá ið tú koyrir skript, vinaliga kanna fyrst síðstu, provaðu ella allar fyri at minka niðurhal bandvídd.
Stripp umsetingar
Um niðurhalstødd er eitt trupulleika, eru minni fílur av tí provaða útgávuni tøkar. Fyri niðurhals ið bert innihalda enskt, legg til ?lang=en í URL-in. Fyri at innifara eina umseting, skift en við málkota (en) tú ynskir (lítil fyrsti bókstavur, bert stuðlað mál). Tú kanst minka fílustøddina meira við at strippa av undirskriftar kunningini við at leggja til ?unsigned=1.
Linux Pakka Savnar
JOSM's Debian bygt fyri Ubuntu fyri øll
Hetta er okkara egna pakka savn fyri Ubuntu fyri øll. Tað skal eisini virka við øðrum Debian bygdum (serstakliga Ubuntu bygdum) útbýtingum, men vit kanna og viðlíka ikki aktivar øðrar útbýtingar enn Ubuntu.
Savnin inniheldur báðar pakkur:
- josm – Gevir provaða útgávuna (støðug). Skiftir pakkan frá tí almenna savninum á tínari útbýting. Sjálvsettu JOSM-mappa navnið er sett til
JOSM. - josm-latest – Síðsta útgávan (hvønn nátt). Kann verða installerað samsíða við josm-pakkuna, tí er sjálvsettu JOSM-mappa navnið sett til
JOSM-latest.
Báðar pakkurnar geva /etc/default/josm hvørt um annað /etc/default/josm-latest sum stillinga fílu fyri java valmøguleikar (en).
Umframt vanliga ferðina lýst niðanfyri, kunnu eldri DEB fílur verða tikkaðar niður handaliga frá savnunum.
Installatión
Rætta pakka keldu listan /etc/apt/sources.list.d/josm.list:
sudo editor /etc/apt/sources.list.d/josm.list
og legg til eina av fylgjandi linjum samsvariandi tínari Ubuntu-útgávu:
deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt oracular universe deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe # Fyri aðrar Debian bygdar útbýtingar legg til: deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe
Alternativt, kann hetta verða gjørt við fylgjandi ein-linju í Ubuntu (ikki fyri Ubuntu bygdar útbýtingar sum Linux Mint):
echo "deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(lsb_release -sc) universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
ella fyri Linux Mint:
echo "deb [signed-by=/etc/apt/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
Tak niður almenna lykilin:
sudo curl https://josm.openstreetmap.de/josm-apt.key -o /etc/apt/keyrings/josm-apt.gpg
Í fyrrverandi leiðbeiningum varð apt-key brúkt. Um lykilin varð lagdur til skipanar lykilringin, vil fylgjandi linja stripa hann. Hetta er ongantíð neyðugt, uttan so at tað forðar JOSM frá at undirskriva pakkar ið IKKI eru josm.
sudo apt-key del $(apt-key list | grep -B1 "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57)
Nú dagfør tínar keldur:
# Tú kanskje mást installera SSL stuðul fyri apt áður: sudo apt-get install apt-transport-https # Dagfør keldur sudo apt-get update
og installera:
# Tú kanst hoppa um hesa fyrstu linjuna um hesar pakkurnar vóru ikki installeraðar áður. sudo apt-get remove josm josm-plugins # Fyri provaða útgávuna sudo apt-get install josm # Fyri útviklings útgávuna sudo apt-get install josm-latest
GNU Debian
Okkara egna Ubuntu pakkur, omanfyri, virka á Debian og vit tilráða at nýta teir. Áhugað av uppsetingini av sudo, viljar nakaðar leiðbeiningar ikki virka sum "vanlig" brúkari, men bert sum root.
Provaða útgávan av JOSM er tøk undir main í partinum utils, men útgávan er vanliga gomul.
Vinaliga, nýt bakút savnið fyri at fáa eina meira dagførd útgávu, sí Leiðbeiningar. Henda útgávan kann enn vera eldri enn okkara egna pakkur.
Síðan Debian 11 (bullseye) er josm-installer tøkur undir main í partinum utils. Hon takar niður núverandi .jar fíluna frá hesi síðu og dagførir hana um neyðugt.
openSUSE
Provaða útgávan av JOSM er tøk í Application:Geo savninum.
Legg fyrst til sum root brúkari í yast ella við zypper savnið (fyri Tumbleweed skift $releasever við openSUSE_Tumbleweed):
zypper ar -f 'https://download.opensuse.org/repositories/Application:/Geo/$releasever' Application:Geo
Innstaller so einfaldliga josm og josm-fonts pakkurnar.
Arch Linux
Tað almenna savnið inniheldur josm pakkuna, ið kann verða installerað við pacman -S josm.
Arch brúkara savnið (AUR) inniheldur umframt josm-latest pakkuna við síðstu útgávu av JOSM.
Nýt tín AUR hjálpara fyri at installera hesa pakkuna.
Báðar pakkurnar eru triðja part pakkur og ikki viðlíkaðar av JOSM-bólkinum.
Villuleiting
Java
Tá ið tú dobbelt-klikkar á eina jar fílu og eingin ting hendir, merkir tað í flestu førum at Java ikki er installerað.
JOSM tilráðir nú Azul ella Bellsoft Liberica JDK'ir. Almennliga talð, skal núverandi Java LTS verða frammanfyri (á skrivingartíðpunktinum, hetta var Java 21), men Java 11 vil virka. Sí README fyri núverandi tilráðingar. Men royn fyrst Java ið longu er útbýtt við stýrikerfinum, til dømis.
Tá ið tú velur eitt niðurhal, minst á:
- Ein Java Plug-in fyri kaggar er ikki neyðugur fyri at koyra JOSM. Tí eru úrslit frá síðum sum www.java.com/en/download/installed8.jsp ikki relevant.
- Ein Java variant við 64 bitum er tilráð fyri JOSM. Stýrikerfi bygningsskapurin er týdningarmikil fyri at velja ímillum 32 bit Java ella 64 bit Java. Tí at JOSM er ikki ávirkaður av kagga bygningsskapanum, eru flestu tilráðingar á hesi síðu www.java.com/en/download/faq/java_win64bit.xml ikki relevantar.
- Forða fyri síðum sum www.java.com/en/download ið hava sum endamál at seta Java Plug-ins í kaggar. Og hetta er ikki týdningarmikið fyri JOSM.
Fyri meiri kunning, vitja Installatións notatir og villuleiting síðurnar. Java í hesum partinum merkir ein JRE (Java Runtime Engine) ið gevur ein JVM (Java Virtual Machine) fyri at koyra JOSM, eitt Java-program ið er framt við at nýta JDK (Java Development Kit) og onkuntíð byrjað við JNLP (Java Network Launch Protocol aka Web Start og arvingur av Java Plug-ins).
Kanning av Java
Kannar um Java er installerað og hví JOSM byrjar ikki (dømi høvuðsliga fyri MS Windows).
- Tak niður josm-tested.jar til títt skriviborð.
- Opna ein stýriboð skipan ella Terminal
- Skriva
cd %homepath%⏎ og skrivacd Desktop⏎ - Skriva
java -version⏎ Tríggjar linjur við útgávu dátuni eiga at vísa seg. Um tú sær eitt annað, so er Java ikki rætt installerað. - Skriva
java -jar josm-tested.jar⏎. Nú á JOSM at koyra, byrjað frá Stýriboð skipanini (en). - Frágreið JOSM.
- Skriva
josm-tested.jar⏎. Um JOSM byrjar aftur, so er Windows Explorer klárur fyri dobbelt klikk á jar fílur.
Web Start
Tú mást fyrst installera OpenWebStart. Tað vil taka niður og koyra Java av sjálvum. Vinaliga nýt 64 bita (x64) útgávuna av OpenWebStart um tú ert á Microsoft Windows. Umstillingin frá Oracle WebStart til OpenWebStart er enn í gongd, so um trupulleiki, vinaliga upprætta eina nýggja ticket ella skriva eina viðmerking til #17858.
Tú kanskje mást dagføra sjálvsettu applikatiónina fyri at opna JNLP fílur um tú hevur brúkt Oracle WebStart áður. Sí [jnlp fílu sambinding](https://openwebstart.com/docs/OWSGuide.html#_jnlp_file_association) fyri leiðbeiningar um at seta OpenWebStart sum sjálvsettu programið fyri jnlp fílur.
Kanning av Web Start
- Tak niður josm.jnlp til títt skriviborð.
- Opna ein Terminal og flyt til Skriviborðið sum omanfyri
- Skriva
javaws josm.jnlp⏎. Hetta á fyrst at taka niður JOSM, vísa ein trygdardialog og so byrja JOSM. - Um tað miseydnast, so skriva
javaws -verbose josm.jnlp⏎. Hetta á fyrst at vísa ein dialog við kunning um JVM og so byrja JOSM.
Virtual Vél
Úti av minni
Nú til dags er handvirk stýring av Java minni sjaldan neyðug vegna tá at tøkt RAM á telvum er vaksið. Rangt valdar gildi kunnu minka JOSM framførslu.
Fyri summar arbeiðslur, hevur JOSM stóran mat á minni. Á annari síðu, kann tað vera neyðugt at stilla eina minnisstødd ið stuðlar fleiri plugins og funktiónir. Á hinum síða, kunnu pælar telvur verða støðgaðar við at takmarka Java minnisnýtslu.
Um neyðugt, nýt stýriboð skipanina (en) fyri at seta [Java valmøguleikin](https://docs.oracle.com/en/java/javase/11/tools/java.html#GUID-3B1CE181-CD30-4178-9602-230B800D4FAE__BABHDABI) -Xmx…m, til dømis -Xmx512m ella -Xmx1536m. Í Debian/Ubuntu kanst tú rætta fíluna /etc/default/josm hvørt um annað /etc/default/josm-latest.
Áður fyrr tóku eldri java forrit -Xmx=512m ella jafnvel -Xmx 512m. Nú kasta hesi rongu stillingar villuboðum.
VM val
Á núverandi útgávum av MS Windows er Java sjálvset uppsett høvuðsliga í C:\Program Files\Java\ mappuni. Viðbótar partar eru settir í C:\Program Files\Oracle\Java\. Tað er ein .\javapath\ mappa sum mál fyri PATH umhvørvisbroytin. Hon er heim fyri tríggjar virtual fílurnar java.exe, javaw.exe og javaws.exe. Hesar fílur eru symboliskir leinkjur frá núverandi Java uppsetingum.
Á eldri útgávum av 64 bita Windows var stundum 32 bita háttur JRE umframt uppsettur. Eisini fóru summar kaggar við teirra egna JVM við takmarkaðum møguleikum. Í hesum førum myndi ein Web Start frá kagganum ikki nýta tína Java uppseting men tína frá kagganum.
Kanna um tað ikki er onnur javawebstart í \Windows\SysWow64. Java stýripallið mun ikki kenna hana og tú kanst tryggleika stripa hana. Útfør rudding og halt bert nýggjastu útgávurnar av hvørjum JRE (Ein fyri 32-bita hátt, ein onnur fyri 64-bita hátt).
Fyri flýtileiðir upprættaðar á skriviborðinum fyri JNLP og koyring av Javawebstart byrjarinum, ver vísur um at senda VM parametrar forskeytt við -J og uttan ímillum rúm fyri frammanfyri VM valmøguleikin. Um tú hevur sett upp bæði 32-bita og 64-bita útgávurnar, eigur tú at senda valmøguleikin "-d64" um tú ynskir at velja valda 64-bita VM. Minst á at summar Oracle skjalsíður vísa valmøguleikin "-D64" við rongari stórum/lítlum bókstavum!)
Dømi um rættaða stýriboð skipanina fyri ein flýtileið á Windows skriviborðinum:
javaws.exe -J-d64 -J-Xmx2048m josm.jnlp
Microsoft Windows
josm.exe
Nýtsla av josm-setup.exe fyri uppseting á Microsoft Windows gerir eftirfylgjandi:
- Setur tvær koyrslu fílur
JOSM.exeogHWConsole.exeí mappuna%LOCALAPPDATA%\JOSM - Skráir JOSM.exe sum mál fyri fílu endingarnar
*.osm,*.geojson,*.gpx,*.josog*.joz. - Setur JOSM flýtileiðir á Skriviborðið og í Byrjan valmyndina.
- Leggur til avuppsetingar dátur á hóskandi støðum.
Tá ið byrjað verður, byrjar JOSM.exe JOSM við eini innbygdu útgávu av Java viðlíkað av JOSM útviklarum, bygt á Azul Zulu. JOSM.exe arbeiðir sum ein wrapper og er portable.
HWConsole.exe líkist JOSM.exe men byrjar JOSM meðan hon heldur einum Windows konsoll opnum ið vísur JOSM standard úttak (logger).
JOSM.exe tekur ímóti øllum vanligum [JOSM Program argumentum](wikitr:/Help/CommandLineOptions#Programarguments (en)). Sí dømi:
# Innles OSM dátur josm.exe https://www.osm.org/way/476702262
Fyri at geva [Java valmøguleikar](wikitr:/Help/CommandLineOptions#Javaoptions (en)) til Java VM, nýtur JOSM.exe stillinga fíluna JOSM.cfg í sínari app undirmappu. Í hesi fílu, má hvør valmøguleiki vera á sínari egnalinju.
Til dømis, fyri at broyta minnisútdeling, opna %LOCALAPPDATA%\JOSM\app\JOSM.cfg og legg til java-options=-Xmx8192m (fyri 8 GB) til eina nýggja linju undir [JavaOptions] yvirskriftini.
Grafikk
Summar Windows uppsetingar hava skjákaffi driver trupulleikar (sí #23784 fyri eitt dømi). Hetta kann vísa symptom sum:
- Svartar stongir í JOSM amboðsstongum
- Fløkt
- Aðrir óvæntaðir brúkaraflatan trupulleikar
- Tak niður og sett upp Display Driver Uninstaller (DDU, [kelda](https://github.com/Wagnard/display-drivers-uninstaller)) frá tí almenna speglingar ambætaranum => https://www.wagnardsoft.com/display-driver-uninstaller-DDU-
- Frá "Device Type" (Tøkt slag) fellilistanum til høgru, vel "GPU". DDU mun sjálvvirkandi kenna GPU'ið tú nýtur.
- Klikk á "Clean and Restart" (Rudda og byrja umaftur) ovast. Hetta mun avuppseta skjákaffi driverarnar og byrja tína telvu umaftur.
- Sett driverarnar upp aftur.
ÁVARSNING: Upprætta eitt trygdaraftrit av tínari telvu áðrenn tú nýtur DDU. Tó at tað upprættar ein umafturkomustað av sjálvum, er tað fullkomið at gera ein sjálvur bara fyri at vera á tryggari síðu.
macOS
Nýta brew
macOS brúkarar kunnu nýta [homebrew](https://brew.sh/) pakki handfararan fyri at seta upp og dagføra teirra JOSM tilfari.
Í Terminal, koyr brew install --cask josm fyri at seta upp ella brew upgrade --cask josm fyri at dagføra til núverandi provaðu útgávu av JOSM.
Linux
Arch Linux
Við at nýta AUR kanst tú seta upp [openwebstart-bin](https://aur.archlinux.org/packages/openwebstart-bin).
Um tú nýtur [icedtea-web](https://archlinux.org/packages/extra/x86_64/icedtea-web/) í staðin fyri tína tilráðnu openwebstart, fært tú ein villa við nýggjasta java. java-17-openjdk er kent fyri at virka, men java-22-openjdk ger tað ikki.
Kend trupulleikar
Ikki latið mál um …:
- Java trupulleikar - summar av teim villunum leiða til blokeringar í Oracle JVM (døkt á [JavaBugs](wiki:JavaBugs)).
- Linux
- Ubuntu
- macOS
- Windows


