Las opciones de entorno de ejecución de Eclipse
Versión 3.1 - Última revisión: 15 de junio de 2005
La plataforma Eclipse es altamente configurable. La información de entrada de la configuración toma la forma de argumentos de línea de mandatos y valores de propiedades del sistema. El muchos casos, los argumentos de línea de mandatos son simplemente atajos para establecer las propiedades del sistema relacionadas. De hecho, existen muchos más valores de propiedades del sistema que argumentos de línea de mandatos.
Argumentos de línea de mandatos
A continuación se indican los argumentos de línea de mandatos procesados por diversos componentes del entorno de ejecución de Eclipse.
Muchos de estos valores también pueden especificarse mediante propiedades del
sistema, ya sea en la línea de mandatos utilizando argumentos -D de VM,
especificando sus valores en un archivo config.ini, o mediante un archivo <launcher>.ini.
Empleando estas dos últimas técnicas, es posible personalizar Eclipse sin
utilizar en absoluto argumentos de línea de mandatos.
Para cada argumento de la lista, se suministra su clave de propiedad del sistema correspondiente (entre {}). También se indica la capa del entorno de ejecución de Eclipse en la que se procesa el argumento de línea de mandatos (entre ()). Esto resulta de utilidad para los usuarios que sustituyen componentes del entorno de ejecución a fin de adaptarlo a necesidades especiales.
- -application <ID> (Entorno de ejecución)
- equivalente a establecer eclipse.application
en <id>
- -arch <arquitectura> (OSGi)
- equivalente a establecer osgi.arch en <architecture>
- -clean (OSGi)
- equivalente a establecer osgi.clean en "true"
- -configuration <ubicación> (Main)
- equivalente a establecer osgi.configuration.area
en <ubicación>
- -console [puerto] (OSGi)
- equivalente a establecer osgi.console en [puerto]
o en la serie vacía si debe utilizarse el puerto por omisión (es decir, cuando no se especifica el puerto)
- -consoleLog (Entorno de ejecución)
- equivalente a establecer eclipse.consoleLog en "true"
- -data <ubicación> (OSGi)
- equivalente a establecer osgi.instance.area
en <ubicación>
- -debug [archivo de opciones] (OSGi)
- equivalente a establecer osgi.debug en [archivo de opciones] o en la serie vacía para habilitar simplemente la depuración (es decir, si no se especifica la ubicación del archivo de opciones)
- -dev [entradas] (OSGi)
- equivalente a establecer osgi.dev en [entradas] o en la serie vacía para habilitar simplemente la modalidad dev (es decir, si no se especifican entradas)
- -endSplash <mandato> (Main)
- especifica el mandato que debe utilizarse para eliminar la pantalla de inicio. Generalmente lo suministra el ejecutable de Eclipse.
- -feature <ID característica> (Entorno de ejecución)
- equivalente a establecer eclipse.product
en <ID característica>
- -framework <ubicación> (Main)
- equivalente a establecer osgi.framework en
<ubicación>
- -initialize (Main)
- inicializa la configuración que se ejecuta. Se renuevan todas las estructuras de datos y antememorias relacionadas con el entorno de ejecución. No se eliminan los datos de configuración definidos por conectores o usuarios. No se ejecuta ninguna aplicación, las especificaciones de producto se pasan por alto y no se presenta ninguna UI (por ejemplo, no aparece la pantalla de inicio)
- -install <ubicación> (Main)
- equivalente a establecer osgi.install.area en
<ubicación>
- -keyring <ubicación> (Entorno de ejecución)
- la ubicación de la base de datos de autorizaciones en el disco. Este argumento debe utilizarse junto con el argumento -password.
- -name <serie> NEW
- Nombre que se debe visualizar en el elemento de la barra de tareas cuando
se inicie la aplicación. Si no se establece, el nombre es el del ejecutable.
- -nl <entorno local> (OSGi)
- equivalente a establecer osgi.nl en <entorno
local>
- -noExit (OSGi)
- equivalente a establecer osgi.noShutdown en
el valor "true"
- -noLazyRegistryCacheLoading (Entorno de ejecución)
- equivalente a establecer eclipse.noLazyRegistryCacheLoading
en "true"
- -noRegistryCache
(Entorno de ejecución)
- equivalente a establecer eclipse.noRegistryCache
en "true"
- -noSplash (Ejecutable, Main)
- controla si se muestra la pantalla de inicio
- -os <sistema operativo> (OSGi)
- equivalente a establecer osgi.os en <sistema
operativo>
- -password <contraseña> (Entorno de ejecución)
- la contraseña de la base de datos de autorizaciones
- -pluginCustomization <ubicación> (Entorno de ejecución)
- equivalente a establecer eclipse.pluginCustomization en
<ubicación>
- -product <ID> (OSGi)
- equivalente a establecer eclipse.product en
<ID>
- -showSplash <mandato> (Main)
- especifica el mandato que debe utilizarse para mostrar la pantalla de inicio. Generalmente lo suministra el ejecutable de Eclipse.
- -startup <ubicación> (Ejecutable) NEW
- Ubicación del archivo jar utilizado para el inicio de Eclipse. El archivo
jar referenciado debe tener establecido el atributo Main-Class.
Si no se establece este parámetro, se utilizará el archivo startup.jar
ubicado en la misma carpeta que el ejecutable.
- -user <ubicación> (OSGi)
- equivalente a establecer osgi.user.area en
<ubicación>
- -vm <vía de acceso a ejecutable Java> (Executable, Main)
- cuando se pasa al ejecutable de Eclipse, esta opción se utiliza para localizar la VM Java que debe utilizarse para ejecutar Eclipse.
Debe ser la vía de acceso completa del sistema de archivos a un ejecutable Java
adecuado. Si no se especifica, el ejecutable de Eclipse utiliza un algoritmo de búsqueda para localizar una VM adecuada. En cualquier caso, el ejecutable pasa a continuación la vía de acceso a la VM real utilizada a Java Main mediante el argumento -vm. A continuación, Java
Main almacena este valor en eclipse.vm.
- -vmargs [vmargs*] (Ejecutable,
Main)
- cuando se pasa a Eclipse, esta opción se utiliza para personalizar la operación de la VM Java que debe utilizarse para ejecutar Eclipse. Si se especifica, esta opción debe ir al final de la línea de mandatos. Aunque no se especifique en la línea de mandatos del ejecutable, éste añadirá automáticamente los argumentos relevantes (incluida la clase que se lanza) a la línea de mandatos que se pasa a Java mediante el argumento -vmargs.
A continuación, Java
Main almacena este valor en eclipse.vmargs.
- -ws <sistema de ventanas> (OSGi)
- equivalente a establecer osgi.ws en <sistema de ventanas>
Argumentos de línea de mandatos obsoletos
Los siguientes argumentos de línea de mandatos ya no son relevantes o se han sustituido, sólo los utiliza el entorno de ejecución y no se pasan a la aplicación ejecutada para mantener la compatibilidad hacia atrás. .
- -boot
- consulte -configuration
- -classLoaderProperties
- ya no es relevante
- -firstUse
- ya no es relevante
- -newUpdates
- ya no es relevante
- -noPackagePrefixes
- ya no es relevante
- -noUpdate
- ya no es relevante
- -plugins
- ya no es relevante
- -update
- ya no es relevante
Otros
Diversos conectores de Eclipse definen los siguientes argumentos de línea de mandatos, que sólo están soportados si el conector que los define está instalado, resuelto y activado.
- -noVersionCheck (entorno de trabajo)
- <descripción>
- -perspective (entorno de trabajo)
- <descripción>
- -refresh (org.eclipse.core.resources)
- <descripción>
- -showLocation (org.eclipse.ui.ide.workbench)
- <descripción>
- -allowDeadlock
- <descripción>
Propiedades del sistema
El entorno de ejecución de Eclipse utiliza las siguientes propiedades del sistema. Tenga
en cuenta que aquellas que empiezan por "osgi" son específicas de la implementación
de la infraestructura OSGi, mientras que las que empiezan por "eclipse" son específicas del entorno de ejecución de Eclipse que se encuentra sobre la infraestructura de OSGi.
Muchas de estas propiedades tienen argumentos de línea de mandatos equivalentes (consulte
la sección Argumentos de línea de mandatos y el valor entre llaves
{}). Los usuarios pueden utilizar la línea de mandatos o los valores de propiedades para especificar un valor. Las propiedades pueden establecerse de las formas siguientes:
- utilizar -DpropName=propValue como argumento de VM para la VM Java
- establecer la propiedad deseada en el archivo config.ini del área de configuración adecuada
- eclipse.application {-application}
- identificador de la aplicación que debe ejecutarse. El valor especificado aquí altera
temporalmente cualquier aplicación definida por el producto ejecutado (consulte
eclipse.product)
- eclipse.commands
- una lista separada por caracteres de línea nueva de todos los argumentos
de línea de mandatos pasados al ejecutar Eclipse
- eclipse.consoleLog
- si es "true", la salida de anotaciones también se envía al archivo System.out
de Java (generalmente de nuevo a la shell de mandatos si existe). Muy útil cuando se combina
con -debug.
- eclipse.debug.startupTime
- hora de inicio en milisegundos de la VM Java de esta sesión
- eclipse.exitcode
- <descripción>
- eclipse.exitdata
- <descripción>
- eclipse.log.backup.max
- número máximo de archivos de registro de copia de seguridad que se van a
permitir. El archivo de registro de copia de seguridad más antiguo se suprimirá
después de alcanzarse el número máximo de archivos de registro de copia de
seguridad como resultado de la rotación del archivo de registro.
El valor por omisión es "10". Un valor negativo o cero causará la
utilización del valor por omisión.
- eclipse.log.size.max
- tamaño máximo en Kb que el archivo de registro tiene permiso para crecer. El
archivo de registro se rota cuando el tamaño de archivo sobrepasa el valor
máximo.
El valor por omisión es "1000".
Un valor negativo causará la utilización del valor por omisión.
Un valor de cero indica que el registro no tiene tamaño máximo.
- eclipse.noExtensionMunging
- si es "true", las extensiones de registro de legado se dejan tal cual. Por omisión, tales extensiones se actualizan para utilizar los nuevos ID de punto de extensión que se encuentran en Eclipse 3.0.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- si es "true", la optimización de carga de antememoria del registro de conectores de la plataforma se desactiva. Por omisión, los elementos de configuración se cargan desde
la antememoria del registro (cuando esté disponible) sólo si se solicita, reduciendo la
huella de la memoria. Esta opción forzará que la antememoria del registro se cargue completamente durante el inicio.
- eclipse.noRegistryCache {-noRegistryCache}
- Si es "true", la antememoria interna del registro de extensiones nunca se lee ni se escribe en ella
- eclipse.pluginCustomization {-pluginCustomization}
- ubicación en el sistema de archivos de un archivo de propiedades que contiene los
valores por omisión de las preferencias de los conectores. Estos valores por omisión
alteran temporalmente los valores por omisión que se especifican en la característica
primaria. Las vías de acceso relativas se
interpretan como relativas al directorio de trabajo actual del propio Eclipse.
- eclipse.product {-product}
- identificador del producto ejecutado. Controla diversa información de sello personal y la aplicación que se utiliza.
- eclipse.startTime
- Esta propiedad se establece cuando se inicia el eclipse de tiempo. El
valor de esta propiedad es una representación de serie del valor devuelto por
System.currentTimeMillis(). No se ha previsto que los usuarios establezcan este
valor.
- eclipse.vm {-vm}
- vía de acceso al ejecutable Java utilizado para ejecutar Eclipse. Esta información se utiliza para construir línea de mandatos de relanzamiento.
- eclipse.vmargs {-vmargs}
- lista los argumentos de VM utilizados para ejecutar Eclipse. Esta información se utiliza para construir línea de mandatos de relanzamiento.
- osgi.adaptor
- nombre de clase del adaptador de infraestructura OSGi que debe utilizarse.
- osgi.arch {-arch}
- consulte -arch
- osgi.baseConfiguration.area
- especifica una configuración básica que se utiliza cuando no se especifica
osgi.configuration.area.
- osgi.bundles
- Lista separada por comas de los paquetes compuestos que se instalan automáticamente y, opcionalmente, se inician una vez que el sistema está en funcionamiento. Cada entrada tiene el siguiente formato:
<URL | ubicación de paquete compuesto simple>[@ [<nivel-inicio>] [":start"]]
Si el nivel de inicio (>entero 0) se omite, la infraestructura utilizará el nivel de inicio por omisión para el paquete compuesto. Si se añade el código "start", el paquete compuesto se marcará como iniciado después de instalarlo.
Las ubicaciones de paquete compuesto simple se interpretan como relativas al directorio padre de la infraestructura.
El nivel de inicio indica el nivel de inicio de OSGi en el que el paquete compuesto debe ejecutarse. Si no se establece este valor, el sistema calcula un valor por omisión adecuado.
- osgi.clean
- si se establece en "true", cualquier dato almacenado en la
antememoria por la infraestructura OSGi y la ejecución de Eclipse se borrará. Esta acción borrará las antememorias utilizadas para almacenar datos del
registro de extensiones de eclipse y de resolución de dependencias de paquetes. Si
utiliza esta opción, obligará a Eclipse a volver a inicializar estas
antememorias.
- osgi.configuration.cascaded
- si se establece en "true", esta configuración se establece en cascada a una configuración padre. osgi.sharedConfiguration.area
especifica la configuración padre. Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.configuration.area {-configuration}
- ubicación de configuración de esta ejecución de la plataforma. La configuración determina qué conectores se ejecutarán y diversos valores del sistema.
Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.configuration.area.default
- configuración por omisión de esta ejecución de la plataforma. La configuración determina qué conectores se ejecutarán y diversos valores del sistema.
Este valor (es decir, el valor por omisión) sólo se utiliza si no se establece ningún valor para osgi.configuration.area. Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.console {-console}
- si se establece en un valor no nulo, la consola OSGi (si está instalada) estará habilitada.
Si el valor es un entero adecuado, se interpreta como el puerto en el que la consola está a la escucha y dirige su salida al puerto determinado.
De utilidad para investigar el estado del sistema.
- osgi.console.class
- nombre de clase de la consola que debe ejecutarse si se solicita
- osgi.debug {-debug}
- si se establece en un valor no nulo, la plataforma se colocará en modalidad de depuración. Si el valor es una serie, se interpreta como la ubicación del archivo .options. Este
archivo indica los puntos de depuración disponibles para un conector y si están
habilitados o no. Si no se especifica una ubicación, la plataforma busca el archivo .options
bajo el directorio de instalación.
- osgi.dev {-dev}
- si se establece en la serie vacía, simplemente se activa la modalidad dev. Esta propiedad también puede establecerse en forma de entradas de vía de acceso de clases separadas por comas, que se añaden a la vía de acceso de clases de cada conector o en un URL a un archivo de propiedades Java que contiene adiciones de vía de acceso de clases personalizadas para un conjunto de conectores. Para cada conector que requiera una vía de acceso de clases de tiempo dev personalizada, el archivo contendrá una entrada en el formato
<ID conector>=<lista separada por comas de entradas de vía de acceso de clases a añadir>
donde ID de conector "*" coincide con cualquier conector si no se indica lo contrario.
- osgi.framework
- ubicación del URL de la infraestructura OSGi. De utilidad si la instalación de Eclipse está desunida. Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.frameworkClassPath
- lista separada por comas de entradas de vía de acceso de clases de la implementación de la infraestructura OSGi.
Las ubicaciones relativas se interpretan como relativas a la ubicación de la infraestructura (consulte osgi.framework)
- osgi.framework.extensions
- una lista separada por comas de extensiones de infraestructura. Cada entrada tiene el siguiente formato:
<URL | ubicación de paquete simple>
Si se especifica una ubicación de paquete simple (no es un URL), se
efectúa una búsqueda en el directorio padre del paquete org.eclipse.osgi.
Pueden utilizarse extensiones de infraestructura para ejecutar Eclipse con un
adaptador de infraestructura diferente.
La extensión de infraestructura puede contener un archivo eclipse.properties
para establecer propiedades del sistema.
Por ejemplo, una extensión de infraestructura que proporciona una
implementación de adaptador de infraestructura puede especificar qué es la
clase de adaptador estableciendo la propiedad
osgi.adaptor.
- osgi.framework.shape
- se establece en forma de implementación de Eclipse OSGi Framework.
Esta propiedad se establece cuando se inicia la plataforma Eclipse y no se ha
previsto que el usuario la establezca.
El valor
"jar" indica que Eclipse OSGi Framework está contenido en un solo
archivo jar.
El valor "folder" indica que Eclipse OSGi Framework está contenido
en un directorio.
- osgi.java.profile
- URL al archivo de perfil JRE que debe utilizarse. Un perfil JRE contiene
valores para las propiedades org.osgi.framework.system.packages y org.osgi.framework.bootdelegation.
Si no se establece osgi.java.profile, se selecciona un perfil basado en el
valor de java.specification.version del JRE en ejecución.
- osgi.java.profile.bootdelegation
-
un perfil Java osgi.java.profile puede contener
una propiedad
"org.osgi.framework.bootdelegation". Este valor puede utilizarse
para establecer la propiedad del sistema "org.osgi.framework.bootdelegation".
osgi.java.profile.bootdelegation indica la política que bootdelegation debe
utilizar.
Los valores siguientes son válidos (el valor por omisión es ignore):
- ignore:
indica que el valor "org.osgi.framework.bootdelegation" del perfil
Java debe pasarse por alto.
La propiedad del sistema "org.osgi.framework.bootdelegation"
se utilizará para determinar qué paquetes deben delegarse para arrancar.
- override:
indica que "org.osgi.framework.bootdelegation" del perfil Java
debe alterar temporalmente la propiedad del sistema "org.osgi.framework.bootdelegation".
- none:
indica que "org.osgi.framework.bootdelegation" del perfil JAVA Y las
propiedades del sistema deben pasarse por alto.
Es la opción más estricta.
La ejecución de esta opción hace que la infraestructura utilice el modelo de
delegación de arranque estricto de OSGi R4.
- osgi.install.area {-install}
- ubicación de instalación de la plataforma. Este valor indica la ubicación de los conectores básicos de Eclipse y resulta de utilidad si la instalación de Eclipse está desunida.
Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.instance.area {-data}
- ubicación de los datos de instancia de esta sesión. Los conectores utilizan esta ubicación para almacenar sus datos. Por ejemplo, el conector de recursos la utiliza como ubicación por omisión para los proyectos (aka el área de trabajo). Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.instance.area.default
- ubicación de los datos de instancia por omisión de esta sesión. Los conectores utilizan esta ubicación para almacenar sus datos. Por ejemplo, el conector de recursos la utiliza como ubicación por omisión para los proyectos (aka el área de trabajo). Este valor (es decir, el valor por omisión) sólo se utiliza si no se establece ningún valor para osgi.instance.area. Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.locking
- tipo de bloqueo que debe utilizarse para esta ejecución de la plataforma. Los
tipos de bloqueo válidos son "java.io", "java.nio" y "none".
El valor por omisión es
"java.nio" a menos que JRE no dé soporte a "java.nio";
en tal caso, el valor por omisión es "java.io".
- osgi.manifest.cache
- ubicación donde se descubren y generan los manifiestos generados. El valor por omisión se encuentra es en el área de configuración, pero la antememoria de manifiesto puede almacenarse por separado.
- osgi.nl {-nl}
- nombre del entorno local en el que se ejecuta la
plataforma Eclipse. Los valores de NL deben seguir los convenios de denominación estándar de entornos locales Java.
- osgi.noShutdown {-noExit}
- si el valor es "true", no se saldrá de VM después de finalizar
la aplicación Eclipse.
Esto resulta útil para examinar la infraestructura OSGi después de haber
finalizado la aplicación Eclipse.
- osgi.os {-os}
- valor de sistema operativo. El valor debe ser uno de los nombres de arquitecturas de procesador Eclipse conocidos en Eclipse (por ejemplo, x86, sparc, ...).
- osgi.parentClassLoader
- tipo de cargador de clase que debe utilizarse como cargador de
clase padre para todos
los paquetes instalados en Framework. Los tipos válidos son los siguientes:
- app: cargador de
clase de aplicación.
- boot: cargador de
clase de arranque.
- ext: cargador de clase
de extensión.
- fwk: cargador de clase
de infraestructura.
- osgi.requiredJavaVersion
- La versión mínima de Java que es necesaria para ejecutar Eclipse. El
valor por omisión es "1.4.1".
- osgi.resolverMode
- modalidad utilizada para solucionar paquetes instalados en Framework. El
valor "strict" pone el solucionador en modalidad estricta. La
modalidad de solucionador por omisión no es estricta.
Cuando el solucionador está en modalidad estricta, Framework aplicará reglas de
restricción de acceso al cargar clases y recursos de paquetes exportados que
especifiquen las directivas x-internal o x-friends.
- osgi.sharedConfiguration.area
- ubicación de configuración compartida de esta ejecución de la plataforma. Si
la propiedad
osgi.configuration.cascaded se
establece en "true", el área de configuración compartida se utiliza
como configuración padre.
- osgi.splashLocation
- ubicación del URL absoluto de la pantalla de inicio (archivo .bmp) que debe aparecer al iniciar Eclipse. Esta propiedad altera temporalmente cualquier valor establecido en osgi.splashPath.
- osgi.splashPath
- lista separada por comas de los URL en los que buscar un archivo denominado splash.bmp.
Esta propiedad queda alterada temporalmente por cualquier valor establecido en osgi.splashLocation.
- osgi.syspath
- se establece en la vía de acceso donde está ubicada la implementación de
Eclipse OSGi Framework (org.eclipse.osgi).
Por ejemplo, "<eclipse install path>/eclipse/plugins".
Esta propiedad se establece cuando se inicia la plataforma Eclipse y no se ha
previsto que el usuario la establezca.
- osgi.user.area {-user}
- ubicación del área de usuario. El área de usuario contiene datos (por ejemplo, preferencias) específicos del usuario de OS e independientes de cualquier instalación, configuración o instancia de Eclipse. Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.user.area.default
- ubicación por omisión del área de usuario. El área de usuario contiene datos (por ejemplo, preferencias) específicos del usuario de OS e independientes de cualquier instalación, configuración o instancia de Eclipse. Este valor (es decir, el valor por omisión) sólo se utiliza si no se establece ningún valor para osgi.user.area. Consulte la sección relativa a ubicaciones para obtener más detalles.
- osgi.ws {-ws}
- valor de sistema de ventanas. El valor debe ser uno de los nombres de sistema de ventanas en Eclipse (por ejemplo, win32, motif, ...).
Ubicaciones
El entorno de ejecución de Eclipse define una serie de ubicaciones que ofrecen a los desarrolladores de conectores un contexto para leer/almacenar datos, y a los usuarios de Eclipse un control sobre el ámbito del compartimiento y visibilidad de los datos. Eclipse define los siguientes tipos de ubicación:
- Usuario (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir,
filepath, url]
- Las ubicaciones de usuario son específicas de los usuarios. Generalmente, la
ubicación de usuario se basa en el valor de la propiedad del sistema
user.home
, pero puede alterarse temporalmente. En la ubicación de usuario puede encontrarse información como, por ejemplo, las preferencias de un ámbito indicado por el usuario e información de inicio de sesión.
- Instalación (-install) {osgi.install.area} [@user.home, @user.dir, filepath,
url]
- Una ubicación de instalación es aquella en la que está instalado el propio Eclipse. En la práctica, esta ubicación es el directorio (generalmente "eclipse") padre del archivo startup.jar o eclipse.exe que se ejecuta. Los usuarios normales deben considerar esta ubicación como de sólo lectura, ya que una instalación puede compartirse entre muchos usuarios. Es posible establecer la ubicación de instalación y separar startup.jar del resto de Eclipse.
- Configuración (-configuration) {osgi.configuration.area} [@none, @noDefault,
@user.home, @user.dir, filepath, url]
- Las ubicaciones de configuración contienen archivos que identifican y gestionan el (sub)conjunto de una instalación que debe ejecutarse. Por ello, puede haber muchas configuraciones por cada instalación.
Las instalaciones pueden suministrarse con un área de configuración por omisión, pero los escenarios de inicio típicos implican que el entorno de ejecución intente encontrar una ubicación de configuración más grabable.
- Instancia (-data) {osgi.instance.area} [@none, @noDefault, @user.home,
@user.dir, filepath, url]
- Las ubicaciones de instancia contienen artefactos de datos definidos por usuario. Por ejemplo, el conector de recursos utiliza el área de instancia como ubicación de área de trabajo y, por tanto, como directorio inicial por omisión para los proyectos. Otros conectores pueden grabar los archivos que deseen en esta ubicación.
Aunque los usuarios pueden establecer cualquiera de estas ubicaciones, Eclipse calculará valores por omisión adecuados si no se suministran valores. El caso más común para establecer la ubicación es el área de instancia o, en el contexto del IDE, el área de trabajo. Para ejecutar la configuración de Eclipse por omisión en un conjunto de datos específico, puede especificar:
eclipse -data c:\misdatos
Más detalles
Las ubicaciones son unos URL. A efectos de simplicidad, también se aceptan vías de acceso de archivo, que se convierten automáticamente a archivo: URLs. A efectos de control y conveniencia, existen también diversas ubicaciones simbólicas predefinidas. Tenga en cuenta que no todas las combinaciones de tipo de ubicación y valor simbólico son válidas. la tabla que figura más adelante detalla las combinaciones posibles. Puesto que el caso por omisión es para todas las ubicaciones que deben establecerse, válidas y grabables, algunos conectores pueden fallar en otras configuraciones de conector aunque se indiquen como posibles. Por ejemplo, no tiene sentido esperar que un conector centrado en datos de usuario (por ejemplo, el conector de recursos de Eclipse) realice mucho trabajo si el área de instancia no está definida. Es responsabilidad de los desarrolladores de conectores elegir las configuraciones a las que darán soporte y diseñar sus funciones de acuerdo con ellas.
- @none
- Indica que la ubicación correspondiente nunca debe establecerse, ya sea explícitamente o en su valor por omisión. Por ejemplo, una aplicación de tipo RCP que no tenga datos de usuario puede utilizar osgi.instance.area=@none para evitar que archivos extraños se graben en disco. @none no debe ir seguido de ningún fragmento de vía de acceso adicional.
- @noDefault
- Obliga a que una ubicación no esté definida o lo esté explícitamente (es decir, Eclipse no calculará automáticamente un valor por omisión). Esto resulta de utilidad si desea permitir datos en la ubicación correspondiente, pero el valor por omisión de Eclipse no es adecuado. @noDefault no debe ir seguido de ningún fragmento de vía de acceso adicional.
- @user.home
- Indica a Eclipse que debe calcular un valor de ubicación relativo al directorio inicial de Eclipse. @user.home puede ir seguido de segmentos de vía de acceso adicionales. En todos los casos, la serie "@user.home" se sustituye simplemente por el valor de la propiedad del sistema Java "user.home". Por ejemplo, si se establece
osgi.instance.area=@user.home/myWorkspace
se obtendrá el valor
file:/users/bob/myWorkspace
- @user.dir
- Indica a Eclipse que debe calcular un valor de ubicación relativo al directorio de trabajo actual. @user.dir puede ir seguido de segmentos de vía de acceso adicionales. En todos los casos, la serie "@user.dir" se sustituye simplemente por el valor de la propiedad del sistema Java "user.dir". Por ejemplo, si se establece
osgi.instance.area=@user.dir/myWorkspace
se obtendrá el valor
file:/usr/share/eclipse/myWorkspace
ubicación/valor |
soporta valor por omisión |
archivo/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
instancia
|
sí |
sí
|
sí
|
sí
|
sí
|
sí (valor por omisión)
|
configuración
|
sí
|
sí
|
sí*
|
sí*
|
sí
|
sí
|
instalación
|
no
|
sí
|
no
|
no
|
sí
|
sí
|
usuario
|
sí
|
sí
|
sí
|
sí
|
sí
|
sí
|
* indica que esta configuración es técnicamente posible, pero en la práctica es difícil de gestionar. En concreto, sin una ubicación de configuración, el entorno de ejecución de Eclipse sólo puede llegar como máximo a iniciar la infraestructura de OSGi.
Ubicaciones de sólo lectura
Puede especificarse una ubicación como de sólo lectura añadiendo
".readOnly"
a la propiedad de ubicación y establecerla en el valor "true". Las
siguientes propiedades pueden utilizarse para especificar sus ubicaciones
correspondientes como de sólo lectura:
Archivo ini de iniciador
eclipse.exe y ejecutables más generales de aplicaciones RCP leen sus parámetros
desde un archivo ini asociado. Este archivo ofrece un método independiente de
la plataforma para pasar argumentos que anteriormente tuvieron que especificarse
directamente en la línea de mandatos como, por ejemplo, vm o argumentos vm.
Aunque pueden especificarse todos los parámetros en este archivo, por razones
de mantenibilidad y coherencia entre diversas instalaciones, se recomienda que
sólo especifique la ubicación de vm y los argumentos vm en este archivo ini y
que utilice el archivo config.ini para los demás.
Formato de archivo
Este archivo debe denominarse según el nombre del ejecutable (por ejemplo,
eclipse.exe leerá eclipse.ini, mientras que launcher.exe leerá
launcher.ini) y cada parámetro debe especificarse en una línea nueva del
archivo.
Éste es un ejemplo de un archivo así, que especifica la ubicación de vm y
algunos parámetros:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M