Definindo as variáveis de caminho e ambiente para compilações de linha de comando
As ferramentas de compilação de linha de comando do Visual C++ requerem diversas variáveis de ambiente personalizadas para a instalação. Quando o Visual Studio é instalado, ele cria arquivos de comando que definem as variáveis de ambiente necessárias e cria atalhos que iniciam uma janela do Prompt de Comando com essas variáveis já definidas. Quando quiser usar as ferramentas de linha de comando, você poderá executar um destes atalhos ou abrir uma janela do Prompt de Comando básica e executar o arquivo de comando vcvarsall.bat.
As ferramentas de linha de comando do Visual C++ usam as variáveis de ambiente PATH, TMP, INCLUDE, LIB e LIBPATH e também podem usar variáveis de ambiente específicas da ferramenta. Como os valores dessas variáveis de ambiente são específicos da instalação e podem ser alterados na atualização do produto, recomendamos usar vcvarsall.bat ou um atalho do Prompt de Comando do Desenvolvedor em vez de defini-los por conta própria. Para obter informações sobre as variáveis de ambiente específicas usadas pelo compilador e pelo vinculador, consulte Variáveis de ambiente CL e Variáveis de ambiente LINK.
Dica
Diversas ferramentas de linha de comando ou opções de ferramenta requerem a permissão de Administrador.Para usá-las, recomendamos que você abra uma janela do Prompt de Comando usando a opção Executar como Administrador (no menu de atalho da janela do Prompt de Comando que deseja abrir).
Usando os atalhos do Prompt de Comando
O atalho do Prompt de Comando do Desenvolvedor incluído em todas as edições do Visual Studio abre uma janela do Prompt de Comando e define o ambiente para usar o conjunto de ferramentas nativo x86 de 32 bits para processadores x86 de destino. Também estão disponíveis Prompts de Comando para compiladores cruzados de 32 bits para plataformas x64 e ARM. Dependendo do sistema e da edição do Visual Studio instalado, também pode estar disponível um atalho do Prompt de Comando para um conjunto de ferramentas nativo x64 de 64 bits para processadores x64 e um compilador cruzado de 64 bits para processadores x86. Essas versões do conjunto de ferramentas de linha de comando estão disponíveis em todas as edições do Visual Studio:
x86 em x86
Use esse conjunto de ferramentas para criar arquivos de saída para computadores x86. Ele é executado como um processo de 32 bits, nativo em um computador x86 e em WOW64 em um sistema operacional Windows de 64 bits.x64 em x86 (compilador cruzado x64)
Use esse conjunto de ferramentas para criar arquivos de saída para x64. Ele é executado como um processo de 32 bits, nativo em um computador x86 e em WOW64 em um sistema operacional Windows de 64 bits.ARM em x86 (compilador cruzado ARM)
Use esse conjunto de ferramentas para criar arquivos de saída para computadores ARM. Ele é executado como um processo de 32 bits, nativo em um computador x86 e em WOW64 em um sistema operacional Windows de 64 bits.
Essas versões do conjunto de ferramentas de linha de comando estão disponíveis em plataformas de 64 bits:
x86 em x64
Use esse conjunto de ferramentas para criar arquivos de saída para computadores x86. Ele é executado como um processo nativo em um sistema operacional Windows de 64 bits.x64 em x64
Use esse conjunto de ferramentas para criar arquivos de saída para computadores x64. Ele é executado como um processo nativo em um sistema operacional Windows de 64 bits.ARM em x64 (compilador cruzado ARM)
Use esse conjunto de ferramentas para criar arquivos de saída para computadores ARM. Ele é executado como um processo nativo de 64 bits em um sistema operacional Windows de 64 bits.
Para abrir uma janela do Prompt de Comando do Desenvolvedor
Com a tela Iniciar do Windows 8 em exibição, digite Ferramentas do Visual Studio. Os resultados de pesquisa mudam à medida que você digita. Quando Ferramentas do Visual Studio for exibido, selecione-o.
Em versões anteriores do Windows, escolha Iniciar e, na caixa de pesquisa, digite Ferramentas do Visual Studio. Quando Ferramentas do Visual Studio for exibido nos resultados de pesquisa, escolha-o.
Na pasta Ferramentas do Visual Studio, abra o Prompt de Comando do Desenvolvedor da versão do Visual Studio. (Para executar como administrador, abra o menu de atalho do Prompt de Comando do Desenvolvedor e escolha Executar como Administrador.)
O Prompt de Comando do Desenvolvedor define o ambiente para usar o conjunto de ferramentas nativo de 32 bits para processadores x86. Escolha o Prompt de Comando de Ferramentas Cruzadas do x64 para usar o conjunto de ferramentas nativo de 32 bits para processadores x64. Escolha o Prompt de Comando de Ferramentas Cruzadas do ARM para usar o conjunto de ferramentas nativo de 32 bits para processadores ARM. Escolha o Prompt de Comando de Ferramentas Nativas do x64 para usar o conjunto de ferramentas nativo de 64 bits para processadores x64.
Usando vcvarsall.bat em uma janela do Prompt de Comando
Executando vcvarsall.bat em uma janela do Prompt de Comando simples, você pode definir variáveis de ambiente para configurar a linha de comando da compilação de 32 bits ou de 64 bits nativa ou para compilação cruzada de processadores x86, x64 ou ARM. Se nenhum argumento for fornecido, vcvarsall.bat configurará as variáveis de ambiente para usar o compilador nativo de 32 bits para destinos x86. Porém, é possível usá-lo para configurar qualquer um dos compiladores. Se você especificar uma configuração de compilador não instalada ou não disponível na arquitetura do computador de compilação, será exibida uma mensagem. A tabela a seguir mostra os argumentos compatíveis.
Argumento Vcvarsall.bat |
Compilador |
Arquitetura do computador de compilação |
Arquitetura de saída de compilação |
|---|---|---|---|
x86 |
Nativa de 32 bits x86 |
x86, x64 |
x86 |
x86_amd64 |
x64 em x86 cruzado |
x86, x64 |
x64 |
x86_arm |
ARM em x86 cruzado |
x86, x64 |
ARM |
amd64 |
x64 Nativa de 64 bits |
x64 |
x64 |
amd64_x86 |
x86 em x64 cruzado |
x64 |
x86 |
amd64_arm |
ARM em x64 cruzado |
x64 |
ARM |
As etapas a seguir mostram como configurar um Prompt de Comando para usar o conjunto de ferramentas nativo de 32 bits para plataformas x86.
Para executar vcvarsall.bat
No prompt de comando, altere para o diretório de instalação do Visual C++. (O local depende do sistema e da instalação do Visual Studio, mas um local típico é C:\Arquivos de Programas (x86)\Microsoft Visual Studio versão\VC\.) Por exemplo, insira:
cd "\Program Files (x86)\Microsoft Visual Studio 12.0\VC"
Para configurar essa janela do Prompt de Comando para compilações de linha de comando x86 de 32 bits, no prompt de comando, insira:
vcvarsall x86
Visual Studio também fornece vcvars32.bat para configurar um ambiente de linha de comando. O arquivo vcvars32.bat é limitado à configuração das variáveis de ambiente adequadas para habilitar compilações de linha de comando x86 de 32 bits. Ele é o equivalente ao comando vcvarsall x86.
Se estiver usando DEVENV para compilações de linha de comando, o ambiente definido por vcvarsall.bat ou vcvars32.bat não afetará as compilações, a menos que você especifique também a opção /useenv.
Aviso
O arquivo vcvarsall.bat pode variar de um computador para outro.Não substitua um arquivo vcvarsall.bat não encontrado ou danificado usando um arquivo de outro computador.Execute novamente a Instalação do Visual Studio para substituir o arquivo não encontrado.
O arquivo vcvarsall.bat também varia de uma versão para outra.Se a versão atual do Visual C++ estiver instalada em um computador que também tem uma versão anterior do Visual C++, não execute vcvarsall.bat ou vcvars32.bat das versões diferentes na mesma janela do Prompt de Comando.