Майже стабільна версія

Остання майже стабільна версія завжди знаходиться за адресою: ​http://josm.openstreetmap.de/download/josm-tested.jar - ми не називаємо її «випуском» тому що в той час як вона є більш надійною порівняно із тестовою версією, вона не проходить через численні перевірки потрібні для випуску стабільної версії.

Нічні збірки

Ви завжди можете отримати нічну збірку за адресою ​http://josm.openstreetmap.de/download/josm-latest.jar. Велика кількість користувачів використовують її для повсякденної роботи.

Запуск

Microsoft Windows

Подвійним клацанням на jar-файлі.

Якщо це на спрацьовує, Вам можливо встановити ​Java Runtime

Якщо ви правите дуже великі обсяги інформації, Ви можете отримати повідомлення про помилку "out of memory" (недостатньо пам’яті). Щоб цього уникнути, об’єм пам’яті можливо збільшити.
Створіть ярлик подібний до прикладу:

C:\WINNT\system32\java.exe -jar -Xmx512M "C:\PATH-TO-JOSM\josm-latest.jar"

Linux / *BSD

використовування оболонки

Перейдіть до теки де знаходиться josm-latest.jar та введіть

java -jar josm-latest.jar

для запуску. Замініть ''josm-latest.jar'' на ім’я завантаженого jar-файлу, наприклад josm.jar для стабільної версії.

Якщо це не допомогло, спробуйте встановити змінну JAVA_HOME призначивши їй місце розташування java, наприклад:

 export JAVA_HOME=/usr/lib/sun-j2se5.0-jdk
 java -jar ''josm.jar''

KDE

Ось ​посібник як налаштувати ваше оточення для запуску jar-файлів клацаючи на них.

GNOME

Клацніть правою клавішею миші на JAR-файлі та оберіть Open with "Sun Java 6.0 Runtime", чи щось подібне.

XGL/Compiz

Наберіть це в оболонці:

export AWT_TOOLKIT=MToolkit && java -jar josm-test.jar

як про це йдеться у: ​http://kubasik.net/blog/index.php/2006/06/19/java-sun-150-and-xglcompiz-on-ubuntu/

Пусте вікно при запуску

AWT до JDK7 ​не дуже добре працює з віконними менеджерами (такими як: xmonad, awesome, dwm, ratpoison, Ion3, …), в результаті головне вікно не показується правильно під час запуску. Дивись ​обхідні шляхи для вирішення цієї проблеми у Вікі Awesome. Ось також рекомендації для ​xmonad, як зробити wmname.

MacOS

1.) Якщо у вас є завантажений "josm-latest.jar", ви можете запустити JOSM клацнувши на файл josm-latest.jar у MacOS Finder (ви повинні отримати попередження про відкриття файлу отриманого з інтернет — прийміть його).

Цього достатньо для запуску JOSM у переважній кількості випадків.

2.) Однак, якщо вам треба запустити його із додатковими параметрами Java (наприклад -Xmx512M), ви можете скористатись "Терміналом" MacOS для запуску JOSM (Java) вручну:

Запустить "Термінал" (наприклад набравши "Terminal" у вікні пошуку Spotlight)

Тепер у вас є два варіанти:

a.) наберіть наступну команду та натисніть "Enter" для запуску JOSM без будь-яких особливих параметрів java (простий запуску JOSM, як в першому пункті):

java -jar FOLDER/josm-latest.jar

Де "FOLDER" замініть на назву теки з josm-latest.jar. Якщо ви завантажили файл до стандартної теки MacOS "Download", це буде виглядати так:

java -jar Download/josm-latest.jar

b.) щоб використати особливі опції java додайте їх відраз після "java"

Якщо, наприклад, у вас були випадки з повідомленням "Не вистачає пам’яті" (якщо ви намагались завантажити фотографії прив’язані до координат), ви повинні запускати JOSM наступним чином:

java -Xmx256M -jar FOLDER/josm-latest.jar

Це дозволить JOSM використовувати до 256 MB пам’яті RAM. Параметр java "-Xmx256M" задає максимальний розмір кучі Java до 265 MB. Ви можете замінити -Xmx256M будь-яким іншим, прийнятним для вашої системи значенням (-Xmx512M чи навіть -Xmx1024M).

До речі. Щоб отримати огляд всіх опцій для запуску Java, ви можете ввести:

java -help

Отримання сирців

JOSM розповсюджується під ліцензією GPL і, таким чином, ви можете отримати сирці, змінювати їх та самостійно розповсюджувати. Отримати сирці можливо за допомогою ​subversion

svn co ​http://josm.openstreetmap.de/svn/trunk josm

Ви також можете переглядати поодинокі файли черз веб-інтерфейс ​http://josm.openstreetmap.de/svn.

Компіляція

Використовуючи ant

Найпростішим способом зібрати JOSM за допомогою Java встановленій на вашому комп’ютері. Перейдіть до теки з сирцями JOSM та наберіть в терміналі:

 ant

Якщо все добре, буде створено файл dist/josm-custom.jar.

Використовуючи eclipse

Використовуйте eclipse разом із файлами .project та .classpath, що надаються. Просто додайте новій проект Java використовуючи теку із сирцями JOSM у якості існуючого шляху.

Якщо ви намагаєтесь компілювати JOSM з сирців у Eclipse та отримуєте повідомлення про помилку схожу на "The method marktr(String) is undefined for the type SomeType" гляньте на ​варіанти її вирішення у списку розсилки.

Також на YouTube є пара відео-посібників, які показують ​як отримати сирці JOSM в Eclipse та ​як отримати сирці втулків JOSM в Eclipse.

Використовуючи javac

Ви також можете зібрати JOSM із сирців без ant або eclipse. Щоб це зробити, запустіть javac з файлом org/openstreetmap/josm/gui/MainApplication.java та усіма бібліотеками з ../lib/*.jar зазначеними у змінній classpath (вам треба указати всі послідовності). Якщо у вас Linux, це буде виглядати приблизно так:

• Оберіть правильну версію компілятора java (1.6)

$ sudo update-alternatives --config javac
        Для альтернатив javac є два варіанти (надаються /usr/bin/javac).

          Вибір        Шлях                                    Пріоритет Стан
        ------------------------------------------------------------
        * 0            /usr/lib/jvm/java-6-sun/bin/javac       63        auto mode
          1            /usr/lib/jvm/java-1.5.0-sun/bin/javac   53        manual mode
          2            /usr/lib/jvm/java-6-sun/bin/javac       63        manual mode

        Натисніть enter щоб використовувати поточний вибір[*], або вкажіть номер: 1
        update-alternatives: використовує /usr/lib/jvm/java-1.5.0-sun/bin/javac для /usr/bin/javac (javac) в ручному режимі.
$ export JAVA_HOME=/usr/lib/jvm/java-6-sun

(Або ж ви можете казати повний шлях при запуску javac.)

• Отримання сирців

$ svn co http://josm.openstreetmap.de/svn/trunk josm
        ''великий обсяг виводу після цього''
$ cd josm/
$ mkdir build

• Компіляція та запуск

  $ javac -cp .:src:lib/metadata-extractor-2.3.1-nosun.jar:lib/signpost-core-1.1.jar -d build src/org/openstreetmap/josm/gui/MainApplication.java 
  $ java -cp .:build:lib/metadata-extractor-2.3.1-nosun.jar:lib/signpost-core-1.1.jar org.openstreetmap.josm.gui.MainApplication