Avanzadas¶
Los usuarios avanzados pueden estar interesados en la configuración de las siguientes opciones, que en la mayoría de los casos se derivan automáticamente de las opciones de CMake no avanzadas enumeradas anteriormente. Para ver estas opciones en la interfaz gráfica de usuario de CMake, presione la tecla t
enccmake
(Unix) o marque la casilla Show Advanced Values
(Windows).
-DBASIS_ALL_DOC
:BOOL
¶
Solicitar la compilación de todos los destinos de documentación como parte del ALL
targetif BUILD_DOCUMENTATION
es ON
.
-DBASIS_COMPILE_SCRIPTS
:BOOL
¶
Habilite la compilación de módulos Python. Si esta opción está habilitada, solo se instalarán los archivos .pyc
compilados.
-DBASIS_COMPILE_MATLAB
:BOOL
¶
Si compilar fuentes de MATLAB utilizando el compilador de MATLAB (mcc), si está disponible.Si se establece en OFF
, los archivos de origen de MATLAB se copian como parte de la instalación y un script Bash para la ejecución de matlab
con la opción -c
se genera en Unix o un script de comandos de Windows NT en Windows, respectivamente. Esto permite la ejecución conveniente del ejecutable implementado en MATLAB incluso sin tener licencia para el compilador de MATLAB. Sin embargo, cada instancia del ejecutable construido tendrá una licencia MATLAB. Además, el inicio del ejecutable es más largo cada vez, no solo la primera vez que se inicia, como es el caso de la compilación mcc executables.It por lo tanto, se recomienda habilitar esta opción y obtener una licencia de compilación de MATLAB si es posible. De forma predeterminada, esta opción es ON
.
-DBASIS_DEBUG
:BOOL
¶
Habilite los mensajes de depuración durante la configuración de compilación.
-DBASIS_INSTALL_APIDOC_DIR
:PATH
¶
Directorio de instalación de la documentación de la API relativa al prefijo de instalación.
-DBASIS_INSTALL_RPATH
:BOOL
¶
Si se debe hacer que BASIS establezca la propiedad INSTALL_RPATH apropiada de ejecutables y bibliotecas compartidas en lugar de CMake. Esta opción es ON
de forma predeterminada, que cumple con el estándar BÁSICO. Tenga en cuenta que esta opción puede ser modificada por el desarrollador del proyecto o en la línea de comandos configurando variableCMAKE_SKIP_RPATH en FALSE. Esto se hace tipográficamente en la configuración / Configuración.cmake.
-DBASIS_INSTALL_SCHEME
:STRING
¶
Esquema de instalación, es decir, jerarquía del sistema de archivos, a utilizar para la instalación de los archivos de software relativos al prefijo de instalación especificado por -DCMAKE_INSTALL_PREFIX
.Los valores válidos son default
, usr
, opt
, o win
. Consulte Árboles de instalación definidos por el Diseño de BASE del Sistema de archivos para obtener más detalles.
-DBASIS_INSTALL_SITE_DIR
:PATH
¶
Directorio de instalación del sitio web relativo al prefijo de instalación.
-DBASIS_INSTALL_SITE_PACKAGES
:BOOL
¶
Si instalar bibliotecas de módulos públicas escritas en un lenguaje de scripting como asPython o Perl en las ubicaciones predeterminadas de todo el sistema para los paquetes del sitio. Esta opción está desactivada de forma predeterminada, ya que, de lo contrario, se requieren permisos de escritura para estos directorios.
-DBASIS_MCC_FLAGS
:STRING
¶
Indicadores adicionales para el compilador MATLAB separados por espacios.
-DBASIS_MCC_MATLAB_MODE
:BOOL
¶
Si llamar al compilador MATLAB en modo MATLAB. Si ON
, el Compilador de MATLAB se llama desde una sesión de intérprete de MATLAB, lo que da lugar a la liberación inmediata de la licencia del compilador de MATLAB una vez que se realiza la compilación.De lo contrario, la licencia se reserva por un período de tiempo determinado (por ejemplo, 30 minutos).
-DBASIS_MCC_RETRY_ATTEMPTS
:INT
¶
Número de veces que se repite la compilación de destino del compilador MATLAB en caso de un error de comprobación de licencias.
-DBASIS_MCC_RETRY_DELAY
:INT
¶
Retardo en número de segundos entre reintentos para compilar destinos de compilador MATLAB después de que se haya producido un error de comprobación de alicense.
-DBASIS_MCC_TIMEOUT
:INT
¶
Tiempo de espera en segundos para la compilación de un destino de compilador MATLAB. Si la compilación del objetivo no se pudo terminar en el tiempo especificado, la compilación se interrumpe.
-DBASIS_MEX_FLAGS
:STRING
¶
Banderas adicionales para el script MEX separadas por espacios.
-DBASIS_MEX_TIMEOUT
:INT
¶
Tiempo de espera en segundos para la compilación de archivos MEX.
-DBASIS_REGISTER
:BOOL
¶
Si registrar el paquete instalado en el registro de paquetes de CMake. Esta opción está habilitada de forma predeterminada, de modo que CMake encuentra los paquetes cuando lo requieren otros paquetes basados en esta herramienta de compilación.
-DBASIS_SUPERBUILD_MODULES
:BOOL
¶
Experimental Habilitar el superbuild de módulos de proyecto. Para proyectos con un gran número de módulos, esto puede reducir drásticamente el tiempo de configuración del sistema de compilación, ya que la configuración de cada módulo se pospone hasta el paso de compilación.El superbuild de módulos está deshabilitado de forma predeterminada.Consulte Superbuild de Módulos para obtener más información.
-DBASIS_VERBOSE
:BOOL
¶
Habilite mensajes detallados durante la configuración de compilación.
-DBUILD_BASIS_UTILITIES_FOR_
<LANG>:BOOL
¶
De forma predeterminada, las Utilidades BÁSICAS para un lenguaje de programación dado solo se compilan si alguno de los ejecutables o destinos de biblioteca del proyecto se construye a partir del código fuente en el lenguaje correspondiente y hace uso de estas utilidades. Utilice estas opciones para forzar la compilación de las Utilidades BÁSICAS para el idioma respectivo. Incluso si el proyecto en sí no lo utiliza, las funciones de utilidad generadas y los archivos de encabezado o módulo con scripts pueden ser utilizados por otro proyecto para acceder a los metadatos del proyecto, como su nombre y versión, incluyendo las respectivas Utilidades BÁSICAS específicas del proyecto.
-DBUILD_CHANGELOG
:BOOL
¶
Solicitar la compilación de registro de cambios como parte del objetivo ALL
. Tenga en cuenta que el registro de cambios se genera desde el historial de Subversion si el árbol de fuentes es una copia SVNworking, o desde el historial de Git si es un repositorio Git. De lo contrario, el registro de cambios no se puede generar y esta opción se deshabilita de nuevo por BASIS.In en el caso de Subversion, tenga en cuenta que la generación del registro de cambios toma varios minutos y puede requerir la entrada de credenciales de usuario para acceder al repositorio de versiones. Se recomienda dejar esta opción desactivada y crear el objetivo changelog
separado del resto del paquete de software en lugar de crear el software (consulte Compilar el software).
-DBUILD_MODULES_BY_DEFAULT
::BOOL
¶
Si habilitar módulos de proyecto (es decir, subproyectos) de forma predeterminada o no. Esta opción solo tiene efecto cuando se da directamente en la línea de comandos al llamar a cmake
occmake
, respectivamente. De lo contrario, el valor predeterminado de esta opción se utilizará para la primera ejecución de configuración del sistema de compilación, que agrega las opciones MODULE_*
ya y las establece en el valor predeterminado respectivo (TRUE
). Este valor predeterminado no se puede sobrescribir con ejecuciones de configuración consecutivas a menos que se cambien las propias opciones MODULE_*
.
-DITK_DIR
:PATH