Context Navigation

Editing Ru:Help/CommandLineOptions

Adjust edit area height: Edit side-by-side

[[TranslatedPages(revision=25)]]

= Параметры командной строки =
{{{#!comment
Нет оглавления. 
}}}
JOSM управляется тремя группами параметров командной строки.
Наиболее важны [#Programarguments аргументы программы], затем [#Javaoptions опции Java]. Только на Web Start влияют [#run-options опции запуска]. См. [#Examples примеры]

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

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

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

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

Первый аргумент воспринимается 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`.
Элементы значения `--offline` разделяются запятыми.

=== Опции Java ===#Javaoptions

Опции Java именуются также ''опциями JOSM JVM'' здесь или ''аргументами VM'' в [wiki:/Ru:Help/Action/ShowStatusReport отчёте о состоянии]. В этом отчёте можно увидеть их, а также  аргументы программы. Они управляют виртуальной машиной Java [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] и могут задавать [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html свойства] внутри неё. 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` может быть полезна при возникновении ошибок [wiki:/Ru:Download#Outofmemory «не хватает памяти»].
Если вы укажете общий каталог опцией `Djosm.home`, то JOSM создаст подкаталоги ''./autosave'', ''./cache'' и ''./validator''.
Если значение содержит пробелы, заключите их в кавычки, вот так: `"josm dev"`.

=== Опции запуска ===
Опции запуска следуют за командой `javaws`. Они управляют механизмом Web Start и средой для JVM. 
{{{
  -offline                  Позволяют выполнить Web Start JOSM без доступа к Интернету
  -J<опции java>            Передаёт <опции java> в JVM 
  -J-Xmx1024m               Здесь: задать максимальный размер кучи Java равным 1024 МБ
}}}

Опция `-J` берёт свою часть после буквы J и передаёт её в качестве опций Java. 
[wiki:/Ru:Help/jnlpOptions Файл .jnlp], используемый [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start], предлагает и другой способ [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html  задать опции] для JRE и непосредственно на программы JOSM.

=== Примеры ===
{{{
#!sh
# Загрузить три файла
  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
# Кавычки для значения с пробелом
  java -Djosm.dir.name="josm dev" -jar josm.jar
# Задать общий каталог в подкаталоге
  java -Djosm.home=biketour2017/london -jar josm.jar
# Больше памяти в среде с французским интерфейсом
  java -Xmx1024m -Duser.language=fr -jar josm.jar
#
# Журналировать всё происходящее на английском
  java -verbose  -jar josm-latest.jar --language=en --debug >WhatsUp.txt
}}}

=== Смотрите также ===
* [wiki:Ru:Download#Troubleshooting Решение проблем с Java]
* [wiki:Ru:InstallNotes Примечания по установке]
* [wiki:Ru:Help/Preferences Настройки] - обзорная страница обо всех настройках

Note: See WikiFormatting and TracWiki for help on editing wiki content.

Change information

Your email or username:

E-mail address and name can be saved in the Preferences

Comment about this change (optional):

Note: See TracWiki for help on using the wiki.