Opções de linha de comando do Devenv

  • Artigo

O Devenv permite definir várias opções no IDE, compilar, depurar e implantar projetos a partir de uma linha de comando. Use essas opções para executar o IDE com um script ou arquivo .bat (por exemplo, um script de nightly build) ou para iniciar o IDE em uma configuração específica.

Observação

Para tarefas relacionadas ao build, é recomendável usar o MSBuild em vez do Devenv. Para obter mais informações, consulte Referência de linha de comando do MSBuild.

Para saber mais sobre as opções destinadas principalmente ao desenvolvimento de extensões do Visual Studio, consulte Opções de linha de comando do Devenv para desenvolvimento de VSPackage.

Sintaxe da opção do devenv

Os comandos que começam com devenv são manipuladas pelo utilitário do devenv.com, que fornece a saída por meio de fluxos de sistema padrão, como stdout e stderr. O utilitário determina o redirecionamento de E/S apropriado quando ele captura a saída, por exemplo, em um arquivo .txt.

Como alternativa, os comandos que começam com devenv.exe podem usar as mesmas opções, mas o utilitário devenv.com é ignorado. Usando devenv.exe diretamente impede que a saída seja exibida no console.

As regras de sintaxe para opções do devenv são semelhantes às regras de outros utilitários de linha de comando do DOS. As regras de sintaxe a seguir se aplicam a todas as opções devenv e seus argumentos:

  • Os comandos começam com devenv.

  • As opções não diferenciam maiúsculas de minúsculas.

  • Você pode especificar uma opção usando um hífen (-) ou uma barra (/).

  • Ao especificar uma solução ou um projeto, o primeiro argumento é o nome do arquivo de solução ou do arquivo de projeto, incluindo o caminho do arquivo.

  • Se o primeiro argumento for um arquivo que não seja uma solução ou um projeto, esse arquivo será aberto no editor apropriado, em uma nova instância do IDE.

  • Ao fornecer um nome de arquivo de projeto em vez de um nome de arquivo de solução, um comando devenv pesquisa na pasta pai do arquivo de projeto um arquivo de solução que tem o mesmo nome. Por exemplo, o comando devenv myproject1.vbproj /build pesquisa um arquivo de solução chamado myproject1.sln na pasta pai.

    Observação

    Apenas um arquivo de solução que referencia esse projeto deve ser localizado em sua pasta pai. Se a pasta pai não contiver nenhum arquivo de solução que referencie esse projeto ou se contiver dois ou mais arquivos de solução que a referenciem, então um arquivo de solução temporário será criado.

  • Quando nomes de arquivo e caminhos de arquivo incluírem espaços, será necessário usar aspas duplas (""). Por exemplo, "c:\project a\".

  • Insira um caractere de espaço entre as opções e os argumentos na mesma linha. Por exemplo, o comando devenv /log output.txt abre o IDE e coloca todas as informações de log dessa sessão em output.txt.

  • Não é possível usar sintaxe de correspondência de padrões em comandos do devenv.

Opções do devenv

As seguintes opções de linha de comando apresentam o IDE e realizam a tarefa descrita.

Opção de linha de comando Descrição
/Command Inicia o IDE e executa o comando especificado.

devenv /command "nav https://learn.microsoft.com/"
/DebugExe Carrega um executável C++ no controle do depurador. Esta opção não está disponível nos executáveis do Visual Basic ou C#. Para obter mais informações, consulte Automatically start a process in the debugger (Iniciar automaticamente um processo no depurador).

devenv /debugexe mysln.exe
/Diff Compara dois arquivos. Assume quatro parâmetros: SourceFile, TargetFile, SourceDisplayName (opcional) e TargetDisplayName (opcional).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects Abre a solução especificada sem carregar projetos.

devenv /donotloadprojects mysln.sln
/Edit Abre os arquivos especificados em uma instância em execução deste aplicativo. Se não houver nenhuma instância em execução, uma nova instância será iniciada com um layout de janela simplificado.

devenv /edit File1 File2
/LCID ou /L Define o idioma padrão do IDE. Se a linguagem especificada não estiver incluída em sua instalação do Visual Studio, essa configuração será ignorada.

devenv /l 1033
/Log Inicia o Visual Studio e registra toda a atividade no arquivo de log.

devenv /log mylogfile.xml
/NoScale Abre o IDE em um modo desabilitado por DPI que permite um layout mais preciso no Designer de Windows Forms.
/NoSplash Abre o IDE sem mostrar a tela inicial.

devenv /nosplash File1 File2
/ResetSettings Restaura as configurações padrão do Visual Studio. Opcionalmente, redefine as configurações para o arquivo .vssettings especificado.

devenv /resetsettings mysettings.vssettings
/Run ou /R Compila e executa a solução especificada.

devenv /run mysln.sln
/RunExit Compila e executa a solução especificada, minimiza o IDE quando a solução é executada e fecha o IDE depois que a solução termina a execução.

devenv /runexit mysln.sln
/SafeMode Inicia o Visual Studio no modo de segurança. Esta opção carrega somente o ambiente padrão, os serviços padrão e as versões enviadas de pacotes de terceiros.

Esta opção não aceita nenhum argumento.
/TfsLink Abre o Team Explorer e inicia um visualizador para o artefato URI fornecido se estiver registrado.
/UseEnv Faz com que o IDE use variáveis de ambiente PATH, INCLUDE, LIBPATH e LIB para a compilação C++. Essa opção é instalada com a carga de trabalho de Desenvolvimento para desktop com C++. Para obter mais informações, consulte Configurando o caminho e variáveis de ambiente para Builds de linha de comando.

As opções de linha de comando a seguir não exibem o IDE.

Opção de linha de comando Descrição
/? Exibe a ajuda para as opções do devenv na janela do prompt de comando.

Esta opção não aceita nenhum argumento.
/Build Cria a solução ou o projeto especificado de acordo com a configuração da solução especificada.

devenv mysln.sln /build
/Clean Exclui os arquivos criados pelo comando de build sem afetar os arquivos de origem.

devenv mysln.sln /clean
/Deploy Compila a solução com os arquivos necessários para implantação, de acordo com a configuração da solução.

devenv mysln.sln /deploy
/Out Permite que você especifique um arquivo para receber erros ao compilar.

devenv mysln.sln /build Debug /out log.txt
/Project O projeto a ser criado, limpo ou implantado. É possível usar esta opção somente se você tiver fornecido a opção /Build, /Rebuild, /Clean ou /Deploy.

devenv mysln.sln /build Debug /project proj1
/ProjectConfig Especifica a configuração de projeto a ser criada ou implantada. É possível usar esta opção somente se você tiver fornecido a opção /Project.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild Limpa e depois compila a solução ou o projeto especificado de acordo com a configuração da solução especificada.

devenv mysln.sln /rebuild
/Setup Força o Visual Studio a mesclar os metadados de recursos que descrevem menus, barras de ferramentas e grupos de comando de todos os VSPackages disponíveis. Você só pode executar esse comando como administrador.
/Upgrade Atualiza o arquivo de solução especificado e todos os seus arquivos de projeto ou o arquivo de projeto especificado, para os formatos do Visual Studio atuais para esses arquivos.

devenv mysln.sln /upgrade

Confira também