Tutorial: Compilar um aplicativo

Neste artigo, familiarize-se com várias opções que você pode configurar ao compilar aplicativos com o Visual Studio. Você criará uma configuração de build personalizada, ocultará determinadas mensagens de aviso e aumentará as informações de saída de build de um aplicativo de exemplo.

Instalar o aplicativo de exemplo

O código de exemplo usado no tutorial está em exemplos do WPF. Para clonar o repositório, use o botão Clonar verde do GitHub e escolha Clonar no Visual Studio. Você pode escolher o local no disco rígido local para criar uma cópia do conteúdo do repositório. O repositório contém muitas soluções. Se o Visual Studio abrir uma delas, feche a solução, escolha Abrir projeto ou solução, navegue até o local onde você clonou o repositório e, nele, procure por GettingStarted/WalkthroughFirstWPFApp/csharp/ExpenseItIntro.sln para trabalhar em C# ou por GettingStarted/WalkthroughFirstWPFApp/vb/ExpenseItIntro2.sln para trabalhar no Visual Basic.

Criar uma configuração de build personalizada

Quando você cria uma solução, as configurações de Depuração e Versão de build, bem como seus destinos de plataforma padrão, são definidas para a solução automaticamente. Depois, é possível personalizar essas configurações ou criar suas próprias. As configurações de build especificam o tipo de build. As plataformas de build especificam o sistema operacional que um aplicativo tem como destino para a configuração. Para obter mais informações, confira Noções básicas sobre configurações de build, Configurar projetos para plataformas de destino e Como definir as configurações de depuração e versão.

É possível alterar ou criar configurações e configurações de plataforma por meio da caixa de diálogo Configuration Manager. Neste procedimento, você criará uma configuração de build para testes.

Criar uma configuração de build

Compilar o aplicativo

Em seguida, você compilará a solução com a configuração de build personalizada.

Compilar a solução

• Na barra de menus, escolha Compilar>Compilar Solução ou pressione Ctrl+Shift+B.

  A Janela de Saída exibe os resultados do build. O build foi bem-sucedido.

Ocultar avisos do compilador

Em seguida, apresentaremos alguns códigos que fazem com que um aviso seja gerado pelo compilador.

1. No projeto de C#, abra o arquivo ExpenseReportPage.xaml.cs. No método ExpenseReportPage, adicione o seguinte código: int i;.

   OU

   No projeto do Visual Basic, abra o arquivo ExpenseReportPage.xaml.vb. No construtor personalizado Public Sub New..., adicione o seguinte código: Dim i.

2. Compile a solução.

A Janela de Saída exibe os resultados do build. O build foi bem-sucedido, mas foram gerados avisos:

Temporariamente, é possível ocultar determinadas mensagens de aviso durante um build, em vez de deixá-las acumular a saída do build.

Ocultar um aviso específico do C#

1. No Gerenciador de Soluções, escolha o nó do projeto de nível superior.

2. Na barra de menus, escolha Exibir>Páginas de Propriedade.

   O Designer de Projeto é aberto.

