Opções¶
-C <initial-cache>
Pré-carregar um script para preencher o cache.
quando o cmake é executado pela primeira vez numa árvore de compilação vazia, cria aCMakeCache.o ficheiro txt e popula-o com configurações personalizáveis para o projecto. Esta opção pode ser usada para indicar um ficheiro a partir do qual carregar os itens da ‘cache’ antes da primeira passagem pelos ficheiros da ‘scmake’ do projecto. Os itens carregados têm prioridade sobre os valores predefinidos do projecto. O ficheiro indicado deverá ser um comando do CMake que contenha comandos que usem a opção ‘CACHE’, não um ficheiro acache-format.
-D <var>:<type>=<value>
crie uma entrada de cache cmake.
quando o cmake é executado pela primeira vez numa árvore de compilação vazia, cria aCMakeCache.o ficheiro txt e popula-o com configurações personalizáveis para o projecto. Esta opção pode ser utilizada para especificar uma definição que atribui prioridade ao valor por omissão do projecto. A opção pode ser adaptada para quantas entradas de cache desejar.
-U <globbing_expr>
remover as entradas correspondentes da ‘cache’ do CMake.Esta opção pode ser usada para remover uma ou mais variáveis do makecache.txt file, globing expressions using * and ? suportada. A opção pode ser repetida para tantas entradas de cache quantas asdesired.Use com cuidado, pode fazer o seu CMakeCache.não funciona.
-G <generator-name>
especifique um gerador de Sistema de compilação.
CMake pode suportar múltiplos sistemas de construção nativos em determinadas configurações. Um gerador é responsável por gerar um sistema particular de construção. Os nomes dos geradores possíveis estão especificados na secção dos geradores.
-T <toolset-name>
especifique o nome da Conjunto de ferramentas se for suportado pelo gerador.
Alguns geradores CMake suportam um nome de conjunto de ferramentas a ser dado ao sistema de compilação para escolher um compilador. Isto é suportado apenas em geradores específicos:
Visual Studio >= 10Xcode >= 3.0
veja a documentação nativa do sistema de compilação para os nomes das conjuntos de ferramentas permitidos.
-A <platform-name>
especifique o nome da plataforma se for suportado pelo gerador.
Alguns geradores CMake suportam um nome de plataforma a ser dado ao sistema de compilação para escolher um compilador ou SDK. Isto é suportado apenas em geradores específicos:
Visual Studio >= 8
veja a documentação do sistema de compilação nativo para os nomes de plataforma permitidos.
-Wno-dev
suprimir os avisos de desenvolvimento.
suprimir alertas que se destinam ao autor da lista.ficheiros txt.
-Wdev
activar os avisos de desenvolvimento.
activar os avisos que se destinam ao autor das listas de Cmakelistas.txtfiles.
-E
modo de comando CMake.
para a verdadeira independência da plataforma, o CMake fornece uma lista de comandos que podem ser usados em todos os sistemas. Corre com a ajuda da usageinformation. Os comandos disponíveis são:: chdir, compare_fices,copy, copy_directory, copy_if_ different, echo, echo_ append, env,environment, make_directory, md5sum, remove, remove_directory, renome, sleep, tar,time, touch, touch_nocreate. Além disso, alguns comandos específicos da plataforma estão disponíveis. No Windows: delete_regv, write_regv. OnUNIX: create_symlink.
-L
listar variáveis em ‘cache’ não avançadas.
List cache variables will run CMake and list all the variables from the CMake cache that are not marked as INTERNAL or ADVANCED. Isto irá efectivamente mostrar as configurações actuais do CMake,que poderão então ser alteradas com a opção-D. Mudar algumas das variáveis pode resultar na criação de mais variáveis. Se A é especificado, então ele vai mostrar também variáveis avançadas. Se o H for especificado, ele também irá mostrar Ajuda para cada variável.
--build <dir>
construa uma árvore binária gerada pelo CMake.
isto resume a interface de linha de comandos de uma ferramenta de compilação nativa com as seguintes opções:
<dir> = Project binary directory to be built.--target <tgt> = Build <tgt> instead of default targets.--config <cfg> = For multi-configuration tools, choose <cfg>.--clean-first = Build target 'clean' first, then build. (To clean only, use --target 'clean'.)--use-stderr = Ignored. Behavior is default in CMake >= 3.0.-- = Pass remaining options to the native tool.
executar cmake-build sem opções de ajuda rápida.
-N
modo de visualização apenas.
apenas carregar a ‘cache’. Não execute de facto o configure e o generatesteps.
-P <file>
Process script mode.
processa o ficheiro cmake dado como um script escrito no CMakelanguage. Não é realizada nenhuma etapa de configuração ou geração e o cacheis não é modificado. Se as variáveis são definidas usando-D, isto deve ser corrigido antes do argumento-P.
--find-package
execute no modo pkg-config semelhante.
procure um pacote usando o find_ Package () e imprima o flagsto stdout resultante. Isto pode ser usado para usar o cmake em vez do pkg-config para encontrar bibliotecas instaladas em projectos baseados no Makefile ou em projectos baseados no inautoconf (via share/aclocal/cmake.m4).
--graphviz=
gerar graphviz de dependências, ver CMakeGraphVizOptions.cmake para mais.
gerar um ficheiro de entrada de graphviz que irá conter todas as dependências da biblioteca e executáveis do projecto. Ver a documentação para as opções gráficas.cmake para mais detalhes.
--system-information
despeja informação sobre este sistema.
despeja uma vasta gama de informações sobre o sistema actual. Se executado a partir do topo de uma árvore binária para um projeto CMake, ele irá dumpadicional informação, como o cache, arquivos de log, etc.
--debug-trycompile
não remova a árvore de compilação try_ compile. Só é útil num computador de cada vez.
não remova os ficheiros e directórios criados para o try_ compilecalls. Isto é útil na depuração dos ‘try_ compiles’ falhados. Pode, contudo, alterar os resultados dos compilados de tentativa como lixo antigo de uma anterior tentativa-compile pode causar um teste diferente para passar ou falhar incorretamente. Esta opção é melhor usada para uma tentativa-compile de cada vez, e apenas quando a depuração.
--debug-output
coloque o cmake no modo de depuração.
imprime coisas extra durante a execução do cmake, como os traços da pilha com as chamadas send_ error.
--trace
coloque cmake em Modo de traço.
Print a trace of all calls made and from where withmessage (send_error ) calls.
--warn-uninitialized
avisar sobre valores não iniciados.
Print a warning when an uninitialized variable is used.
--warn-unused-vars
avisar sobre variáveis não utilizadas.
encontrar variáveis declaradas ou definidas, mas não utilizadas.
--no-warn-unused-cli
não avise sobre as opções da linha de comandos.
não encontre variáveis declaradas na linha de comandos, mas não utilizadas.
--check-system-vars
encontra problemas com a utilização das variáveis nos ficheiros do sistema.
Normalmente, as variáveis não utilizadas e não inicializadas são procuradas apenas no CMAKE_SOURCE_DIR e no CMAKE_BINARY_DIR. Esta bandeira diz ao CMake towarn sobre outros ficheiros também.
--help,-help,-usage,-h,-H,/?
Print usage information and exit.
a utilização descreve a interface básica da linha de comandos e as suas opções.
--version,-version,/V
mostrar o nome do programa/banner da versão e sair.
se um arquivo é especificado, a versão é escrita nele.A ajuda é impressa em um nome <f >ile se dada.
--help-full
Print all help manuals and exit.
todos os manuais são impressos num formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-manual <man>
imprime um manual de Ajuda e sai.
o manual especificado é impresso num formato de texto legível pelo ser humano.A ajuda é impressa em um nome <f >ile se dada.
--help-manual-list
listar manuais de Ajuda disponíveis e sair.
a lista contém todos os manuais para os quais a ajuda pode ser obtida utilizando a opção --help-manual seguida de um nome manual.A ajuda é impressa em um nome <f >ile se dada.
--help-command <cmd>
Print help for one command and exit.
a cmake-commands(7) entrada manual para <cmd> é impressa num formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-command-list
listar comandos com ajuda disponível e sair.
a lista contém todos os comandos para os quais a ajuda pode ser obtida utilizando a opção --help-command seguida de um nome de comando.A ajuda é impressa em um nome <f >ile se dada.
--help-commands
Print cmake-commands manual and exit.
o manual cmake-commands(7) é impresso em formato de texto legível.A ajuda é impressa em um nome <f >ile se dada.
--help-module <mod>
Print help for one module and exit.
a cmake-modules(7) entrada manual para <mod> está impressa num formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-module-list
listar módulos com ajuda disponível e sair.
a lista contém todos os módulos para os quais a ajuda pode ser obtida utilizando a opção --help-module seguida de um nome de Módulo.A ajuda é impressa em um nome <f >ile se dada.
--help-modules
Print cmake-modules manual and exit.
o manual cmake-modules(7) está impresso num formato de texto readabletexto humano.A ajuda é impressa em um nome <f >ile se dada.
--help-policy <cmp>
Print help for one policy and exit.
a cmake-policies(7) entrada manual para <cmp> é impressa num formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-policy-list
listar políticas com ajuda disponível e sair.
a lista contém todas as políticas para as quais a ajuda pode ser obtida utilizando a opção --help-policy seguida de um nome de política.A ajuda é impressa em um nome <f >ile se dada.
--help-policies
Print cmake-policies manual and exit.
o manual cmake-policies(7) é impresso em formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-property <prop>
Print help for one property and exit.
as cmake-properties(7) entradas manuais para <prop> são impressas num formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-property-list
listar propriedades com ajuda disponível e sair.
a lista contém todas as propriedades para as quais a ajuda pode ser obtida utilizando a opção --help-property seguida de um nome de propriedade.A ajuda é impressa em um nome <f >ile se dada.
--help-properties
Print cmake-properties manual and exit.
o manual cmake-properties(7) está impresso em formato de texto legível.A ajuda é impressa em um nome <f >ile se dada.
--help-variable <var>
Print help for one variable and exit.
a cmake-variables(7) entrada manual para <var> é impressa num formato de texto legível pelo homem.A ajuda é impressa em um nome <f >ile se dada.
--help-variable-list
listar variáveis com ajuda disponível e sair.
a lista contém todas as variáveis para as quais a ajuda pode ser obtida utilizando a opção --help-variable seguida de um nome de variável.A ajuda é impressa em um nome <f >ile se dada.
--help-variables
Print cmake-variables manual and exit.
o manual cmake-variables(7) está impresso em formato de texto legível.A ajuda é impressa em um nome <f >ile se dada.