Changes between Initial Version and Version 1 of Uk:InstallNotes

Timestamp:

2010-10-19T22:30:16+02:00 (15 years ago)

Author:

anonymous

Comment:

--

Uk:InstallNotes

@@ +1 @@
+[[TranslatedPages]]
+== Майже стабільна версія ==
+Остання майже стабільна версія завжди знаходиться за адресою: http://josm.openstreetmap.de/download/josm-tested.jar - ми не називаємо її «випуском» тому що в той час як вона є більш надійною порівняно із тестовою версією, вона не проходить через численні перевірки потрібні для випуску стабільної версії.
+
+== Нічні збірки ==
+Ви завжди можете отримати нічну збірку за адресою http://josm.openstreetmap.de/download/josm-latest.jar. Велика кількість користувачів використовують її для повсякденної роботи.
+
+== Запуск ==
+=== Microsoft Windows ===
+Подвійним клацанням на jar-файлі. 
+
+Якщо це на спрацьовує, Вам можливо встановити [http://java.com/download/index.jsp Java Runtime]
+
+Якщо ви правите дуже великі обсяги інформації, Ви можете отримати повідомлення про помилку "out of memory" (недостатньо пам’яті). Щоб цього уникнути, об’єм пам’яті можливо збільшити.[[BR]]
+Створіть ярлик подібний до прикладу:
+{{{
+C:\WINNT\system32\java.exe -jar -Xmx512M "C:\PATH-TO-JOSM\josm-latest.jar"
+}}}
+
+=== Linux / *BSD ===
+
+ '''використовування оболонки'''::
+  Перейдіть до теки де знаходиться josm-latest.jar та введіть
+{{{
+#!sh
+java -jar josm-latest.jar
+}}}
+  для запуску. Замініть `''josm-latest.jar''` на ім’я завантаженого jar-файлу, наприклад `josm.jar` для стабільної версії.
+
+  Якщо це не допомогло, спробуйте встановити змінну JAVA_HOME призначивши їй місце розташування java, наприклад:
+{{{
+#!sh
+ export JAVA_HOME=/usr/lib/sun-j2se5.0-jdk
+ java -jar ''josm.jar''
+}}}
+
+ '''KDE'''::
+  Ось [http://josm.openstreetmap.de/download/tutorials/setting_up_kde.avi посібник] як налаштувати ваше оточення для запуску jar-файлів клацаючи на них.
+
+ '''GNOME'''::
+  Клацніть правою клавішею миші на JAR-файлі та оберіть __O__pen with "Sun Java 6.0 Runtime", чи щось подібне.
+
+ '''XGL/Compiz'''::
+  Наберіть це в оболонці:
+{{{
+#!sh
+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 [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6574362 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 [http://awesome.naquadah.org/wiki/Problems_with_Java workarounds] for this problem.  There is also an [http://xmonad.org/xmonad-docs/xmonad-contrib/XMonad-Hooks-SetWMName.html 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 [http://subversion.tigris.org 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 [http://lists.openstreetmap.org/pipermail/josm-dev/2008-August/001585.html solution suggested at mailing list].
+
+There are also two Videos available at youtube, which show [http://www.youtube.com/watch?v=-LoWGf-hqiQ how to checkout JOSM into Eclipse] and [http://www.youtube.com/watch?v=Z3OjG3nDvzA 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
+}}}