Avançado¶
usuários Avançados poderão, ainda, ser interessado nas definições dos seguintes optionswhich na maioria dos casos são automaticamente derivada da não-avançados, o CMake optionssummarized acima. Para ver estas opções na interface do CMake, carregue na tecla t
em ccmake
(Unix) ou assinale a opção Show Advanced Values
(Windows).
-DBASIS_ALL_DOC
:BOOL
¶
solicitar a construção de todos os objectivos de documentação como parte do ALL
targetif BUILD_DOCUMENTATION
é ON
.
-DBASIS_COMPILE_SCRIPTS
:BOOL
¶
activar a compilação dos módulos Python. Se esta opção estiver activa, só estão instalados os ficheiros .pyc
completados.
-DBASIS_COMPILE_MATLAB
:BOOL
¶
se deve compilar fontes de MATLAB usando o compilador de MATLAB (mcc), se disponível.Se configurado para OFF
, os arquivos de código MATLAB são copiados como parte da instalação andda Bash script para a execução de matlab
com a opção -c
é generatedon Unix ou um script de comando Windows NT no Windows, respectivamente. Isto permite a execução do executável implementado em MATLAB mesmo sem ter alicense para o compilador MATLAB. Cada instância do executável construído irá assumir uma licença MATLAB, no entanto. Além disso, o arranque do executável é cada vez mais longo, não só a primeira vez que é lançado, como é o caso da mcc compilada executables.It recomenda-se, portanto, que se active esta opção e se obtenha um MATLAB Compilerlicense, se possível. Por padrão, esta opção é ON
.
-DBASIS_DEBUG
:BOOL
¶
activar as mensagens de depuração durante a configuração da compilação.
-DBASIS_INSTALL_APIDOC_DIR
:PATH
¶
pasta de instalação da documentação da API relativa ao prefixo da instalação.
-DBASIS_INSTALL_RPATH
:BOOL
¶
se o BASIS deve definir a propriedade INSTALL_ rpath apropriada dos executáveis e bibliotecas partilhadas em vez do CMake. Esta opção é ON
por defeito, o que corresponde à norma de base. Lembre-se que esta opção pode ser substituída pelo programador do projecto ou pela linha de comandos, configurando o variablecmake_ skip_ rpath como FALSE. Isto é feito à máquina na configuração/configuração.cmake.
-DBASIS_INSTALL_SCHEME
:STRING
¶
esquema de instalação, ou seja, hierarquia do sistema de arquivos, para usar para a instalação dos arquivos de software em relação ao prefixo de instalação especificado pelo -DCMAKE_INSTALL_PREFIX
.Os valores válidos são:default
, usr
, opt
, ou win
. Veja o Treeas de instalação definido pela disposição do sistema de arquivos da base para mais detalhes.
-DBASIS_INSTALL_SITE_DIR
:PATH
¶
diretório de instalação do site em relação ao prefixo de instalação.
-DBASIS_INSTALL_SITE_PACKAGES
:BOOL
¶
se deve instalar bibliotecas de módulos públicos escritas em uma linguagem de script como asPython ou Perl nos locais padrão de todo o sistema para pacotes de sites. Esta opção é desactivada por omissão, dado que as permissões de escrita para estas pastas são necessárias caso contrário.
-DBASIS_MCC_FLAGS
:STRING
¶
opções adicionais para o compilador MATLAB separadas por espaços.
-DBASIS_MCC_MATLAB_MODE
:BOOL
¶
se deve chamar o compilador MATLAB no modo MATLAB. If ON
, the MATLAB Compileris called from within a MATLAB interpreter session, which results in the immediate release of the MATLAB Compiler license once the compilation is done.Caso contrário, a licença é reservada por um tempo fixo (por exemplo, 30 minutos).
-DBASIS_MCC_RETRY_ATTEMPTS
:INT
¶
número de vezes que a compilação do alvo do compilador MATLAB é repetida em caso de um erro de saída da licença.
-DBASIS_MCC_RETRY_DELAY
:INT
¶
atraso no número de segundos entre as tentativas para construir os alvos do compilador MATLAB após o erro de verificação do alicense ter ocorrido.
-DBASIS_MCC_TIMEOUT
:INT
¶
tempo-limite em segundos para a compilação de um alvo de compilador MATLAB. Se a compilação do alvo não pôde ser terminada dentro do tempo especificado, a compilação está interrompida.
-DBASIS_MEX_FLAGS
:STRING
¶
opções adicionais para o programa MEX separadas por espaços.
-DBASIS_MEX_TIMEOUT
:INT
¶
tempo-limite em segundos para a compilação de ficheiros MEX.
-DBASIS_REGISTER
:BOOL
¶
se deve registar o pacote instalado no registo de pacotes do CMake. Esta opção está activa por omissão, de modo a que os pacotes sejam encontrados pelo CMake quando são necessários por outras pastas com base nesta ferramenta de compilação.
-DBASIS_SUPERBUILD_MODULES
:BOOL
¶
Experimental activar a supercompensa dos módulos do projecto. Para projetos com um grande número de módulos, isso pode reduzir drasticamente o tempo de configuração do sistema de construção, porque a configuração de cada módulo é adiada até o passo de construção.A supercompensa de módulos é desativada por padrão.Veja a Supercompensa de módulos para mais informações.
-DBASIS_VERBOSE
:BOOL
¶
activar as mensagens descritivas durante a configuração da compilação.
-DBUILD_BASIS_UTILITIES_FOR_
<LANG>:BOOL
¶
por padrão, os utilitários de base para uma determinada linguagem de programação só são construídos se qualquer um dos alvos executáveis do projeto ou biblioteca construir a partir do código fonte na linguagem eficiente faz uso desses utilitários. Use estas opções para forçar a construção dos utilitários de base para o respectivo idioma. Mesmo que não sejam usadas pelo próprio projecto, as funções de utilidade geradas e os módulos de cabeçalho ou scripts podem ser usados por outro projecto para aceder aos meta-dados do projecto, como o seu nome e versão, incluindo os respectivos Utilitários de base específicos do projecto.
-DBUILD_CHANGELOG
:BOOL
¶
Request build of ChangeLog as part of the ALL
target. Note que o ChangeLogis gerado pelo histórico do Subversion se a árvore de código for uma cópia SVNworking, ou do histórico do Git se for um repositório git. Caso contrário, o ChangeLog não pode ser gerado e esta opção é desactivada novamente por BASIS.In caso do Subversion, esteja ciente de que a geração do ChangeLog leva vários minutos e pode exigir a entrada de credenciais de usuário para o acesso ao repositório do Subversion. Recomenda-se deixar esta opção desactivada e construir o alvo changelog
separado do resto do software packageinstead (veja compilar o Software).
-DBUILD_MODULES_BY_DEFAULT
::BOOL
¶
se deve ativar módulos do projeto (ou seja, subprojetos) por padrão ou não. Esta opção só tem efeito quando é dada directamente na linha de comando quando se chama cmake
ouccmake
, respectivamente. Caso contrário, o valor por omissão desta opção será usado para a primeira execução de configuração do sistema de compilação que adiciona já as opções MODULE_*
e configura-as para o respectivo valor por omissão (TRUE
). Este valor default não pode ser substituído por uma configuração consecutiva, a menos que as opções MODULE_*
sejam alteradas.
-DITK_DIR
:PATH