Definir vários projetos de inicialização

O Visual Studio permite que você especifique como mais de um projeto é executado quando você pressiona F5 (Iniciar com Depuração) ou Ctrl+F5 (Iniciar sem depuração) ou usar o botão da barra de ferramentas para iniciar seu aplicativo. Dessa forma, você pode iniciar vários sites, aplicativos ou serviços que dependem uns dos outros para funcionar corretamente durante uma sessão de depuração ou apenas executando e testando localmente.

Alguns modelos de projeto incluem vários projetos que já estão configurados para serem iniciados quando iniciados; por exemplo, o tipo de projeto React e ASP.NET Core inclui um projeto JavaScript do lado do cliente e um projeto ASP.NET Core do lado do servidor que são iniciados quando iniciados.

Para definir vários projetos de inicialização

1. No Gerenciador de Soluções , selecione a solução (o nó superior).

2. Escolha o menu de contexto do nó da solução (clique com o botão direito do mouse) e, em seguida, escolha Propriedades. A caixa de diálogo Páginas de Propriedades da Solução é exibida.

   

3. Expanda o nó Propriedades Comuns e escolha Projeto de Inicialização.

4. Escolha a opção Projetos de Inicialização Múltipla e defina as ações apropriadas.

Perfis de lançamento de vários projetos

Você pode configurar e salvar perfis para iniciar projetos específicos dentro de uma solução multiprojeto em estados predefinidos para depuração. Isso simplifica o processo de trabalho com soluções complexas, melhora a eficiência de depuração e permite o compartilhamento fácil de configurações entre os membros da equipe.

Habilitar perfil de lançamento de múltiplos projetos

Os perfis de inicialização de vários projetos estão disponíveis no Visual Studio 2022 17.11 e posterior. Para ativar ou desativar a funcionalidade Perfis de lançamento de múltiplos projetos, vá até Ferramentas > Opções > Recursos de Pré-visualização e marque ou desmarque a caixa de seleção para Habilitar perfis de lançamento múltiplos.

Criar um perfil de lançamento para múltiplos projetos

1. Abra sua solução Visual Studio que contém vários projetos.

2. No Gerenciador de Soluções, clique com o botão direito do mouse em sua solução e selecione Configurar Projetos de Inicialização....

   Você também pode pressionar Ctrl+Q (Início Rápido) e procurar por "Configurar projetos de inicialização" na Busca de Funcionalidades.

   

   A caixa de diálogo Páginas de Propriedades da Solução é exibida.

3. Nas Páginas de Propriedades da Solução, clique no separador Propriedades Comuns e selecione Configurar Projetos de Inicialização.

4. Na seção Configurar Projetos de Inicialização, escolha o botão de opção Vários projetos de inicialização.

   

   Abaixo do botão de opção, verás uma lista de todos os projetos na tua solução, e se estão configurados para serem iniciados ou não quando pressionas F5, e se cada projeto é iniciado sob o depurador ou sem depuração.

   Você pode usar as setas para cima e para baixo para controlar a ordem em que os projetos serão lançados.

5. Defina a ação para cada projeto como Iniciar, Iniciar sem depurarou Nenhume selecione um destino de depuração dependendo dos seus requisitos.

   

6. Habilite a caixa de seleção Compartilhar Perfil se quiser compartilhar o perfil com outros utilizadores do Visual Studio confirmando no ficheiro de configuração no repositório de controlo de versão. Os perfis de inicialização são salvos em um arquivo JSON com a extensão .slnLaunch no mesmo diretório da solução. A caixa de seleção Compartilhar Perfil determina se o perfil é salvo em um arquivo específico do usuário (desmarcado) ou em um arquivo destinado ao controle do código-fonte, como no Git (marcado).

   

   Aqui está um exemplo do perfil no arquivo .slnLaunch:

   [
      {
         "Name": "Feature Profile",
         "Projects": [
            {
            "Path": "src\\OrchardCore.Cms.Web\\OrchardCore.Cms.Web.csproj",
            "Action": "Start"
            },
            {
            "Path": "src\\OrchardCore\\OrchardCore.DisplayManagement\\OrchardCore.DisplayManagement.csproj",
            "Action": "Start"
            },
            {
            "Path": "src\\OrchardCore\\OrchardCore.Data\\OrchardCore.Data.csproj",
            "Action": "StartWithoutDebugging"
            },
            {
            "Path": "src\\OrchardCore\\OrchardCore.ContentManagement.Display\\OrchardCore.ContentManagement.Display.csproj",
            "Action": "Start"
            }
         ]
      }
   ]
   

7. Depois de configurar a ação de inicialização para cada projeto, clique no botão OK ou Aplicar para salvar o perfil. O perfil de inicialização criado aparece na lista suspensa da barra de ferramentas, permitindo que você selecione o perfil que deseja depurar.

   

Com Docker Compose

Ao usar o Docker Compose para iniciar projetos em contêineres em uma máquina local, você usa um método diferente (perfis de inicialização) para iniciar vários projetos.

O exemplo a seguir mostra uma solução WebFrontEndA com três projetos, um site front-end, um projeto de API Web e um projeto Docker Compose. A captura de tela a seguir mostra como iniciar dois dos três projetos, um com depuração e outro sem:

Neste exemplo e em qualquer outro cenário de composição do Docker, você escolhe docker-compose como o único projeto de inicialização, mas usará uma maneira diferente de especificar quais projetos ou serviços iniciar. Você usará um perfil de inicialização do Docker Compose para determinar quais serviços iniciar e se deve ou não anexar o depurador, e há uma caixa de diálogo diferente no Visual Studio para configurá-lo. Veja Iniciar um subconjunto de serviços. A caixa de diálogo Páginas de Propriedades da Solução é usada apenas para soluções não conteinerizadas ou quando você não está usando o Docker Compose para gerenciar a inicialização.

Conteúdo relacionado

• Compilar e construir
• Trabalhar com soluções e projetos
• Gerenciar propriedades de projetos e soluções