Share via


Entendendo as configurações de compilação no Visual Studio para Mac

Importante

O Visual Studio para Mac está programado para ser desativado em 31 de agosto de 2024, de acordo com a Política de Ciclo de Vida Moderna da Microsoft. Embora você possa continuar a trabalhar com o Visual Studio para Mac, há várias outras opções para desenvolvedores no Mac, como a versão prévia da nova extensão do Kit de Desenvolvimento em C# para VS Code.

Saiba mais sobre cronogramas e alternativas de suporte.

É possível armazenar diferentes configurações de propriedades de solução e de projeto para usar em diferentes tipos de builds durante o processo de desenvolvimento. Os projetos criados pelo Visual Studio para Mac usando um modelo normalmente incluirão configurações de Depuração e Versão que dão suporte à depuração e à implantação de um aplicativo, respectivamente.

Se você quiser criar configurações personalizadas, confira Criar e editar configurações de build.

Observação

Este tópico se aplica ao Visual Studio para Mac. Para o Visual Studio no Windows, confira Entender as configurações de build.

Configurações da solução

As configurações de solução são usadas para especificar configurações para todos os projetos em uma solução. Usando a guia Mapeamentos de Configuração no item Build > Configurações, você pode atribuir uma configuração de destino para cada item na solução aberta. Isso é demonstrado na seguinte imagem:

Configuration Mapping Options

Configurações de build do projeto

Os projetos tendem a ter várias configurações. A configuração e a plataforma às quais um projeto se destina serão usadas conjuntamente para especificar as propriedades a serem usadas quando ele for criado. Alternar entre configurações permite saídas diferentes em tempo de build. Por exemplo, uma Configuração de depuração gerará a saída de símbolos de depuração, permitindo que o depurador resolva nomes de funções, parâmetros ou variáveis do rastreamento de pilha do aplicativo com falha. Embora essas informações adicionais sejam úteis durante o desenvolvimento, elas levarão a um tamanho de arquivo inflado e não é ideal para distribuição.

Cada plataforma tem configurações específicas para seu build. As páginas de configuração de build para projetos podem ser acessadas navegando até a seção Compilar na caixa de diálogo Opções do Projeto. Abra essa caixa de diálogo clicando com o botão direito do mouse no projeto e selecionando Opções ou clicando duas vezes no projeto no Gerenciador de Soluções.

Configuração de execução

Visual Studio para Mac permite definir uma configuração de execução. As configurações de execução são apresentadas em uma lista suspensa na barra de ferramentas, ao lado de seletor de configuração de build, conforme ilustrado abaixo:

Run Configuration dropdown list

Uma configuração de execução é um conjunto de opções com um nome e várias configurações que são definidas em um projeto para finalidades diferentes. As configurações de execução são definidas no nível de projeto e um padrão será criado automaticamente para cada projeto executável, embora seja possível adicionar tantos quantos forem necessários. Certos tipos de projeto geram configurações de execução adicionais automaticamente. Por exemplo, os projetos watchOS podem gerar configurações de Visão geral e de Notificação.

As configurações podem ser compartilhadas com outros desenvolvedores (nesse caso, elas serão armazenadas no arquivo .csproj) ou mantidas localmente (nesse caso, elas serão armazenados em um arquivo .user).

Configurações de execução do Android

Configurações de execução em projetos Android permitem a especificação de uma atividade, serviço ou receptor de difusão para iniciar ao executar ou depurar o projeto. Você pode passar dados extras intencionais e definir sinalizadores de intenção para poder testar seus componentes em condições diferentes de inicialização.

Atividades além de MainLauncher precisarão ter Exported=true adicionado ao atributo Atividade para a depuração em um dispositivo físico ou ter filtros de Intenção definidos.

Exemplos de dados que podem ser incluídos em configurações de execução

A lista a seguir fornece alguns exemplos de dados que podem ser incluídos em configurações de execução:

  • Projeto .NET regular
    • Aplicativo de inicialização alternativo
    • Argumentos iniciais
    • Diretório de trabalho
    • Variáveis de ambiente
    • Opções de runtime Mono (deve ser usado somente quando em execução no Mono)
  • Projeto do Android
    • Ponto de entrada (atividade, serviço, receptor)
    • Dados e os argumentos de intenção
  • Projeto do iOS
    • Modo (Normal, Fetch em segundo plano)
  • Projeto de extensão de iOS
    • Aplicativo de inicialização: padrão ou personalizada
  • Projeto do WatchKit
    • Modo (Visão rápida, Notificação)
    • Conteúdo da notificação

Confira também