Параметры командной строки

JOSM управляется тремя группами параметров командной строки. Наиболее важны аргументы программы⤓, затем опции Java⤓. Смотрите примеры⤓ использования тех и других. Только на Web Start влияют опции запуска⤓. В последней секции рассматриваются другие⤓ опции, которые используются где-то в этом справочном руководстве.

# Запуск jar
java [опции Java] -jar josm-tested.jar [аргументы программы]

# Запуск через Web Start
javaws [опции запуска] -J[опции Java] josm.jnlp

Аргументы программы

Также именуются аргументами после jar здесь или args в документации по Java.

Первый аргумент воспринимается JOSM как команда. Возможные команды: runjosm для обычного запуска (по умолчанию), render для генерации файла изображения и project для преобразования координат. Если JOSM не может распознать команду, он выполняет команду, используемую по умолчанию.

Следующие аргументы — это опции для JOSM. Они разделяются пробелами. Это могут быть URLы, имена файлов, координаты, простые опции и пары опция=аргумент. Полный список команд и опций показан ниже:

Использование:
  java <опции java> -jar josm.jar [<команда>] <опции>

Команды:
  runjosm     запустить JOSM (по умолчанию, выполняется, если никакой команды не указано)
  render      выполнить отрисовку данных и сохранить результат в файл изображения
  project     преобразовать координаты из одной системы координат в другую

Для более подробных сведений о командах render и project запустите их с опцией --help.
Остаток этой страницы документирует команду runjosm.

Опции:
  --help|-h                                 Показать эту справку
  --geometry=widthxheight(+|-)x(+|-)y       Стандартный аргумент unix geometry
  [--download=]minlat,minlon,maxlat,maxlon  Скачать данные в указанной области
  [--download=]<URL>                        Скачать область по URL, содержащему
                                            координаты наподобие lat=x&lon=y&zoom=z
  [--download=]<имя файла>                  Открыть файл (то же, что и меню Файл/Открыть)
  --downloadgps=minlat,minlon,maxlat,maxlon Скачать указанную область, как "сырой" GPS
  --downloadgps=<URL>                       Скачать по URL, как "сырой" GPS
  --selection=<строка поиска>               Выделить объекты по результатам заданного поиска
  --[no-]maximize                           Запустить JOSM развёрнутым во весь экран
  --reset-preferences                       Сбросить настройки к значениям по умолчанию
  --load-preferences=<url-to-xml>           Импортировать настройки из XML-файла
  --set=<key>=<value>                       Присвоить настройке key значение value
  --language=<язык>                         Задать язык интерфейса
  --version                                 Показать версию JOSM и выйти
  --debug                                   Выводить отладочные сообщения в консоль
  --skip-plugins                            Пропустить загрузку модулей
  --offline=[osm_api,][josm_website,][all]  Отключить доступ к указанным ресурсам

Часть --download= опции download является не обязательной. Аргументы --download, --downloadgps и --selection обрабатываются именно в таком порядке, как перечислены здесь. Значение <url-to-xml> может указывать на локальный файл file:relative/path/name.xml. Более подробный вывод, чем --debug, обеспечивает опция --trace. Элементы значения --offline разделяются запятыми.

Опции Java

Опции Java именуются также опциями JOSM JVM здесь или аргументами VM в отчёте о состоянии. В этом отчёте можно увидеть аргументы, с которыми была запущена программа, а ниже их — аргументы VM. Они управляют виртуальной машиной Java ​(JVM) и могут задавать ​свойства внутри неё. JOSM читает некоторые из них, например josm.home и user.language.

Опции Java:
  -Djosm.dir.name=JOSM                      Изменить имя каталога JOSM
  -Djosm.pref=/PATH/TO/JOSM/PREF            Задать каталог настроек
                                            По умолчанию: C:\Users\name\AppData\Roaming\JOSM
  -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Задать каталог пользовательских данных
                                            По умолчанию: /home/name/.local/share/JOSM
  -Djosm.cache=/PATH/TO/JOSM/CACHE          Задать каталог кэша
                                            По умолчанию: <...>
  -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Задать общий каталог для настроек, пользовательских
                                            данных и ./кэша/. Эта опция имеет более низкий приоритет
                                            и будет перекрываться вышеуказанными опциями.
  -Xmx...m                                  Задать максимальный размер кучи Java (heap) в мегабайтах.
                                            Позволяет избежать ошибок о недостаточности памяти.

Опция -Xmx...m может быть полезна при возникновении ошибок «не хватает памяти». Если вы укажете общий каталог опцией Djosm.home, то JOSM создаст подкаталоги ./autosave, ./cache и ./validator. Если значение содержит пробелы, заключите их в кавычки, вот так: "josm dev". Если в командной строке встречаются не-ASCII символы, используйте -Dfile.encoding=Cp850 для получения текста из Java в другой ​кодировке. То, какая ​кодировка используется, покажет chcp⏎ в терминале.

Примеры

Примеры аргументов программы и опций Java в действии:

# Загрузить три файла
  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
# Скачать с OSM по URL с масштабом и координатами
  java -jar josm.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
# Скачать область и выделить все элементы, совпадающие со строкой
  java -jar josm.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
#
# Задать каталог для JOSM согласно переменной окружения из операционной системы
  java -Djosm.pref=$XDG_CONFIG_HOME jar josm.jar
# Кавычки для значения с пробелом и показ интерфейса JOSM на английском языке
  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
# Задать общий каталог в подкаталоге
  java -Djosm.home=biketour2017/london -jar josm.jar
# Больше памяти в среде с французским интерфейсом
  java -Xmx1024m -Duser.language=fr -jar josm.jar
#
# Не беспокоить уведомлениями и выводить отладочную информацию
java -verbose -jar josm-latest.jar --set=message.notifier.enabled=false --debug >WhatsUp.txt

Опции запуска

Опции запуска следуют за командой javaws. Они управляют механизмом Web Start и средой для JVM.

  -offline                  Позволяет осуществлять Web Start JOSM без доступа к интернету
  -J<опции java>            Передаёт <опции java> в JVM 
  -J-Xmx1024m               Здесь: задать максимальный размер кучи Java равным 1024 МБ

Опция -J берёт свою часть после буквы J и передаёт её в качестве опций Java. Файл jnlp, используемый ​Web Start, предлагает другой способ ​задать опции для JRE и непосредственно для программы JOSM.

Другие опции

Команда javaws на всех системах и josm.exe в MS Windows имеют несколько дополнительных ​опций.

javaws -viewer            Показ просмотрщика кэша в панели управления Java
# Позволяет открывать панель управления Java из командной строки.

javaws -clearcache        Убирает все неустановленные приложения из кэша
# Эквивалентно 'Delete Files and Applications', выполненному из 'Temporary File Settings'
# кнопкой 'Settings' во вкладке 'General' панели управления Java.
# javaws -Xclearcache в OpenJDK

josm.exe --j4l-debug      Пытается записать launch4j.log в текущий каталог
josm.exe --j4l-dont-wait  Завершает выполнение обёртки после вызова JOSM.

И опция -clearcache, и очистка кэша через панель управления Java, удаляют связанные с JNLP значки с рабочего стола. Значок JOSM будет удалён, если он был размещён там в результате щелчка в веб-браузере на jnlp-файле.

Смотрите также

• Решение проблем с Java
• Примечания по установке
• Настройки - обзор настроек
• Основная страница