wiki:Uk:InstallNotes

Version 1 (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/
Blank window on startup

AWT before JDK7 ​doesn't play well with non-reparenting window managers (i.e. xmonad, awesome, dwm, ratpoison, Ion3, ...), resulting in the main window not being displayed properly on startup. The Awesome Wiki has ​workarounds for this problem. There is also an ​xmonad specific way of doing the wmname thing.

MacOS

1.) If you have downloaded "josm-latest.jar" you can start JOSM by clicking on the josm-latest.jar file in the MacOS Finder (you might get the warning that you are about to open a file from the internet - just accept).

This way to start JOSM should be sufficient in most cases.

2.) However, if you need to start it up with additional Java parameter(s) (e.g. -Xmx512M) you can also use the MacOS "Terminal" and start JOSM (Java) manually:

Start the "Terminal" application (e.g. by typing "Terminal" into the Spotlight search)

Now you have two options:

a.) type in the following command and press "Enter" to start JOSM without any special java options (simply starts up JOSM like under point 1): 

java -jar FOLDER/josm-latest.jar

Whereas "FOLDER" should be replaced by the name of the folder you have josm-latest.jar downloaded to. If you have downloaded it to the standard MacOS "Download" Folder it would look like: 

java -jar Download/josm-latest.jar

b.) to use additional java options just add them right after "java"

If you for example have experienced the "Out of memory" warning (e.g. trying to load geo-tagged photos to JOSM) you would start JOSM like this: 

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

This would allow JOSM to use up to 256 MB of RAM (memory). The java option "-Xmx256M" set's the maximum Java heap size to 265 MB. You are free to replace -Xmx256M by any number appropriate for your system (e.g. -Xmx512M or even -Xmx1024M).

By the way. To get an overview of all Java start options you can type in: 

java -help

Getting the Source

JOSM is available under GPL, and so of course you can get the sources and compile, modify or redistribute it by yourself. You can grab the sources via ​subversion

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

Or you can inspect single files over the web frontend at ​http://josm.openstreetmap.de/svn.

Compiling

Using ant

The easiest way to compile JOSM provided Java on your machine is properly set up is to go to the josm directory and type: 

 ant

That will create a dist/josm-custom.jar file if successful.

Using 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.