Opciones de compilación y opciones de ejecución

Como un programa de realización de esquemas eléctricos, QElectroTech necesita un número de componentes eléctricos para el uso en los esquemas. Estos elementos se dividen en dos categorías: la colección común, y la coleccion de usuario que siempre con QElectroTech puede ser ampliada y / o modificados para adaptarse a las necesidades de una empresa por ejemplo la colección del usuario, que incluye elementos específicos para el usuario.

Excepto opción contraria, esta última categoría se sitúa en el expediente personal (« home ») del usuario, o sea C:\Documents and Settings\login_usuario\ bajo Windows y ~login_usuario (generalmente /home/login_usuario) bajo Unix.

En cuanto a la colección común, esto plantea el problema de su localización. En efecto, para seguir siendo flexible, QElectroTech no incluye esta colección en el binario ejecutable (lo que requeriría una recompilación y redistribución de QElectroTech al cargar un elemento en esta colección). Se almacena en algún lugar de los sistemas de archivos disponibles en el sistema. Por defecto, QElectroTech busca estos elementos en la carpeta “elements”, justo al lado del binario ejecutable. Esta solución probablemente no es apropiada a los empaquetadores y administradores. Por lo tanto QElectroTech incluye opciones para establecer la ruta.

Para definir una opción de compilación es necesario editar el fichero qelectrotech.pro situado en las fuentes de QElectroTech. Al final de este fichero se sitúa en las líneas DEFINES += que permite definir las opciones de compilación. El simbolo numeral (#) al principio de línea indica que se comenta la línea.

# définit l'option QET_LANG_PATH avec la valeur /path/to/qelectrotech/lang/
DEFINES += QET_LANG_PATH='/path/to/qelectrotech/lang/'

Al definir las rutas es así, asegúrese de:

• No se olvide del / o la \al final la ruta de acceso en el caso de una carpeta
• No olvide el principio y final de la cadena, si la ruta contiene espacios.
• Si usted hace varias pruebas del Makefile y no puede ver nada volver a recompilar, quitar debug/qetapp.o o release/qetapp.o.

En realidad, no. Aunque es útil para cambiar estas opciones, que estarán ubicadas en el principio del archivo. Por defecto, que se generan a partir de las variables definidas en el principio del archivo qelectrotech.pro.

Aquí está el archivo de configuración por defecto qelectrotech.pro

######################################################################
#                  Fichero de proyecto QElectroTech                   #
######################################################################
# Rutas utilizadas para compilar e instalar QET
COMPIL_PREFIX              = '/usr/local/'
INSTALL_PREFIX             = '/usr/local/'
QET_BINARY_PATH            = 'bin/'
QET_COMMON_COLLECTION_PATH = 'share/qelectrotech/elements/'
QET_LANG_PATH              = 'share/qelectrotech/lang/'
QET_LICENSE_PATH           = 'doc/qelectrotech/'
QET_MIME_XML_PATH          = '../share/mime/application/'
QET_MIME_DESKTOP_PATH      = '../share/mimelnk/application/'
QET_DESKTOP_PATH           = 'share/applications/'
QET_ICONS_PATH             = 'share/icons/'
# Comentar la línea a continuación para deshabilitar la opción de --common-elements-dir
DEFINES += QET_ALLOW_OVERRIDE_CED_OPTION
# Comentar la línea a continuación para deshabilitar la opción de --config-dir
DEFINES += QET_ALLOW_OVERRIDE_CD_OPTION
######################################################################

La instalación implica copiar cuatro grupos de archivos:

• los binarios ejecutables de QElectroTech ( = el propio programa) nombre qelectrotech bajo Unix y qelectrotech.exe bajo Windows.
• el archivo de licencia que se describe la licencia bajo la que se publica QElectroTech
• los elementos que constituyen la colección común de QElectrotech
• los archivos de idioma

En estos archivos se agregan los archivos específicos de los sistemas Unix / X11 / FreeDesktop

• Los archivos XML que describen los tipos de archivo de la aplicación (Unix solamente)
• Los archivos de escritorio que describen los tipos de archivo de la aplicación (Unix solamente)
• El fichero que corresponde al acceso directo del escritorio a la aplicación (Unix solamente)
• La ruta de los iconos de aplicación para el sistema (Unix solamente)

si el usuario instala QElectroTech únicamente en su máquina, es posible que desee modificar las rutas de instalación.

En cambio, si desea crear un paquete para sistemas Unix, tendrá seguramente que personalizarlos. A menudo, cuando la creación de un paquete, el árbol de paquete es idéntica a una parte del árbol del sistema, la diferencia es el principio de la ruta de acceso, llamada prefijo. COMPIL_PREFIX será el prefijo de las rutas lista difícil de compilar en un archivo ejecutable (los archivos de idioma y los elementos). INSTALL_PREFIX será el prefijo que se utiliza cuando se instala (`make install`). Tipicamente, INSTALL_PREFIX valdrá ~/su/directorio/de/trabajo/ mientras que COMPIL_PREFIX valdra /usr/. En estos prefijos se concatenan las variables internas siguientes:

• QET_BINARY_PATH, ruta binaria, válida sólo para la instalación
• QET_LICENSE_PATH, ruta de la licencia, valida para la instalación solamente
• QET_COMMON_COLLECTION_PATH, ruta de la colección de elementos
• QET_LANG_PATH, ruta de los ficheros de lenguaje

Esta opción de ejecución permite redefinir la ruta de la colección común, al lanzamiento de QElectroTech y la preferencia sobre la ruta compilado en duro. Esto permite cambiar fácilmente la ubicación de la colección común. En contra parte, el usuario puede configurar el programa para acceder a cualquier colección.

Esta opción de ejecución permite de redefinir la ruta del archivo de configuración al lanzamiento de QElectroTech y la preferencia sobre la ruta compilado en duro. Esto permite cambiar fácilmente la ubicación del archivo de configuración y de la colección personal, muy conveniente para una versión listo para usar integrable en una llave USB.

Esta opción de ejecución permite de redefinir la ruta de los archivos de idioma de QElectroTech.

Esta opción, si se define, QElectroTech compilado con soporte para la opción de ejecutar --common-elements-dir= Basta con comentar la línea DEFINES += QET_ALLOW_OVERRIDE_CED_OPTION para deshabilitar la capacidad de utilizar --common-elements-dir=

Esta opción si se define, QElectroTech compilado con soporte para la opción de ejecutar --config-dir= Simplemente comentar la línea DEFINES += QET_ALLOW_OVERRIDE_CD_OPTION para desactivar la posibilidad de utilizar --config-dir=

QElectroTech se desarrolla con el kit de herramientas Qt. En tanto que la aplicación Qt, hereda algunos comportamientos, cuya sensibilidad a las opciones y variables de entorno son bien definidas.

Esta opción le permite elegir el estilo utilizado por el programa. Ejemplos:

# lance QET avec le style plastique (KDE-like)
qelectrotech.exe -style plastique
# lance QET avec le style cleanlooks (Gnome-like)
qelectrotech.exe -style cleanlooks
# lance QET avec le style windowsxp (Windows-like)
./qelectrotech -style windowsxp

Los estilos disponibles son:

• mac (MacOS seulement)
• windowsvista (Windows Vista seulement)
• windowsxp (Windows XP seulement)
• windows
• plastique
• cleanlooks
• cde
• motif

Esta es una variable de entorno que, si vale 1 o más, fuerza Qt para rellenar áreas de color verde / amarillo / de naranja antes de sacar los componentes de la aplicación. Esta opción se utiliza normalmente para controlar el proceso de dibujo de la aplicación, pero es suficientemente divirtiendo para figurar en esta documentación ;).

  # versions UNIX
  # variante 1 : pour un lancement seulement
  QT_FLUSH_PAINT=1 ./qelectrotech
  # variante 2 : pour les lancements à venir dans le shell courant
  export QT_FLUSH_PAINT=1
  ./qelectrotech
  # variante 3 : toujours :D
  echo 'export QT_FLUSH_PAINT=1' >> ~/.bashrc
  . ~/.bashrc
  ./qelectrotech
  # version Windows
  set QT_FLUSH_PAINT=1
  qelectrotech.exe

Nota: En Windows, es necesario haber compilado una version debug de QElectroTech.

La lista completa y explicación detallada de las opciones de Qt se puede encontrar en la documentation Trolltech (anglais).

Los otros argumentos se abrirán:

• Sólo si es que existen;
• en tanto que el nombre de los ficheros y los elementos termine en .elmt;
• en tanto que los ficheros sean esquemas;