[[TranslatedPages(revision=31)]] = Параметры командной строки = {{{#!comment Нет оглавления. Вместо этого первый параграф знакомит с проблемой и предлагает внутренние сслыки на заголовки. }}} JOSM управляется тремя группами параметров командной строки. Наиболее важны [#Programarguments аргументы программы⤓], затем [#Javaoptions опции Java⤓]. Смотрите [#Examples примеры⤓] использования тех и других. Только на Web Start влияют [#run-options опции запуска⤓]. В последней секции рассматриваются [#Otheroptions другие⤓] опции, которые используются где-то в этом справочном руководстве. {{{ #!sh # Запуск jar java [опции Java] -jar josm-tested.jar [аргументы программы] # Запуск через Web Start javaws [опции запуска] -J[опции Java] josm.jnlp }}} === Аргументы программы ===#Programarguments Также именуются ''аргументами после 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, содержащему координаты наподобие lat=x&lon=y&zoom=z [--download=]<имя файла> Открыть файл (то же, что и меню Файл/Открыть) --downloadgps=minlat,minlon,maxlat,maxlon Скачать указанную область, как "сырой" GPS --downloadgps= Скачать по URL, как "сырой" GPS --selection=<строка поиска> Выделить объекты по результатам заданного поиска --[no-]maximize Запустить JOSM развёрнутым во весь экран --reset-preferences Сбросить настройки к значениям по умолчанию --load-preferences= Импортировать настройки из XML-файла --set== Присвоить настройке key значение value --language=<язык> Задать язык интерфейса --version Показать версию JOSM и выйти --debug Выводить отладочные сообщения в консоль --skip-plugins Пропустить загрузку модулей --offline=[osm_api,][josm_website,][all] Отключить доступ к указанным ресурсам }}} Часть `--download=` опции download является не обязательной. Аргументы `--download`, `--downloadgps` и `--selection` обрабатываются именно в таком порядке, как перечислены здесь. Значение `` может указывать на локальный файл `file:relative/path/name.xml`. Более подробный вывод, чем --debug, обеспечивает опция `--trace`. Элементы значения `--offline` разделяются запятыми. === Опции Java ===#Javaoptions Опции Java именуются также ''опциями JOSM JVM'' здесь или ''аргументами VM'' в [wikitr:/Help/Action/ShowStatusReport отчёте о состоянии]. В этом отчёте можно увидеть аргументы, с которыми была запущена программа, а ниже их — аргументы VM. Они управляют виртуальной машиной 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"`. Если в командной строке встречаются не-ASCII символы, используйте `-Dfile.encoding=Cp850` для получения текста из Java в другой [https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html кодировке]. То, какая [https://msdn.microsoft.com/de-de/library/windows/desktop/dd317756%28v=vs.85%29.aspx кодировка] используется, покажет `chcp⏎` в терминале. === Примеры ===#Examples Примеры аргументов программы и опций Java в действии: {{{ #!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 # Кавычки для значения с пробелом и показ интерфейса 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 }}} === Опции запуска ===#run-options Опции запуска следуют за командой `javaws`. Они управляют механизмом Web Start и средой для JVM. {{{ -offline Позволяет осуществлять Web Start JOSM без доступа к интернету -J<опции java> Передаёт <опции java> в JVM -J-Xmx1024m Здесь: задать максимальный размер кучи Java равным 1024 МБ }}} Опция `-J` берёт свою часть после буквы J и передаёт её в качестве опций Java. [wiki:/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. === Другие опции ===#Otheroptions Команда javaws на всех системах и josm.exe в MS Windows имеют несколько дополнительных [http://launch4j.sourceforge.net/docs.html#Runtime_options опций]. {{{ #!sh 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-файле. === Смотрите также === * [wiki:/Ru:Download#Troubleshooting Решение проблем с Java] * [wikitr:/InstallNotes Примечания по установке] * [wikitr:/Help/Preferences Настройки] - обзор настроек * [.. Основная страница]