3. Escolha a guia ou a seção Compilar e, em seguida, na caixa Suprimir avisos, especifique o número de aviso 0168. Se outros avisos já estiverem listados, use um ponto e vírgula como separador.

   

   

   Para obter mais informações, consulte Página Build, Designer de Projeto (C#).

4. Compile a solução usando Compilar > Recompilar Solução.

   A janela Saída exibe apenas informações de resumo da compilação (sem avisos).

   

   

Suprimir todos os avisos de build do Visual Basic

1. No Gerenciador de Soluções, escolha o nó do projeto de nível superior.

2. Na barra de menus, escolha Exibir>Páginas de Propriedade.

   O Designer de Projeto é aberto.

3. Na página Compilar, marque a caixa de seleção Desabilitar todos os avisos.

   

   

   Para obter mais informações, consulte Configurar avisos no Visual Basic.

4. Compile a solução. Se ela não for recompilada, compile a solução usando Compilar > Recompilar Solução.

   A janela Saída exibe apenas informações de resumo da compilação (sem avisos).

   

   

   Para obter mais informações, consulte Como suprimir avisos do compilador.

Exibir detalhes de build adicionais na janela Saída

É possível alterar a quantidade de informações sobre o processo de build exibidas na Janela de Saída. Geralmente, os detalhes de build são definidos como Mínimos, o que significa que a janela Saída exibe apenas um resumo do processo de build, junto com os avisos de prioridade alta ou erros. Exiba mais informações sobre o build usando a caixa de diálogo Opções, Projetos e Soluções, Compilar e Executar.

Alterar a quantidade de informações na janela Saída

1. Abra a caixa de diálogo Opções.

   

   

2. Escolha a categoria Projetos e Soluções e, em seguida, a página Compilar e Executar.

3. Na lista Detalhes da saída de build do projeto do MSBuild, escolha Normal e, em seguida, o botão OK.

4. Na barra de menus, escolha Build>Limpar Solução.

5. Compile a solução e, em seguida, examine as informações na Janela de Saída.

   As informações do build incluem a hora de início do build (localizada no início) e ordem em que os arquivos foram processados. Essas informações também incluem a sintaxe real do compilador que o Visual Studio executa durante o build.

   Por exemplo, no build de C#, a opção /nowarn lista o código de aviso 0168, que foi especificado anteriormente neste tópico, juntamente com três outros avisos.

   No build do Visual Basic, /nowarn não inclui avisos específicos a serem excluídos e, portanto, nenhum aviso é exibido.

   Dica

   Pesquise o conteúdo da janela Saída se você exibir a caixa de diálogo Localizar escolhendo as teclas Ctrl+F.

Para obter mais informações, consulte Como exibir, salvar e configurar arquivos de log de build.

Criar um build da versão

É possível compilar uma versão do aplicativo de exemplo que é otimizada para enviá-lo. Para o build de versão, você especificará que o arquivo executável é copiado para um compartilhamento de rede antes do início do build.

Para obter mais informações, consulte Como alterar o diretório de saída do build e Compilar e limpar projetos e soluções no Visual Studio.

Especificar um build de versão para o Visual Basic

1. Para abrir o Designer de Projeto, selecione o nó do projeto no Gerenciador de Soluções clicando com o botão direito do mouse e escolha Propriedades (ou pressione Alt+Enter) ou, no menu Exibir, escolha Páginas de Propriedades:

   

   

2. Escolha a página Compilar.

3. Na lista Configuração, escolha Versão.

4. Na lista Plataforma, escolha x86.

5. Na caixa Caminho de saída do build, especifique um caminho de rede.

   Por exemplo, você pode especificar \\myserver\builds.

   Importante

   Uma caixa de mensagem poderá ser exibida, avisando que o compartilhamento de rede especificado pode não ser um local confiável. Se você confiar no local especificado, escolha o botão OK na caixa de mensagem.

6. Construa o aplicativo.

   

   

Especificar um build de versão para o C#

1. Abra o Designer de Projeto.

   

   

2. Escolha a página Build.

3. Na lista Configuração, escolha Versão.

4. Na lista Plataforma, escolha x86.

5. Na caixa Caminho de saída, especifique um caminho de rede.

   Por exemplo, você pode especificar \\myserver\builds.

   Importante

   Uma caixa de mensagem poderá ser exibida, avisando que o compartilhamento de rede especificado pode não ser um local confiável. Se você confiar no local especificado, escolha o botão OK na caixa de mensagem.

6. Na barra de ferramentas Padrão, defina as Configurações da solução como Versão e as Plataformas da solução como x86.

7. Construa o aplicativo.

   

   

   O arquivo executável é copiado para o caminho de rede especificado. Seu caminho será \\myserver\builds\\FileName.exe.

Parabéns! Você concluiu este tutorial com êxito.

Confira também

• Passo a passo: Criar um projeto (C++)
• Visão geral da pré-compilação de projeto de aplicativo Web ASP.NET
• Passo a passo: Usar o MSBuild