Опции динамической настройки Eclipse
Версия 3.1 - Дата последнего исправления 15 июня 2005 г.
Платформа Eclipse предоставляет широкие возможности настройки. Входные данные
настройки представляют собой аргументы командной строки и свойства
системы. В большинстве случаев аргументы командной строки позволяют быстро задать
некоторые свойства системы. Однако число свойств системы значительно превышает
число аргументов командной строки.
Аргументы командной строки
Ниже перечислены аргументы командной строки, поддерживаемые различными компонентами среды
выполнения Eclipse. Кроме того, многие из этих значений можно указывать с помощью системных свойств из командной строки с параметрами -D VM, а также указывая значение в файле config.ini, либо с помощью файла <launcher>.ini.
Эти два способа
позволяют полностью настроить Eclipse без применения аргументов командной строки.
Для каждого аргумента из списка в фигурных скобках {} указан ключ соответствующего свойства
системы. Кроме того, в круглых скобках () указан уровень среды выполнения Eclipse, на
котором обрабатывается аргумент командной строки. Эта информация может быть полезна при
замене отдельных компонентов среды выполнения в соответствии с конкретными
потребностями.
- -application <ИД> (среда выполнения)
- аналогично указанию значения <ИД> для свойства eclipse.application
- -arch <архитектура> (OSGi)
- аналогично указанию значения <архитектура> для свойства osgi.arch
- -clean (OSGi)
- аналогично указанию значения <true> для свойства osgi.clean
- -configuration <расположение> (основной уровень)
- аналогично указанию значения <расположение> для свойства osgi.configuration.area
- -console [port] (OSGi)
- аналогично указанию значения [порт] для свойства
osgi.console. Пустая строка соответствует порту по умолчанию
(т.е. порт не указан)
- -consoleLog (среда выполнения)
- аналогично указанию значения "true" для свойства eclipse.consoleLog
- -data <расположение> (OSGi)
- аналогично указанию значения <расположение> для свойства osgi.instance.area
- -debug [файл опций] (OSGi)
- аналогично указанию значения [файл опций] для свойства
osgi.debug. Если указана пустая строка устанавливается режим
отладки (т.е. не указано расположение файла опций)
- -dev [записи] (OSGi)
- аналогично указанию значения [записи] для свойства
osgi.dev. Если указана пустая строка устанавливается режим
dev (т.е. записи не указаны)
- -endSplash <команда> (основной уровень)
- Указывает команду, применяемую для закрытия заставки. Как правило, она
предоставляется исполняемым файлом Eclipse.
- -feature <комплект> (среда выполнения)
- аналогично указанию значения <ИД-комплекта> для свойства eclipse.product
- -framework <расположение> (основной уровень)
- аналогично указанию значения <расположение> для свойства osgi.framework
- -initialize (основной уровень)
- позволяет выполнить инициализацию запускаемой конфигурации. При этом обновляются
все структуры данных и области кэша, связанные с выполнением. Данные конфигурации,
определенные пользователем или модулем, не очищаются. Запуск приложений не выполняется,
спецификации продуктов игнорируются, пользовательский интерфейс не активируется
(например, не отображается заставка)
- -install <расположение> (основной уровень)
- аналогично указанию значения <расположение> для свойства osgi.install.area
- -keyring <расположение> (среда выполнения)
- расположение базы данных идентификации на диске. Этот аргумент следует применять
совместно с аргументом -password.
- -name <string> NEW
- Имя, отображаемое в панели задач при запуске приложения. Если этот атрибут не задан, то отображается имя исполняемого файла.
- -nl <локаль> (OSGi)
- аналогично указанию значения <локаль> для свойства osgi.nl
- -noExit (OSGi)
- аналогично указанию значения "true" для свойства osgi.noShutdown
- -noLazyRegistryCacheLoading (среда выполнения)
- аналогично указанию значения <true> для свойства
eclipse.noLazyRegistryCacheLoading
- -noRegistryCache (среда выполнения)
- аналогично указанию значения <true> для свойства
eclipse.noRegistryCache
- -noSplash (исполняемый файл, основной уровень)
- позволяет разрешить или запретить отображение заставки
- -os <операционная-система> (OSGi)
- аналогично указанию значения <операционная система> для свойства osgi.os
- -password <пароль> (среда выполнения)
- пароль к базе данных идентификации
- -pluginCustomization <расположение> (среда выполнения)
- аналогично указанию значения <расположение> для свойства eclipse.pluginCustomization
- -product <id> (OSGi)
- аналогично указанию значения <ИД> для свойства eclipse.product
- -showSplash <команда> (основной уровень)
- Указывает команду, применяемую для отображения заставки. Как правило, она входит в
состав исполняемого файла Eclipse.
- -startup <расположение> (Executable) NEW
- Расположение файлов jar, применяемых для запуска Eclipse. В указанном файле jar должен быть задан атрибут класса Main.
Если этот параметр не задан, применяется файл startup.jar, расположенный в одной папке с исполняемым файлом.
- -user <расположение> (OSGi)
- аналогично указанию значения <расположение> для свойства osgi.user.area
- -vm <путь к исполняемому файлу java> (исполняемый файл, основной уровень)
- эта опция позволяет найти виртуальную машину Java для запуска Eclipse. В качестве значения следует указать полный путь в подходящему исполняемому файлу Java. По
умолчанию (если путь не указан) исполняемый файл Eclipse автоматически выполняет поиск
подходящей виртуальной машины. В результате исполняемый файл передает путь
к виртуальной машине модулю Java Main с помощью аргумента -vm. Модуль Java Main сохраняет
это значение в свойстве eclipse.vm.
- -vmargs [vmargs*] (исполняемый файл, основной уровень)
- эта опция позволяет настроить работу виртуальной машины Java, применяемой для
запуска Eclipse. Если этот параметр указан, то он должен быть
последним в командной строке. Если значение не указано исполняемый файл с
помощью аргумента -vmargs автоматически
добавит в команду, передаваемую модулю Jave Main, необходимые аргументы (в том числе
запускаемый класс).
Модуль Java Main сохраняет это значение в свойстве
eclipse.vmargs.
- -ws <система-организации-окон> (OSGi)
- аналогично указанию значения <система-организации-окон> для свойства
osgi.ws
Устаревшие аргументы командной строки
Ниже перечислены аргументы, которые устарели или были заменены. Для сохранения
обратной совместимости среда выполнения не передает их приложению. .
- -boot
- см. -configuration
- -classLoaderProperties
- не поддерживается
- -firstUse
- не поддерживается
- -newUpdates
- не поддерживается
- -noPackagePrefixes
- не поддерживается
- -noUpdate
- не поддерживается
- -plugins
- не поддерживается
- -update
- не поддерживается
Прочие
Следующие аргументы командной строки определяются различными модулями Eclipse и
поддерживаются только в том случае, если соответствующие модули установлены,
обработаны и активированы.
- -noVersionCheck (рабочая среда)
- <описание>
- -perspective (рабочая среда)
- <описание>
- -refresh (org.eclipse.core.resources)
- <описание>
- -showLocation (org.eclipse.ui.ide.workbench)
- <описание>
- -allowDeadlock
- <описание>
Свойства системы
Следующие свойства системы используются средой выполнения Eclipse. Обратите внимание,
что свойства, имена которых начинаются с "osgi", относятся к реализации среды
OSGi, а свойства, имена которых начинаются с "eclipse", относятся к среде
выполнения Eclipse, расположенной над средой OSGi.
Для некоторых свойств предусмотрены эквивалентные аргументы командной строки
(см. раздел аргументы командной строки и значения, заключенные
в фигурные скобки). Помимо свойств значение можно указать с помощью командной
строки. Свойства можно задать одним из следующих способов:
- указать -DpropName=propValue в качестве аргумента VM для виртуальной машины Java
- задать нужное свойство в файле config.ini соответствующей области настройки
- eclipse.application {-application}
- идентификатор запускаемого приложения. Указанное значение переопределяет
приложение, определенное запускаемым продуктов (см. eclipse.product)
- eclipse.commands
- разделенный строками список всех аргументов командной строки, примененных при запуске
- eclipse.consoleLog
- если указано значение "true", вывод протокола отправляется в System.out
Java (как правило, обратно командной оболочке). Рекомендуется использовать совместно с
аргументом -debug
- eclipse.debug.startupTime
- время запуска виртуальной машины Java для текущего сеанса в миллисекундах
- eclipse.exitcode
- <описание>
- eclipse.exitdata
- <описание>
- eclipse.log.backup.max
- максимальное разрешенное число резервных копий файлов протокола. Самый старый резервный файл протокола будет удален, как только будет достигнуто максимальное число резервных файлов. Значение по умолчанию равно "10". Если указано отрицательное значение или ноль, то будет применено значение по умолчанию.
- eclipse.log.size.max
- максимально допустимый размер файла протокола, указанный в килобайтах. Как только файл превышает максимальный размер, начинается запись другого файла. Значение по умолчанию равно "1000".
Если указано отрицательное значение, то будет применено значение по умолчанию. Нулевое значение соответствует неограниченному размеру протокола.
- eclipse.noExtensionMunging
- если указано значение "true", устаревшие расширения реестра не
изменяются. По умолчанию такие расширения обновляются для применения ИД новых точек
расширения, предусмотренных в Eclipse 3.0.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- если указано значение "true", то оптимизация загрузки кэша реестра
модулей платформы не применяется. По умолчанию элементы конфигурации загружаются из кэша
реестра (если он доступен) только по требованию, что обеспечивает более
эффективное использование памяти. Данная опция позволяет в процессе запуска
принудительно загрузить весь кэш реестра.
- eclipse.noRegistryCache {-noRegistryCache}
- если указано значение "true", внутренний кэш реестра расширения будет
недоступен для чтения и записи
- eclipse.pluginCustomization {-pluginCustomization}
- расположение файла свойств, содержащего значения параметров модуля по умолчанию, в файловой
системе. Эти значения по умолчанию переопределяют параметры, заданные в базовом комплекте.
Относительные пути указаны относительно текущего рабочего
каталога Eclipse.
- eclipse.product {-product}
- идентификатор запускаемого продукта. Он управляет применением приложения и
информацией о торговых знаках.
- eclipse.startTime
- Это свойство задается при запуске Eclipse. Значение этого свойство - строковое представление значения, возвращенного System.currentTimeMillis(). Это значение не задается пользователем.
- путь к исполняемому файлу Java, с помощью которого запускается Eclipse. Эта
информация применяется для создания командных строк повторного запуска.
- eclipse.vmargs {-vmargs}
- позволяет просмотреть список аргументов виртуальной машины, указанных при запуске Eclipse.
Эта информация применяется для создания командных строк повторного запуска.
- osgi.adaptor
- имя класса применяемого адаптера среды OSGi.
- osgi.arch {-arch}
- см. -arch
- osgi.baseConfiguration.area
- задает основную конфигурацию, применяемую, когда не указана область конфигурации osgi.configuration.area.
- osgi.bundles
- Список комплектов, которые автоматически
устанавливаются и запускаются при необходимости после активации и запуска системы. В
качестве разделителя применяется запятая. Записи
указываются в следующем формате:
<URL | расположение простого комплекта>[@ [<начальный-уровень>] [":start"]]
Если начальный-уровень (целое >0) пропущен, для комплекта применяется начальный
уровень по умолчанию. Тег "start" позволяет запустить комплект после
установки. Предполагается, что простые расположения комплектов указаны относительно
родительского каталога среды. Начальный-уровень задает начальный уровень OSGi для
запуска комплекта. Если это значение не указано, система автоматически вычисляет
подходящее значение по умолчанию.
- osgi.clean
- если указано значение "true", из кэша удаляются данные, применяемые средой
OSGi и средой выполнения Eclipse. Процедура очистки охватывает области кэша, в которых
хранятся данные, связанные с обработкой зависимостей комплектов и реестром расширений
Eclipse. Данная опция позволяет принудительно выполнить повторную инициализацию этих
областей кэша.
- osgi.configuration.cascaded
- если указано значение "true", то текущая конфигурация просматривается
вплоть до родительской конфигурации. Родительская конфигурация задается osgi.sharedConfiguration.area. Дополнительная информация
приведена в разделе, посвященном расположениям.
- osgi.configuration.area {-configuration}
- расположение конфигурации для запуска платформы. Конфигурация задает
список запускаемых модулей, а также набор различных параметров системы.
Дополнительная информация приведена в разделе, посвященном
расположениям.
- osgi.configuration.area.default
- расположение конфигурации для запуска платформы по умолчанию. Конфигурация задает
список запускаемых модулей, а также набор различных параметров системы.
Это значение (значение по умолчанию) применяется только в том случае, если не
указано значение свойства osgi.configuration.area. Дополнительная информация приведена в
разделе, посвященном расположениям.
- osgi.console {-console}
- если указано значение, отличное от нуля, то активируется консоль OSGi (при ее
наличии). Если указано допустимое целое число, оно задает номер порта, с помощью которого
консоль обменивается данными. Консоль удобна для проверки состояния системы.
- osgi.console.class
- имя класса консоли, запускаемой по запросу
- osgi.debug {-debug}
- если указано значение, отличное от нуля, то платформа переводится в режим
отладки. Если в качестве значения указана строка, она обрабатывается как расположение
файла .options. Этот файл задает точки отладки, доступные для модуля, а также их
состояния. Если расположение не указано, платформа выполняет поиск файла .options в
установочном каталоге.
- osgi.dev {-dev}
- если указана пустая строка, устанавливается режим dev. Кроме того, в этом свойстве
можно указать перечисленные через запятую записи, добавляемые в
путь к классам каждого модуля, или URL файла свойств Java, содержащего пользовательские
дополнения путей к классам для набора модулей. Для каждого модуля, предусматривающего
настроенный путь к классам в режиме dev, в файле будет содержаться запись в следующем
формате:
<ИД-модуля>=<список добавляемых записей путей к классам, разделенный запятыми>
ИД-модуля "*" соответствует любому модулю, не указанному явным образом.
- osgi.framework
- URL расположения среды OSGi. Рекомендуется применять в случае разделенной
установки Eclipse.
Дополнительная информация приведена в разделе, посвященном
расположениям.
- osgi.frameworkClassPath
- список записей путей к классам для реализации среды OSGi. В качестве разделителя
применяется запятая. Относительные расположения рассматриваются относительно расположения среды (см.
osgi.framework)
- osgi.framework.extensions
- Список расширений среды, разделенных запятыми. Записи
указываются в следующем формате:
<URL | простое расположение комплекта>
Если задано простое расположение комплектов (не URL), то поиск выполняется в родительском каталоге комплекта org.eclipse.osgi. Для запуска Eclipse с другим адаптером среды можно использовать расширения среды. Расширение среды может содержать файл eclipse.properties для задания системных свойств. Например, расширение среды, обеспечивающее реализацию адаптера среды, может указывать класс адаптера с помощью свойства osgi.adaptor.
- В качестве значения osgi.framework.shape
- задана форма реализации среды Eclipse OSGi. Это свойство задается при запуске платформы Eclipse и не предназначено для того, чтобы его задавал пользователь. Значение "jar" указывает, что среда Eclipse OSGi содержится в одном файле jar. Значение "folder" указывает, что среда Eclipse OSGi содержится в каталоге.
- osgi.java.profile
- - URL файла, в котором содержится применяемый профайл среды выполнения Java. Профайл JRE содержит значения свойств org.osgi.framework.system.packages and org.osgi.framework.bootdelegation. Если osgi.java.profile не задан, то профайл выбирается на основе значения java.specification.version выполняемой JRE.
- osgi.java.profile.bootdelegation
-
Профайл Java osgi.java.profile может содержать свойство "org.osgi.framework.bootdelegation". Это значение может применяться для задания системного свойства "org.osgi.framework.bootdelegation". Свойство osgi.java.profile.bootdelegation
указывает применяемую политику bootdelegation. Допустимы следующие значения (ignore по умолчанию):
- ignore - указывает, что значение "org.osgi.framework.bootdelegation" в профайле Java игнорируется. В этом случае применяется системное свойство "org.osgi.framework.bootdelegation", определяющее, какие пакеты делегируются к загрузке.
- override -
указывает, что "org.osgi.framework.bootdelegation" в профайле Java переопределяет системное свойство "org.osgi.framework.bootdelegation".
- none - указывает, что "org.osgi.framework.bootdelegation" в профайле Java И системные свойства игнорируются. Это самый строгий параметр. В результате применения этого параметра среда будет использовать строгую модель загрузочного делегирования OSGi R4.
- osgi.install.area {-install}
- установочное расположение платформы. Это свойство задает расположение базовых модулей
Eclipse. Рекомендуется применять его в случае разделенной установки Eclipse.
Дополнительная информация приведена в разделе, посвященном
расположениям.
- osgi.instance.area {-data}
- расположение данных экземпляра в текущем сеансе. Это расположение применяется для
хранения данных модулей. Например, модуль ресурсов использует его в качестве
расположения по умолчанию для проектов (рабочая область). Дополнительная информация приведена в
разделе, посвященном расположениям.
- osgi.instance.area.default
- расположение данных экземпляра по умолчанию в текущем сеансе. Это расположение применяется
для хранения данных модулей. Например, модуль ресурсов использует его в качестве
расположения по умолчанию для проектов (рабочая область). Это значение (значение по
умолчанию) применяется только в том случае, если не указано значение свойства
osgi.instance.area. Дополнительная информация приведена в разделе, посвященном
расположениям.
- osgi.locking
- фиксирующий тип, применяемый при данном запуске платформы. Допустимы следующие фиксирующие типы: "java.io", "java.nio", а также"none". Значение по умолчанию - "java.nio", если только JRE не поддерживает "java.nio". В этом случае значение по умолчанию - "java.io".
- osgi.manifest.cache
- расположение для создания и поиска манифестов. По умолчанию
используется область конфигурации, однако кэш манифестов можно хранить отдельно.
- osgi.nl {-nl}
- имя локали для запуска платформы Eclipse. Имена национальных языков должны
соответствовать стандартным соглашениям Java об именах локалей.
- osgi.noShutdown {-noExit}
- если указано значение "true", то виртуальная машина не завершит работу после выхода из Eclipse. Это может потребоваться для изучения среды OSGi после завершения работы Eclipse.
- osgi.os {-os}
- значение операционной системы. Допустимы имена архитектур процессоров, известных
платформе Eclipse (например, x86, sparc, ...).
- osgi.parentClassLoader
- тип загрузчика классов, применяемый в качестве родительского загрузчика классов для всех комплектов, установленных в среде. Допустимы следующие типы:
- app - загрузчик классов приложений.
- boot - загрузочный загрузчик классов.
- ext - загрузчик классов расширений.
- fwk - загрузчик классов среды.
- osgi.requiredJavaVersion
- Минимальная версия Java, необходимая для запуска Eclipse. Значение по умолчанию - "1.4.1".
- osgi.resolverMode
- режим, применяемый для преобразования комплектов, установленных в среде. Значение "strict" переключает преобразователь в строгий режим. По умолчанию применяется нестрогий режим. Когда преобразователь работает в строгом режиме, среда применяет правила ограничения доступа при загрузке классов и ресурсов из экспортированных пакетов, которые указывают директивы x-internal или x-friends.
- osgi.sharedConfiguration.area
- общее расположение конфигурации для запуска платформы. Если значение свойства osgi.configuration.cascaded равно "true", то в качестве родительской конфигурации применяется общая область конфигурации.
- osgi.splashLocation
- полный URL расположения заставки (файл .bmp), отображаемой в ходе запуска
Eclipse. Это свойство переопределяет значение, указанное в
свойстве osgi.splashPath.
- osgi.splashPath
- список URL для поиска файла splash.bmp, разделенных запятыми. Это свойство
переопределяется значением, указанным в свойстве osgi.splashLocation.
- Свойство osgi.syspath
- указывает путь, где расположена реализация среды Eclipse OSGi (org.eclipse.osgi). Например, "<путь-установки-eclipse>/eclipse/plugins".
Это свойство задается при запуске платформы Eclipse автоматически и не задается пользователем.
- osgi.user.area {-user}
- расположение пользовательской области. Пользовательская область содержит данные
(например, параметры), относящиеся к пользователю операционной системы, которые не
зависят от установки, конфигурации или экземпляра Eclipse. Дополнительная информация
приведена в разделе, посвященном расположениям.
- osgi.user.area.default
- расположение пользовательской области по умолчанию. Пользовательская область
содержит данные (например, параметры), относящиеся к пользователю операционной системы,
которые не зависят от установки, конфигурации или экземпляра Eclipse. Это значение
(значение по умолчанию) применяется только в том случае, если не указано значение
свойства osgi.user.area. Дополнительная информация приведена в
разделе, посвященном расположениям.
- osgi.ws {-ws}
- значение системы организации окон. Допустимы имена систем организации окон,
известных платформе Eclipse (например, win32, motif, ...).
Расположения
Среда выполнения Eclipse определяет набор расположений, предоставляющих
разработчику модулей контекст для чтения/сохранения данных, а пользователю Eclipse -
возможность управления совместным использованием и видимостью данных. В Eclipse
предусмотрены следующие определения расположений:
- Пользовательское расположение (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
- Пользовательские расположения предназначены для пользователей. Как
правило, пользовательское расположение создается на основе значения свойства системы
Java
user.home
. Однако при необходимости его можно переопределить. В
пользовательском расположении можно найти такую информацию, как параметры
пользователя и информацию о входе в систему.
- Установочное расположение (-install) {osgi.install.area} [@user.home, @user.dir, filepath, url]
- Установочное расположение Eclipse. Фактически это расположение представляет собой
каталог (как правило, "eclipse"), в котором содержится файл startup.jar или
eclipse.exe. Поскольку отдельный экземпляр Eclipse может совместно использоваться несколькими
пользователями, обычным пользователям этот каталог должен быть доступен только для
чтения. При необходимости можно задать собственное установочное расположение, в котором
файл startup.jar будет храниться отдельно от остальных компонентов Eclipse.
- Расположение конфигурации (-configuration) {osgi.configuration.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
- Расположения конфигураций содержат файлы, позволяющие дополнительно
настроить Eclipse перед запуском. Таким образом, для отдельной установки можно использовать
несколько конфигураций. В некоторых случаях вместе с Eclipse поставляются области
конфигурации по умолчанию, однако как правило сценарии запуска предусматривают поиск более
подходящего расположения конфигурации.
- Расположение экземпляра (-data) {osgi.instance.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
- Расположения экземпляров содержат артефакты пользовательских данных. Например,
модуль ресурсов использует область экземпляра в качестве расположения рабочей области и домашнего
каталога проектов. Остальные модули могут записывать в это расположение
произвольную информацию.
Все рассмотренные расположения могут быть указаны пользователями, однако
если значения не заданы, Eclipse автоматически вычисляет подходящие значения по
умолчанию. Наиболее часто задается расположение области экземпляра (в контексте
интегрированное среды разработки - рабочей среды). Для запуска конфигурации
Eclipse по умолчанию в конкретном наборе данных укажите следующую команду:
eclipse -data c:\mydata
Дополнительная информация
Расположения представляют собой URL. Пути к файлам также допустимы и автоматически
преобразуются в URL (формат file:). Кроме того, для более эффективного
управления предусмотрены предопределенные символьные
расположения. Обратите внимание, что допустимы не все комбинации типов расположений и
символьных значений. В следующей таблице перечислены разрешенные комбинации. Поскольку
по умолчанию должны быть заданы все расположения, изменение конфигурации может привести к
сбою некоторых модулей, которые указаны как допустимые. Например, не имеет смысла
ожидать, что модуль, предназначенный для работы с пользовательскими
данными (например, модуль ресурсов Eclipse), будет применим, если не задана область
экземпляра. Разработчики модулей должны выбирать
поддерживаемые конфигурации и проектировать функций соответствующим образом.
- @none
- Указывает, что соответствующее расположение запрещено указывать как явным
образом, так и по умолчанию. Например, приложение RCP, не обрабатывающее пользовательские
данные, с помощью свойства osgi.instance.area=@none может запретить запись на диск
внешних файлов. После значения @none не следует указывать дополнительные сегменты
пути.
- @noDefault
- Позволяет принудительно разрешить задание расположения только явным
образом (т.е. Eclipse автоматически не будет предлагать значение по умолчанию). Например,
если требуется разрешить сохранение данных в соответствующем расположении, но значение
Eclipse по умолчанию для этой цели неприменимо. После значения @noDefault не следует указывать
дополнительные сегменты пути.
- @user.home
- Указывает Eclipse, что значение расположения должно быть указано относительно
домашнего каталога пользователя. После @user.home можно указать дополнительные сегменты
пути. Во любом случае строка "@user.home" заменяется значением свойства системы
Java "user.home". Например, параметр
osgi.instance.area=@user.home/myWorkspace
преобразуется в значение
file:/users/bob/myWorkspace
- @user.dir
- Указывает Eclipse, что значение расположения должно быть указано относительно
текущего рабочего каталога. После @user.dir можно указать дополнительные сегменты пути.
В любом случае строка "@user.dir" заменяется значением свойства системы Java
"user.dir". Например, параметр
osgi.instance.area=@user.dir/myWorkspace
преобразуется в значение
file:/usr/share/eclipse/myWorkspace
расположение/значение |
поддерживает значение по умолчанию |
файл/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
расположение экземпляра
|
да |
да
|
да
|
да
|
да
|
да (по умолчанию)
|
расположение конфигурации
|
да
|
да
|
да*
|
да*
|
да
|
да
|
установочное расположение
|
нет
|
да
|
нет
|
нет
|
да
|
да
|
пользовательское расположение
|
да
|
да
|
да
|
да
|
да
|
да
|
* указывает, что настройка технически возможна, однако реализация может быть связана с
трудностями. В частности, если не указано расположение конфигурации, то работа среды
выполнения Eclipse будет ограничена только запуском среды OSGi.
Расположения только для чтения
Расположение может быть предназначено только для чтения, если к свойству расположения добавить ".readOnly" и указать значение"true". Для того, чтобы сделать соответствующие расположения доступными только для чтения, применяются следующие свойства:
Файл Launcher ini
Файл eclipse.exe и вообще исполняемые файлы приложений RCP читают параметры из соответствующего файла инициализации. Этот файл позволяет платформе независимо применять аргументы, которые ранее было необходимо вводить непосредственно в командной строке (например, vm или аргументы vm). Несмотря на то, что в этом файле можно указывать все параметры, из соображений надежности и для согласования с другими установками рекомендуется указывать в этом файле инициализации только расположение и аргументы виртуальной машины, а для остальных параметров использоватьфайл config.ini.
Формат файла
Имя этого файла должно совпадать с именем соответствующего исполняемого файла (например, eclipse.exe будет читать eclipse.ini, а launcher.exe -launcher.ini), а каждый параметр должен быть указан на новой строке. Ниже приведен пример файла, в котором задано расположение виртуальной машины, а также некоторые другие параметры:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M