project system

O sistema de projeto .NET para Visual Studio

Liberar	Construir	Conformidade	Publicar	Localização
principal

Este repositório contém o sistema de projeto .NET para o Visual Studio, que está escrito no topo da estrutura do sistema de projeto comum (CPS). No Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022, este sistema de projeto é usado para .NET Core [estilo SDK] (C#, F# e Visual Basic) e projetos compartilhados (C# e Visual Basic) tipos de projeto. A longo prazo, este sistema de projeto será a base para todos os tipos de projeto C#, F# e Visual Basic. Para uma lista de diferenças de recurso entre os sistemas de projeto, consulte a comparação de recursos.

Os Sistemas de Projeto Legado C# e Visual Basic ( csproj.dll e msvbprj.dll ) foram enviados pela primeira vez com o Visual Studio .NET em 2002. Eles nos serviram bem, mas são:

• Nativo e com base
• Único rosqueado e amarrado ao tópico da interface do usuário
• Difícil de estender para fora da agregação através do uso de <ProjectTypeGuids> e sub -tipos (sabores)
• Implementações separadas para projetos C# e Visual Basic

O atual sistema de projeto .NET é:

• Baseado em interface gerenciada e gerenciada
• Multi-thread, escalável e responsivo
• Fácil de estender e compor através da estrutura de extensibilidade gerenciada (MEF). Muitas partes, incluindo 3ª partes, podem contribuir para um único sistema de projeto.
• Uma única implementação para projetos C#, F# e Visual Basic

O que é um sistema de projeto?

Um sistema de projeto fica entre um arquivo de projeto no disco (por exemplo, .csproj e .vbproj ) e vários recursos do Visual Studio, incluindo, mas não se limitando a, explorador de soluções, designers, depurador, serviços de idiomas, construção e implantação. Quase toda a interação que ocorre com os arquivos contidos em um arquivo de projeto ocorre através do sistema de projeto.

Existem muitas tecnologias que se reúnem para compensar o sistema de projeto .NET:

• O MSBuild fornece o mecanismo de compilação e o formato de arquivo.
• O SDK fornece a interface da linha de comando para construir, executar e interagir com os projetos .NET, juntamente com as tarefas e metas do MSBuild necessário.
• O Common Project System fornece os blocos de construção básicos para o sistema de projetos, incluindo (mas não limitado a), coordenação de construir e depurador e integração do Visual Studio.
• Roslyn fornece suporte ao idioma C# e visual, incluindo compiladores, IntelliSense, Refatorings, Analyzers e Code Fixes.
• O Visual F# Tools fornece suporte de idioma F#.

Como faço para construir o repositório?

Este repositório é construído na estrutura .NET e requer a versão .NET Framework do MSBuild para construir com sucesso. Além disso, há uma dependência do Visual Studio SDK, pois o sistema de projeto .NET é incluído como uma extensão do Visual Studio para implantação no Visual Studio.

Aqui está como adquirir os componentes necessários:

• Instale o último Visual Studio
  • Selecione estas cargas de trabalho durante a instalação:
    • .NET Ferramentas de construção de desktop
    • Desenvolvimento de Extensão do Visual Studio

Após a instalação dos componentes necessários, basta executar o arquivo em lote build.cmd na raiz do repositório. Isso criará, testará e agrupará o repositório adequadamente.

sinalizadores Build.cmd

Todos os argumentos da linha de comando fornecidos ao Build.cmd recebem encaminhamento para o msbuild. Existem algumas propriedades especiais que criamos para a construção deste repositório.

• Para projetos:
  • /p:SrcProjects=[true or false] : inclui os projetos no diretório SRC . Padrão: true
  • /p:TestProjects=[true or false] : inclui os projetos no diretório de testes . Padrão: true
  • /p:SetupProjects=[true or false] : inclui os projetos no diretório de configuração . Padrão: true
• Para alvos:
  • /p:Restore=[true or false] : executa o destino da restauração para adquirir dependências do projeto. Padrão: true
  • /p:Build=[true or false] : executa o destino de construção para compilar os projetos em assemblies. Padrão: true
  • /p:Rebuild=[true or false] : executa o alvo de reconstrução que limpa e constrói os projetos. Padrão: false
  • /p:Test=[true or false] : executa o alvo de teste para executar os projetos de teste XUnit. Padrão: true
  • /p:Pack=[true or false] : executa o alvo da embalagem para agrupar os projetos em pacotes Nuget. Padrão: true

Como faço para envolver e contribuir?

Congratulamo -nos com você para experimentar as coisas, arquivar problemas, fazer solicitações de recursos e se juntar a nós em conversas de design. Se você está procurando algo em que trabalhar, dê uma olhada em nossos problemas de ajuda para um ótimo lugar para começar. Além disso, confira nosso guia contribuinte.

Este projeto adotou um código de conduta adaptado da aliança colaboradora para esclarecer o comportamento esperado em nossa comunidade. Este Código de Conduta foi adotado por muitos outros projetos. Para obter mais informações, consulte o Código de Conduta dos Contribuidores.

Marcas comerciais

Este projeto pode conter marcas comerciais ou logotipos para projetos, produtos ou serviços. O uso autorizado de marcas comerciais ou logotipos da Microsoft está sujeito e deve seguir as diretrizes de marca registrada e marca da Microsoft. O uso de marcas comerciais da Microsoft ou logotipos em versões modificadas deste projeto não deve causar confusão ou implicar o patrocínio da Microsoft. Qualquer uso de marcas comerciais ou logotipos de terceiros estão sujeitas às políticas de terceiros.

Coleta de dados

O software pode coletar informações sobre você e seu uso do software e enviá -lo para a Microsoft. A Microsoft pode usar essas informações para fornecer serviços e melhorar nossos produtos e serviços. Você pode desligar a telemetria, conforme descrito no "Programa de Melhoria da Experiência do Cliente do Visual Studio". Existem também alguns recursos no software que podem permitir que você e a Microsoft coletem dados de usuários de seus aplicativos. Se você usar esses recursos, deverá cumprir a lei aplicável, incluindo o fornecimento de avisos apropriados aos usuários de seus aplicativos, juntamente com uma cópia da declaração de privacidade da Microsoft. Nossa declaração de privacidade está localizada em https://go.microsoft.com/fwlink/?linkid=824704. Você pode aprender mais sobre a coleta e uso de dados na documentação de ajuda e nossa declaração de privacidade. Seu uso do software opera como seu consentimento para essas práticas.