wiki:Uk:InstallNotes

Version 3 (modified by anonymous, 15 years ago) ( diff )

--

Revision parameter missing. Current base revision is 99

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

Остання майже стабільна версія завжди знаходиться за адресою: 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

Use eclipse and the provided .project and .classpath file. Just add a new Java Project using the JOSM source folder as existing path.

If you try to compile the JOSM sources in Eclipse and get errors like "The method marktr(String) is undefined for the type SomeType" look at solution suggested at mailing list.

There are also two Videos available at youtube, which show how to checkout JOSM into Eclipse and how to checkout a JOSM plugin into Eclipse.

Using javac

You can also build josm without ant or eclipse. To do so, call javac on the file org/openstreetmap/josm/gui/MainApplication.java with all libs from ../lib/*.jar in your classpath (you have to specify all subsequent). If running Linux, this would look like that:

  • Choose the right version of the java compiler (1.6)
$ sudo update-alternatives --config javac
        There are 2 choices for the alternative javac (providing /usr/bin/javac).

          Selection    Path                                   Priority   Status
        ------------------------------------------------------------
        * 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

        Press enter to keep the current choice[*], or type selection number: 1
        update-alternatives: using /usr/lib/jvm/java-1.5.0-sun/bin/javac to provide /usr/bin/javac (javac) in manual mode.
$ export JAVA_HOME=/usr/lib/jvm/java-6-sun

(Alternatively you can provide the full path when running javac.)

  • Check out the sources
$ svn co http://josm.openstreetmap.de/svn/trunk josm
        ''tons of output here''
$ cd josm/
$ mkdir build
  • Compile and run
    $ 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
    
Note: See TracWiki for help on using the wiki.