Noções sobre configurações de buildUnderstanding build configurations

Você pode armazenar diferentes configurações de propriedades da solução e do projeto para usar em diferentes tipos de builds durante o processo de desenvolvimento.You can store different configurations of solution and project properties to use in different kinds of builds during the development process. Os projetos criados por Visual Studio para Mac usando um modelo normalmente incluirão configurações de depuração e versão que dão suporte à depuração de um aplicativo e à implantação de um aplicativo, respectivamente.Projects created by Visual Studio for Mac using a template will typically include Debug and Release configurations that support debugging of an app and deployment of an app, respectively.

Se você quiser criar configurações personalizadas, consulte criando e editando configurações de compilação.If you'd like to create custom configurations, see Creating and editing build configurations.

Observação

Este tópico se aplica ao Visual Studio para Mac.This topic applies to Visual Studio for Mac. Para o Visual Studio no Windows, consulte entender as configurações de Build.For Visual Studio on Windows, see Understand build configurations.

Configurações da soluçãoSolution configurations

As configurações de solução são usadas para especificar configurações para todos os projetos em uma solução.Solution configurations are used to specify configurations for all projects in a solution. Usando a guia mapeamentos de configuração no item Compilar > configurações , você pode atribuir uma configuração de destino para cada item na solução aberta.By using the Configuration Mappings tab under the Build > Configurations item, you can assign a target configuration for each item in the opened solution. Isso é demonstrado na imagem a seguir:This is demonstrated in the following image:

Opções de mapeamento de configuração

Para saber mais sobre configurações, veja o vídeo do Configuration Manager de James Montemagno.For more information about configurations, see the Configuration Manager video by James Montemagno.

Configurações de build do projetoProject build configurations

Os projetos tendem a ter várias configurações.Projects tend to have multiple configurations. A configuração e a plataforma de destino de um projeto são usadas juntas para especificar as propriedades a serem usadas quando ele é compilado.The configuration and platform a project targets are used together to specify the properties to use when it's built. Alternar entre configurações permite saídas diferentes no momento da compilação.Switching between configurations allows for different outputs at build time. 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.For example, a Debug configuration will output debugging symbols, allowing the debugger to resolve function names, parameters, or variables from a crashed application's stack trace. 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.While this additional information is useful during development, it leads to an inflated file size and isn't ideal for distribution.

Cada plataforma tem configurações específicas para seu build.Each platform has specific configurations for its build. As páginas de configuração de compilação para projetos podem ser acessadas navegando até a seção Build na caixa de diálogo Opções do projeto .The build configuration pages for projects can be accessed by navigating to the Build section in the Project Options dialog. 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.Open up this dialog by right-clicking the project and selecting Options or by double-clicking the project in the solution explorer.

Configuração de execuçãoRun configuration

Visual Studio para Mac permite definir uma configuração de execução.Visual Studio for Mac allows you to set a run configuration. 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:The run configurations are presented in a drop-down list in the toolbar, next to the build configuration selector as illustrated below:

Lista suspensa Configuração de execução

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.A run configuration is a set of execution options with a name and several configurations that are defined in a project for different purposes. As configurações de execução são definidas no nível do projeto e um padrão será criado automaticamente para cada projeto executável, embora seja possível adicionar tantos quantos forem necessários.Run configurations are defined at the project level, and a default will be created automatically for each executable project, although it's possible to add as many as needed. Certos tipos de projeto geram configurações de execução adicionais automaticamente.Certain project types automatically generate additional run configurations. Por exemplo, projetos watchOS podem gerar Configurações de visão rápida e de notificação.For example, watchOS projects may generate Glance and Notification configurations.

As configurações podem ser compartilhadas com outros desenvolvedores (nesse caso, as configurações serão armazenadas no arquivo. csproj) ou mantidas localmente (nesse caso, elas serão armazenadas em um arquivo. User).Configurations can be shared with other developers (in which case the configurations will be stored in the .csproj file) or kept locally (in which case they'll be stored in a .user file).

Configurações de execução do AndroidAndroid run configurations

As configurações de execução para projetos do Android permitem que a especificação de uma atividade, serviço ou receptor de difusão específico seja iniciada durante a execução ou a depuração do projeto.Run configurations for Android projects allow specification of a particular activity, service, or broadcast receiver to launch when running or debugging the project. Você pode passar dados adicionais de tentativa e definir sinalizadores de intenção para testar seus componentes em condições de inicialização diferentes.You can pass intent extra data and set intent flags to test your components under different launch conditions.

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.Activities other than the MainLauncher will need to have Exported=true added to the Activity attribute for debugging on a physical device, or have Intent filters defined.

Exemplos de dados que podem ser incluídos em configurações de execuçãoExamples of data that might be included in run configurations

A lista a seguir fornece alguns exemplos de dados que podem ser incluídos em configurações de execução:The following list provides some examples of data that could be included in run configurations:

  • Projeto .NET regularRegular .NET project
    • Aplicativo de inicialização alternativoAlternative startup app
    • Argumentos iniciaisStart arguments
    • Diretório de trabalhoWorking directory
    • Variáveis de ambienteEnvironment variables
    • Opções de runtime Mono (deve ser usado somente quando em execução no Mono)Mono runtime options (to be used only when running on Mono)
  • Projeto do AndroidAndroid project
    • Ponto de entrada (atividade, serviço, receptor)Entry point (activity, service, receiver)
    • Dados e os argumentos de intençãoIntent arguments and data
  • Projeto do iOSiOS project
    • Modo (Normal, Fetch em segundo plano)Mode (Normal, Background Fetch)
  • Projeto de extensão de iOSiOS extension project
    • Aplicativo de inicialização: padrão ou personalizadaStartup app: default or custom
  • Projeto do WatchKitWatchKit project
    • Modo (Visão rápida, Notificação)Mode (Glance, Notification)
    • Conteúdo da notificaçãoNotification payload

Confira tambémSee also