[[TranslatedPages(revision=135,outdated=Необходимо доперевести раздел «Решение проблем»)]]
[[PageOutline(2-3,Содержание)]]
= Загрузка =

Эта страница содержит базовую информацию по установке JOSM и решению возникающих проблем.

Перед началом работы с JOSM рекомендуем прочесть страницы [wikitr:/Introduction Введение] и [wikitr:/Help Справка].
При возникновении сложных проблем ознакомьтесь с [wikitr:/InstallNotes рекомендациями по установке].

== Рекомендуемые варианты ==

[[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Запустить [/download/josm.jnlp josm.jnlp]** (самая новая стабильная версия) [[br]]
Рекомендуемая версия, все платформы, ежемесячное автоматическое обновление до новейшей ''стабильной версии'' ([#Webstart как запустить]). [[br]]
[[br]]
[[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **Скачать [/josm-tested.jar josm-tested.jar]** (стабильная версия [[Version(tested)]]) [[br]]
Все платформы ([#Java как запустить]). [[br]]
[[br]]

== Все варианты загрузки ==#Moredownloadoptions

Каждый [/roadmap месяц] команда JOSM [wikitr:/Releases выпускает] **стабильную версию (tested)** для загрузки.
Варианты для MS Windows и Apple Mac основаны на этой стабильной версиии.
Щёлкнув на josm.jnlp для запуска JOSM, вы всегда получите новейшую стабильную версию. Этот механизм основан на Java [wikitr:/InstallNotes#Webstart Web Start].

[=#DevelopmentVersion]
Каждую [/log/josm/?verbose=on&limit=20 ночь] сборочная система создаёт **версию в разработке (latest)**.
Эти версии могут содержать серьёзные ошибки, но чаще всего они тоже нормально работают.
Для latest-версии также доступен вариант с Web Start.

||= =||||= Для всех операционных систем =||||||||||
||=Версия =||=  Web Start  =||= Загрузка =||= Windows =||= Apple Mac =||= Ubuntu, Debian…  =||= openSUSE =||
||tested [[Version(tested)]] ||   \
||   [/download/josm.jnlp josm.jnlp] ||  \
||   [/josm-tested.jar] ||           \
||   [/download/windows/josm-setup.exe setup.exe] [[br]]''([#Mswindowswrapper см. ниже])'' ||  \
||   [/download/macosx/josm-macosx.zip package.zip] [[br]]''([#Macoserrors см. ниже])'' ||  \
||   ''[#Ubuntu см. ниже]'' ||          \
||   ''[#Opensuse см. ниже]'' ||
||latest [[Version(latest)]] || \
||   [/download/josm-latest.jnlp latest.jnlp] ||  \
||   [/josm-latest.jar] || \
||   || || ''[#Ubuntu см. ниже]'' || ||
||=более старые версии =|| || [/download/ download/] || || || [/apt/dists/ dists/] || ||

Для проверки версий в скриптах автоскачивания используйте страницы [/latest latest], [/tested tested] или [/version both], чтобы не загружать канал.

** Как убрать ненужные переводы из файла **[=#Striptranslations]  \\
Если размер загружаемого файла имеет для вас значение, то доступны и более компактные файлы JOSM tested. Для скачивания файла, содержащего перевод только на один язык, добавьте [/josm-tested.jar?lang=en ?lang=en] к URL. Замените `en` на [wiki:/TracLanguages код] нужного языка (первый символ в нижнем регистре, только поддерживаемые языки). Можно ещё уменьшить размер файла, убрав из него информацию о подписи: добавьте [/josm-tested.jar?lang=en&unsigned=1 ?unsigned=1].

== Репозитории пакетов ==

=== openSUSE  ===#Opensuse

Стабильная версия JOSM доступна в репозитории Application:Geo.

Сначала от имени root добавьте в yast или zypper репозиторий (замените версию в URL на используемую вами):
{{{
zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo
}}}

Затем просто установите пакеты ''josm'' и ''josm-fonts''.

=== Ubuntu ===#Ubuntu

Это репозиторий пакетов для Ubuntu. Он также должен работать и в других основанных на Debian (а особенно, основанных на Ubuntu) дистрибутивах, но в реальности мы не осуществляем активного тестирования и поддержки в других дистрибутивах, кроме Ubuntu.

Репозиторий содержит два пакета:
* ''josm''  – стабильная версия (tested).  Заменяет пакет из официального репозитория Ubuntu (там обычно очень старая версия).
* ''josm-latest'' – разрабатываемая версия (ночная сборка). Может быть установлена одновременно с пакетом josm. Каталог настроек по умолчанию {{{~/.josm-latest}}}.

В дополнение к обычной процедуре, описанной ниже, старые DEBы можно вручную скачать из следующих [/apt/pool/universe/j/ архивов].

==== Установка ====

Отредактируйте список источников пакетов {{{/etc/apt/sources.list}}}:

{{{
#!sh
sudo editor /etc/apt/sources.list
}}}

и добавьте одну из следующих строк, в зависимости от версии Ubuntu:

{{{
#!sh
deb https://josm.openstreetmap.de/apt trusty universe
deb https://josm.openstreetmap.de/apt xenial universe
deb https://josm.openstreetmap.de/apt artful universe
# Для других основанных на Debian дистрибутивах добавьте:
deb https://josm.openstreetmap.de/apt alldist universe
}}}

Или сделайте описанное выше следующей однострочной командой в Ubuntu:
{{{
echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | ↩
↪sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
}}}

{{{#!comment
### below did not work on all systems
and add the following line:
`
deb https://josm.openstreetmap.de/apt VERSION universe
`
}}}

Скачайте и зарегистрируйте [[/josm-apt.key|открытый ключ]]:
{{{
#!sh
wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -
}}}

Теперь обновите источники приложений (может понадобиться установить `sudo apt-get install apt-transport-https`)
{{{
#!sh
sudo apt-get update
}}}
и установите JOSM:

{{{
#!sh
# Можно пропустить первую строку если эти пакеты не были установлены ранее.
sudo apt-get remove josm josm-plugins

# Для стабильной версии
sudo apt-get install josm
# для версии в разработке
sudo apt-get install josm-latest
}}}

== Решение проблем ==
=== Java ===#Java
[=#Doubleclickonafiledoesnothing Если при двойном щелчке на jar-файле ничего не происходит], то в большинстве случаев это означает, что не установлена Java. 

JOSM тестируется с вариантом Java от Oracle, поэтому мы рекомендуем скачать Java с их страниц [https://www.java.com/download/manual.jsp загрузки вручную] или для [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html промежуточных версий]. Но сначала попробуйте Java, поставляемую с вашей операционной системой, например,[https://en.wikipedia.org/wiki/OpenJDK OpenJDK]. 

При выборе варианта скачивания учитывайте следующее:
 * Java-плагин для веб-браузера **не нужен** для запуска JOSM. Следовательно, результаты автоматической проверки Java на странице www.java.com/ru/download/installed8.jsp не имеют отношения к запуску JOSM.
 * Для JOSM рекомендуется 64-битный вариант Java. При выборе между 32-битной и 64-битной версией важна архитектура операционной системы. Поскольку архитектура веб-браузеров **неважна**, то рекомендации на странице www.java.com/ru/download/faq/java_win64bit.xml тоже не имеют значения для JOSM.
 * Избегайте страниц типа www.java.com/ru/download, которые предназначены для установки плагина Java в веб-браузер. А это **не нужно** для JOSM.

Для дополнительной информации прочтите [wiki:Ru:InstallNotes Примечания по установке] и страницы [https://www.java.com/ru/download/help/troubleshoot_java.xml решения проблем с Java].
''Java'' в этом разделе означает JRE (Java Runtime Engine), которая предоставляет JVM (Java Virtual Machine) для запуска JOSM. В свою очередь, JOSM — это программа на Java, которая разработана с использованием JDK (Java Development Kit) и иногда запускается с помощью JNLP (Java Network Launch Protocol, известного также как Web Start и являющегося преемником Java-плагинов).

==== Проверка Java ====#Javatest 
[=#Troubleshootingjarfile] Проверка, установлена ли Java, и почему JOSM не запускается (пример для MS Windows).
1. Скачайте [/josm-tested.jar josm-tested.jar] на ваш рабочий стол.
1. Откройте программу «Командная трока» (терминал)
1. Наберите `cd %homepath%`⏎ и `cd Desktop`⏎ 
1. Наберите `java -version `⏎ Должны появиться 3 строки с данными о версии. Если вы видите что-то другое, значит Java не была правильно установлена.
1. Наберите `java -jar josm-tested.jar`⏎. Должен запуститься JOSM из [wikitr:/Help/CommandLineOptions командной строки]. 
1. Закройте JOSM.
1. Наберите `josm-tested.jar`⏎. Если JOSM снова запустится, то Проводник Windows готов к запуску JOSM по двойному щелчку на jar-файле.


=== Web Start ===#Webstart
[=#Troubleshootingjhlplink]
При запуске JOSM через Web Start есть намного больше причин появления ошибок, чем при традиционном способе (скачивании jar-файла и его запуске). 
Поэтому сначала протестируйте [#JavaTest Java], а затем выполните описанную ниже проверку на [https://www.java.com/en/download/faq/java_webstart.xml проблемы с Web Start]. 

==== Проверка Web Start ====#Webstarttest
1. Скачайте [/josm-tested.jar josm.jnlp] на рабочий стол.
1. Откройте терминал и перейдите на рабочий стол (как в тесте, приведённом выше)
1. Наберите `javaws josm.jnlp`⏎. Эта команда должна скачать JOSM, показать диалог безопасности, а затем запустить JOSM.


=== Виртуальная машина ===#Troubleshootingjvm

==== Не хватает памяти ====

Сейчас управление памятью Javas вручную требуется редко, так как объём доступной ОЗУ в компьютерах значительно увеличился. 
Неправильно выбранные значения могут снизить быстродействие JOSM. 

Для некоторых задач JOSM проявляет большой аппетит к памяти. С одной стороны, может быть необходимо настроить больший размер памяти для поддержки большего количества модулей и различных функций. С другой стороны, медленные компьютеры можно стабилизировать, ограничив потребление памяти Java. 
При необходимости, используйте [wikitr:/Help/CommandLineOptions командную строку], чтобы задать [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI параметр Java] -Xmx…m, например, `-Xmx512m` или `-Xmx1536m`.
Ранее старые java-программы принимали `-Xmx=512m` или даже `-Xmx 512m`. Теперь такие ошибочные аргументы могут вызвать сообщения об ошибках.

==== Выбор виртуальной машины ====#VMselectiononWindowsx64

В текущих версиях MS Windows по умолчанию Java устанавливается преимущественно в каталог `C:\Program Files\Java\`. Дополнительные части помещаются в `C:\Program Files\Oracle\Java\`. There is a `.\javapath\` directory as target for the PATH environment variable. Это домашний каталог для трёх виртуальных файлов `java.exe`, `javaw.exe` и `javaws.exe`. This files are symbolic links form the current Java installations.

On older versions of 64 bit Windows sometimes the 32 bit mode JRE was additionally installed.  Also some browsers brought their own JVM with limited capabilities. In those cases a Web Start from the browser would not use your Java installation but that from the browser.

Check that there's no other javawebstart in {{{\Windows\SysWow64}}}. The Java control panel will not detect it and you can safely delete it. Perfom cleanup and only keep the latest versions of each JRE (One or the 32-bit mode, another one for the 64-bit mode).

For shortcuts created on the desktop for JNLP and running the Javawebstart launcher , 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!)

Example of an edited command line for a shortcut on the windows desktop: 
{{{
#!sh
javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp 
}}}

=== josm.exe в Windows ===#Mswindowswrapper

При установке через josm-setup.exe в Microsoft Windows происходит следующее: 
 * Файлы `josm-tested.jar` и `josm.exe` помещаются в выбранный пользователем каталог, по умолчанию в `C:\Program Files (86)\JOSM\` 
 * Предлагается связать josm.exe с расширениями файлов `*.osm` и `*.gpx`.
 * Предлагается поместить значки ярлыков JOSM на рабочий стол и в меню Пуск (В настоящее время они размещаются только для администратора и их можно скопировать оттуда, #11398).
 * Задаётся вопрос о необходимости установки модулей Imagery offset database и Turn restrictions. 
 * Добавляются данные, необходимые для деинсталляции JOSM, в нужные места.

При запуске josm.exe ищет jar-файл в своём каталоге и выполняет команду `\path\to\javaw.exe -Xms128m -Xmx1024m -jar \path\to\josm-tested.jar`. 
Josm.exe работает как ''обёртка'' и является [wikitr:/USB_Stick переносимым].

Если josm.exe обнаруживает аргумент `--l4j-debug`, он пишет в файл журнала `launch4j.log` в текущем каталоге, если имеется возможность записи в него. Some other [http://launch4j.sourceforge.net/docs.html#Runtime_options options] are possible and all usual [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments] too. See example:

{{{
#!sh
# Write a log while starting JOSM and load OSM data
josm.exe --l4j-debug https://www.osm.org/way/476702262
}}}

Для передачи [wikitr:Help/CommandLineOptions#Javaoptions параметров Java] в Java VM josm.exe использует необязательный файл `josm.l4j.ini` в своём каталоге. В этом файле каждый параметр необходимо помещать в отдельную строку и возможны комментарии, см. [http://launch4j.sourceforge.net/docs.html#Additional_jvm_options Дополнительные параметры JVM].

Даже являясь 32-битной программой, josm.exe, похоже нуждается в 64-битной Java в 64-битной Windows.

=== MacOS Errors ===#Macoserrors
[=#MacOSErrors][=#MacOSXMountainLionErrors]
{{{
#!comment
старый заголовок секции, оставлен в качестве якоря для старых ссылок
}}}

Apple has two mechanisms to ''protect'' you from using JOSM: [https://support.apple.com//HT201940 File Quarantine] and [https://support.apple.com//HT202491 Gatekeeper].

==== Сообщение о приложении, скачанном из Интернета ====
Если вы получаете ошибку "'JOSM.app' is an application downloaded from the internet.",  то её можно обойти **щелчком правой кнопкой на JOSM.app** или josm.jnlp и выбором 'open'. Вы увидите то же самое сообщение, но на этот раз с возможностью "Открыть". Это необходимо только при первом запуске JOSM.

==== Сообщение о повреждённом файле ====
[[Image(#8787:damaged_josm_app.png,width=300,align=left,margin-top=-50,margin-right=30)]]

Если вы видите сообщение "'JOSM.app' is damaged and can't be opened. You should move it to the Trash", то нужно временно отключить Gatekeeper. 

Откройте System Preferences и параметры 'Security & Privacy'. Задатйте 'Allow applications downloaded from:' значение 'Anywhere'. 

Если эта радиокнопка отстутствует в панели Security & Privacy, откройте окно Терминала. Следующая команда может заставить снова появиться радиокнопку. 

{{{
sudo spctl --master-disable
}}}
\\
==== Использование brew ====#brew

Пользователи MacOS могут выбрать менеджер пакетов [https://brew.sh/ homebrew] как универсальный способ установки и обновления JOSM.

Применение `brew cask` устраняет большинство из упомянутых выше проблем (см. [https://github.com/Homebrew/homebrew-cask/]).

Откройте Терминал и наберите следующие команды, чтобы установить и обновить JOSM до текущей стабильной версии, соответственно:

{{{
brew install --cask josm
}}}
{{{
brew upgrade --cask josm
}}}

=== Известные проблемы с JOSM ===

Незакрытые ошибки, касающиеся ...:
* [/query?status=!closed&type=defect&keywords=~java Java issues] - некоторые ошибки, ведущие к блокированию в Oracle JVM (описаны в [[JavaBugs]]).
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux]
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu]
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS]
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows]