CMake Opções¶

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

Deixe uma resposta

O seu endereço de email não será publicado.