| 4 | | == Обзор == |
| 5 | | |
| 6 | | || ||= Не зависящий от ОС =||= [https://www.java.com/en/download/faq/java_webstart.xml Web Start] =||= Windows =||= Mac OS X =||= Ubuntu, … =|| |
| 7 | | ||= **tested** [[Version(tested)]] =|| **[/josm-tested.jar jar ]** || [/download/josm.jnlp jnlp] || [/download/windows/josm-setup.exe setup.exe] ([wiki:USB_Stick portable]) || [/download/macosx/josm-macosx.zip package.zip] || ''см. ниже'' || |
| 8 | | ||= latest [[Version(latest)]] =|| [/josm-latest.jar jar] || [/download/josm-latest.jnlp jnlp] || || || ''см. ниже'' || |
| 9 | | ||= старые =|| [/download/ download/] || || || || || |
| 10 | | |
| 11 | | * **Какую версию использовать?** (см. также: [wiki:Releases release system] (англ.)) |
| 12 | | * ''tested'' выпускается примерно ежемесячно и не должна содержать серьёзных ошибок |
| 13 | | * ''latest'' выпускается ежедневно и может иметь ошибки |
| 14 | | * Если возможно, используйте версию Web Start для автоматического обновления. |
| 15 | | |
| 16 | | ---- |
| 17 | | |
| 18 | | * '''Учтите, что программа обновляется очень часто, поэтому сначала всегда попробуйте запустить последнюю версию (со свежими плагинами).''' |
| 19 | | * Запустить [/download/josm.jnlp JOSM-WebStart] без установки |
| 20 | | * Скачать '''[/josm-tested.jar протестированную]''' версию JOSM [[Version(tested)]] |
| 21 | | * Скачать [/download/windows/josm-setup.exe установщик JOSM под Windows] версии [[Version(windows)]] |
| 22 | | * Скачать [/download/macosx/josm-macosx.zip пакет JOSM для Mac OS X] версии [[Version(macos)]] |
| 23 | | * Подготовить [wiki:USB_Stick USB-флэшку] для запуска JOSM на любом компьютере с Windows. |
| | 5 | Эта страница содержит базовую информацию по установке JOSM и решению возникающих проблем. |
| | 6 | |
| | 7 | Перед началом работы с JOSM рекомендуем прочесть страницы [wiki:Ru:Introduction Введение] и [wiki:Ru:Help Справка]. |
| | 8 | |
| | 9 | == Рекомендуемые варианты == |
| | 10 | |
| | 11 | * [[Image(source:trunk/images/openlocation.png, valign=middle, link=)]] '''Запустить [/download/josm.jnlp josm.jnlp] ([[Version(tested)]])''' - рекомендуемая версия, все платформы, автоматическое обновление ([#Troubleshootingjhlplink ''ссылка .jnlp'' не работает?]) |
| | 12 | * [[Image(source:trunk/images/download.png, valign=middle, link=)]] '''Скачать [/josm-tested.jar josm-tested.jar] (version [[Version(tested)]])''' - все платформы ([wiki:Download#Troubleshootingjarfile не удаётся запустить файл?]). О дополнительной памяти и других хитростях читайте в разделе [[Help/CommandLineOptions|Параметры командной строки]]. |
| | 13 | |
| | 14 | [[br]] |
| | 15 | |
| | 16 | == Другие варианты загрузки == |
| | 17 | |
| | 18 | ''Учтите, что [/roadmap программа обновляется очень часто], поэтому сначала всегда попробуйте запустить последнюю версию (и со свежими плагинами)''. |
| | 19 | |
| | 20 | || ||= Не зависящая от ОС =||= [https://www.java.com/en/download/faq/java_webstart.xml Web Start] =||= Windows =||= Mac OS X =||= Ubuntu, … =||= openSUSE =|| |
| | 21 | ||= **tested** [[Version(tested)]] =|| **[/josm-tested.jar jar ]** || [/download/josm.jnlp jnlp] || [/download/windows/josm-setup.exe setup.exe] ([wiki:USB_Stick переносимая]) || [/download/macosx/josm-macosx.zip package.zip] ([#MacOSXerrors ошибка при первом запуске]) || ''[#Ubuntu см. ниже]'' || ''[#openSUSE см. ниже]'' || |
| | 22 | ||= latest [[Version(latest)]] =|| [/josm-latest.jar jar] || [/download/josm-latest.jnlp jnlp] || || || ''[#Ubuntu см. ниже]'' || || |
| | 23 | ||= старые версии =|| [/download/ download/] || || || || || || |
| | 24 | |
| | 25 | === Что выбрать: latest, tested или webstart? === |
| | 26 | * ''tested'' - [wiki:Releases выходит примерно раз в месяц и протестирована на отсутствие серьёзных ошибок] |
| | 27 | * ''latest'' (разрабатываемая версия) - [wiki:Releases выходит ежедневно, может содержать ошибки] |
| | 28 | * ''.jnlp'' - если возможно, используйте версию Web Start, обеспечивающую '''автоматическое обновление'''. |
| | 29 | |
| | 30 | * Подготовьте [wiki:USB_Stick USB-накопитель] (флешку) для работы в JOSM на любом компьютере с Windows. |
| 25 | | * Если размер файла вам важен, можно добавить `?lang=..` к ссылке загрузки, чтобы убрать из дистрибутива ненужные переводы (например, `?lang=ru` выдаст пакет JOSM только на русском языке). |
| 26 | | |
| 27 | | == Версия в разработке == |
| 28 | | |
| 29 | | * Скачайте '''[/josm-latest.jar последнюю версию]''' JOSM [[Version(latest)]] (может содержать больше ошибок, нежели "протестированная", — осторожно). |
| 30 | | |
| 31 | | == Аплет == |
| 32 | | |
| 33 | | * Попробуйте '''[/applet аплет JOSM]''', но только после прочтения [wiki:Applet инструкции]. |
| 34 | | |
| 35 | | == Исходный код == |
| 36 | | |
| 37 | | * Скачайте исходники: |
| 38 | | * Из официального репозитория Subversion (рекомендуется): {{{svn co https://josm.openstreetmap.de/svn/trunk}}} |
| 39 | | * Из неофициального [https://github.com/openstreetmap/josm зеркала на GitHub]: {{{git clone git://github.com/openstreetmap/josm.git}}} |
| 40 | | * Из официального репозитория OSM Subversion (включая плагины): {{{svn co http://svn.openstreetmap.org/applications/editors/josm josm}}} |
| 41 | | |
| 42 | | == Репозиторий Ubuntu == |
| 43 | | |
| 44 | | Хранилище пакетов для Ubuntu содержит: |
| 45 | | {{{josm}}}:: ''Протестированная версия''[[br]] |
| 46 | | Заменяет пакет из официального репозитория Ubuntu. |
| 47 | | {{{josm-latest}}}:: ''Версия в разработке (ночная сборка)''[[br]] |
| 48 | | Может быть установлена одновременно с пакетом {{{josm}}}. Настройки хранятся в каталоге {{{~/.josm-latest}}}. |
| 49 | | === Установка === |
| 50 | | В зависимости от вашей версии Ubuntu, добавьте одну из следующих строк в файл {{{/etc/apt/sources.list}}}: |
| 51 | | {{{ |
| 52 | | deb https://josm.openstreetmap.de/apt lucid universe |
| 53 | | deb https://josm.openstreetmap.de/apt precise universe |
| 54 | | deb https://josm.openstreetmap.de/apt quantal universe |
| 55 | | deb https://josm.openstreetmap.de/apt raring universe |
| 56 | | deb https://josm.openstreetmap.de/apt saucy universe |
| | 32 | |
| | 33 | === Репозиторий openSUSE ===#openSUSE |
| | 34 | |
| | 35 | Версия JOSM tested доступна в репозитории Application:Geo. |
| | 36 | |
| | 37 | Сначала от имени root добавьте в yast или zypper репозиторий (замените версию в URL на используемую вами): |
| | 38 | {{{ |
| | 39 | zypper ar -f http://download.opensuse.org/repositories/Application:/Geo/openSUSE_13.2 Application:Geo |
| | 40 | }}} |
| | 41 | |
| | 42 | Затем просто установите пакеты **josm** и **josm-fonts**. |
| | 43 | |
| | 44 | === Репозиторий Ubuntu ===#Ubuntu |
| | 45 | |
| | 46 | Это репозиторий пакетов для Ubuntu. Он также должен работать и в других основанных на Debian (а особенно, основанных на Ubuntu) дистрибутивах, но в реальности мы не осуществляем активного тестирования и поддержки в других дистрибутивах, кроме Ubuntu. |
| | 47 | [[BR]] |
| | 48 | Примечание: в дополнение к обычной процедуре, описанной ниже, старые DEBы можно вручную скачать и щёлкнуть на них для установки из следующих каталогов: [https://josm.openstreetmap.de/apt/pool/universe/j/josm/ для josm]; [https://josm.openstreetmap.de/apt/pool/universe/j/josm-latest/ для josm-latest] |
| | 49 | |
| | 50 | Репозиторий содержит два пакета: |
| | 51 | {{{josm}}}:: ''стабильная версия''[[br]] |
| | 52 | Заменяет пакет из официального репозитория Ubuntu (там обычно очень старая версия). |
| | 53 | {{{josm-latest}}}:: ''разрабатываемая версия (ночная сборка)''[[br]] |
| | 54 | Может быть установлена одновременно с пакетом {{{josm}}}. Каталог настроек по умолчанию {{{~/.josm-latest}}}. |
| | 55 | |
| | 56 | ==== Установка ==== |
| | 57 | |
| | 58 | Отредактируйте список источников пакетов {{{/etc/apt/sources.list}}}: |
| | 59 | |
| | 60 | {{{ |
| | 61 | #!sh |
| | 62 | sudo editor /etc/apt/sources.list |
| | 63 | }}} |
| | 64 | |
| | 65 | и добавьте одну из следующих строк, в зависимости от версии Ubuntu: |
| | 66 | |
| | 67 | {{{ |
| 85 | | === Полезные опции === |
| 86 | | |
| 87 | | Если редактору не хватает памяти, можно увеличить её максимально допустимый объём (в мегабайтах - максимум ±1.5GB для 32-битной Java, зависит от ОС): |
| 88 | | {{{ |
| 89 | | JAVA_OPTS="-Xmx400M" josm |
| 90 | | }}} |
| 91 | | |
| 92 | | Запуск с другим каталогом для настроек: |
| 93 | | {{{ |
| 94 | | JAVA_OPTS="-Djosm.home=$HOME/.josm-tmp" josm |
| 95 | | }}} |
| | 122 | == Решение проблем == |
| | 123 | === Проблемы с jar-файлом === |
| | 124 | |
| | 125 | ==== При двойном щелчке на файле ничего не происходит ==== |
| | 126 | |
| | 127 | В большинстве случаев это означает, что не установлена Java (JVM). JOSM тестируется и разрабатывается с Oracle JVM, поэтому рекомендуется получить её с сайта java.com. |
| | 128 | |
| | 129 | * https://www.java.com/en/download/ - основной ресурс, обычно процесс установки проходит без проблем |
| | 130 | * https://www.java.com/en/download/help/download_options.xml - дополнительные шаги для всех систем |
| | 131 | * https://www.java.com/en/download/help/index_installing.xml?os=All+Platforms&j=8&n=20 - поищите на их портале ответы на ваши вопросы по установке |
| | 132 | |
| | 133 | Если Java установлена, обратитесь к страницам: |
| | 134 | * https://www.java.com/en/download/help/troubleshoot_java.xml - содержит ответы на самые частые вопросы по устранению неполадок |
| | 135 | * https://www.java.com/en/download/help/ - эта страница содержит раздел "8 типичных проблем с Java", одна из которых может подойти к вашему случаю |
| | 136 | |
| | 137 | ==== Как убрать ненужные переводы из .jar ==== |
| | 138 | |
| | 139 | Если размер скачиваемого файла для вас имеет значение: |
| | 140 | * Добавьте **?lang=…** к загрузочной ссылке для обоих выпусокв, чтобы убрать неиспользуемые переводы (например, **?lang=de** скачает JOSM только с немецким языком). |
| | 141 | * **Примечание**: используйте подчёркивание для отделения [[Translations|кода языка]] от кода страны, например, **?lang=en_GB** |
| | 142 | * Добавьте **?unsigned=1**, чтобы убрать информацию о цифровой подписи кода |
| | 143 | * Если используются и **lang**, и **unsigned**, отделите их символом **&**, например, **?lang=de&unsigned=1** |
| | 144 | |
| | 145 | 10786 .jar: 10.2 Мб[[br]] |
| | 146 | 10786 .jar?lang=de: 8151 Кб [[br]] |
| | 147 | 10786 .jar?lang=de&unsigned=1: 7688 Кб |
| | 148 | |
| | 149 | === Проблема со ссылкой jnlp === |
| | 150 | |
| | 151 | Если [wiki:Download#Doubleclickonafiledoesnothing JVM уже установлена], прочтите раздел справки [https://www.java.com/en/download/faq/java_webstart.xml Web Start]. |
| | 152 | |
| | 153 | === Проблемы с JVM === |
| | 154 | |
| | 155 | ==== Не хватает памяти ==== |
| | 156 | |
| | 157 | В процессе большого сеанса редактирования вы можете получить ошибку "Недостаточно памяти". |
| | 158 | |
| | 159 | Чтобы избежать этого, можно увеличить выделенную память с помощью параметра {{{-Xmx}}}, см. раздел [[Help/CommandLineOptions|Параметры командной строки]]. |
| | 160 | |
| | 161 | ==== Выбор виртуальной машины в Windows x64 ==== |
| | 162 | |
| | 163 | For Windows, beware that some browsers may install their own JRE only in 32 bit mode, but may also install their version of the Javawebstart tool somewhere else with different file associations. This may cause your JNLP to start with this alternate JRE because it runs the wrong version of Javawebstart which only supports the 32 bit VM, and sometimes is built with a restricted support for VM options and a max VM size not exceeding 256MB. |
| | 164 | |
| | 165 | Check, for example, if there's no other javawebstart in {{{\Windows\SysWow64}}}. You should not need it (the Java control panel will not detect it) and can safely delete it. Perfom cleanup and only keep the latest version of the JRE (1 for the 32-bit mode, another one for the 64-bit mode). |
| | 166 | |
| | 167 | For shortcuts created on the desktop for JNLP and running the Javawebstart launcher (from {{{\windows\system32}}}), make sure to pass VM parameters prefixed with -J and no intermediate space before the VM option. If you have installed both the 32-bit and 64-bit version, you should pass the option "{{{-d64}}}" if you want to select the preferred 64-bit VM. Note that some Oracle documentation pages indicate the option "-D64" with the incorrect capitalization!) |
| | 168 | |
| | 169 | Example of an edited commandline for the shortcut created on the windows desktop after running JOSM just once from the JNMP and exiting: |
| | 170 | {{{ |
| | 171 | #!sh |
| | 172 | C:\Windows\System32\javaws.exe -J-d64 -Xmx=2048m -localfile -J-Djnlp.application.href=https://josm.openstreetmap.de/download/josm.jnlp "C:\Users\<snipped user name>\AppData\LocalLow\Sun\Java\Deployment\cache\6.0\21\7311<snipped-hex-number>7f8" |
| | 173 | }}} |
| | 174 | You don't need to change the end of the command line with the snipped parts here. Just check the path for {{{javaws.exe}}} and add options {{{-J-d64}}} for the 64-bit mode needed to work with large OSM datasets, and {{{-Xmx=2048m}}} to increase the VM size (to 2GB here). |
| | 175 | |
| | 176 | === Ошибки в Mac OS X === |
| | 177 | [=#MacOSXMountainLionErrors] |
| | 178 | {{{ |
| | 179 | #!comment |
| | 180 | old section title, keeping as anchor for old links |
| | 181 | }}} |
| | 182 | [[Image(#8787:damaged_josm_app.png,align=right,margin-top=-35)]] |
| | 183 | |
| | 184 | If you get an error saying "'JOSM.app' is an application downloaded from the internet." you can bypass this by **right-clicking on JOSM.app** or josm.jnlp and selecting 'open'. You should then see the same message but this time with an option to "Open" regardless. This is only necessary on the first run of JOSM. |
| | 185 | |
| | 186 | If you get an error saying "'JOSM.app' is damaged and can't be opened. You should move it to the Trash", then you need to temporarily disable gatekeeper. Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. If the that radio button is missing from the Security & Privacy preferences panel, the following may be entered using a terminal window to make it appear: |
| | 187 | |
| | 188 | {{{ |
| | 189 | sudo spctl --master-disable |
| | 190 | }}} |
| | 191 | |
| | 192 | === Известные и ещё не устранённые проблемы с JOSM === |
| | 193 | |
| | 194 | Not closed issues about ...: |
| | 195 | * [https://josm.openstreetmap.de/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [[JavaBugs]]). |
| | 196 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux] |
| | 197 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu] |
| | 198 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS] |
| | 199 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows] |
| | 200 | |
| | 201 | == Смотрите также == |
| | 202 | * [[Source code|Исходный код]] |
| | 203 | * [wiki:InstallNotes#Running how to run] - возможно, устаревшая страница справки |