project system

El sistema de proyectos .NET para Visual Studio

Liberar	Construir	Cumplimiento	Publicar	Localización
principal

Este repositorio contiene el sistema de proyectos .NET para Visual Studio que está escrito en la parte superior del marco del Sistema de Proyectos Común (CPS). En Visual Studio 2017, Visual Studio 2019 y Visual Studio 2022, este sistema de proyectos se utiliza para .NET Core [SDK-Style] (C#, F# y Visual Basic) y proyectos compartidos (C# y Visual Basic) tipos de proyectos. A largo plazo, este sistema de proyecto será la base de todos los tipos de proyectos C#, F# y Visual Basic. Para una lista de diferencias de características entre los sistemas de proyectos, consulte la comparación de características.

Legacy C# y Visual Basic Project Systems ( csproj.dll y msvbprj.dll ) se enviaron por primera vez con Visual Studio .NET en 2002. Nos han servido bien pero son:

• Nativo y basado en com
• Solo enhebrado y atado al hilo de la interfaz de usuario
• Difícil de extender fuera de la agregación mediante el uso de <ProjectTypeGuids> y subtipos (sabores)
• Implementaciones separadas para C# y proyectos de Visual Basic

El sistema actual del proyecto .NET es:

• Basado en la interfaz administrada y administrada
• Múltiple, escalable y receptivo
• Fácil de extender y componer a través del Marco de Extensibilidad Administrada (MEF). Muchas partes, incluidas las terceras, pueden contribuir a un solo sistema de proyecto.
• Una sola implementación para proyectos C#, F# y Visual Basic

¿Qué es un sistema de proyecto?

Un sistema de proyecto se encuentra entre un archivo de proyecto en el disco (por ejemplo, .csproj y .vbproj ) y varias características de Visual Studio, incluidas, entre otros, el explorador de soluciones, los diseñadores, el depurador, los servicios de idiomas, la construcción y la implementación. Casi toda la interacción que ocurre con los archivos contenidos en un archivo de proyecto ocurre a través del sistema del proyecto.

Hay muchas tecnologías que se unen para formar el sistema de proyectos .NET:

• MSBuild proporciona el formato de motor y el formato de archivo.
• SDK proporciona la interfaz de línea de comandos para construir, ejecutar e interactuar con los proyectos .NET, junto con las tareas y objetivos MSBuild necesarios.
• Common Project System proporciona los bloques de construcción base para el sistema de proyectos que incluyen (pero no limitado a) el árbol de proyectos, la coordinación de la construcción y el depurador y la integración de Visual Studio.
• Roslyn proporciona soporte de lenguaje C# y Visual Basic que incluye compiladores, IntelliSense, refactorizaciones, analizadores y correcciones de código.
• Visual F# Tools proporciona soporte de lenguaje F#.

¿Cómo construyo el repositorio?

Este repositorio se basa en .NET Framework y requiere la versión .NET Framework de MSBuild para construir con éxito. Además, existe una dependencia del SDK de Visual Studio, ya que el sistema del proyecto .NET se agrupa como una extensión de Visual Studio para la implementación en Visual Studio.

Aquí está cómo adquirir los componentes necesarios:

• Instale el último Visual Studio
  • Seleccione estas cargas de trabajo durante la instalación:
    • Herramientas de compilación de .NET Desktop
    • Desarrollo de Extensión de Visual Studio

Después de instalar los componentes necesarios, simplemente ejecute el archivo de lotes build.cmd en la raíz del repositorio. Esto construirá, probará y agrupará el repositorio adecuadamente.

Build.cmd Flags

Todos los argumentos de línea de comando proporcionados a Build.cmd se envían a MSBuild. Hay algunas propiedades especiales que hemos establecido para construir este repositorio.

• Para proyectos:
  • /p:SrcProjects=[true or false] : incluye los proyectos dentro del directorio SRC . Valor predeterminado: true
  • /p:TestProjects=[true or false] : incluye los proyectos dentro del directorio de pruebas . Valor predeterminado: true
  • /p:SetupProjects=[true or false] : incluye los proyectos dentro del directorio de configuración . Valor predeterminado: true
• Para los objetivos:
  • /p:Restore=[true or false] : ejecuta el objetivo de restauración para adquirir dependencias del proyecto. Valor predeterminado: true
  • /p:Build=[true or false] : ejecuta el objetivo de compilación para compilar los proyectos en ensambles. Valor predeterminado: true
  • /p:Rebuild=[true or false] : ejecuta el objetivo de reconstrucción que limpia y construye los proyectos. Valor predeterminado: false
  • /p:Test=[true or false] : ejecuta el objetivo de prueba para ejecutar los proyectos de prueba XUnit. Valor predeterminado: true
  • /p:Pack=[true or false] : ejecuta el objetivo de paquete para agrupar los proyectos en paquetes Nuget. Valor predeterminado: true

¿Cómo me involucro y contribuyo?

Le damos la bienvenida a probar las cosas, los problemas de archivos, hacer solicitudes de funciones y unirnos a nosotros en conversaciones de diseño. Si está buscando algo en lo que trabajar, eche un vistazo a nuestra ayuda, quería problemas para un excelente lugar para comenzar. Además, consulte nuestra guía contribuyente.

Este proyecto ha adoptado un código de conducta adaptado del pacto de contribuyentes para aclarar el comportamiento esperado en nuestra comunidad. Este código de conducta ha sido adoptado por muchos otros proyectos. Para obtener más información, consulte el Código de Conducta de los contribuyentes.

Marcas registradas

Este proyecto puede contener marcas comerciales o logotipos para proyectos, productos o servicios. El uso autorizado de marcas o logotipos de Microsoft está sujeto y debe seguir las pautas de marca y marca de Microsoft. El uso de marcas registradas de Microsoft o logotipos en versiones modificadas de este proyecto no debe causar confusión o implicar el patrocinio de Microsoft. Cualquier uso de marcas comerciales o logotipos de terceros está sujeto a las políticas de esas partes de terceros.

Recopilación de datos

El software puede recopilar información sobre usted y su uso del software y enviarla a Microsoft. Microsoft puede usar esta información para proporcionar servicios y mejorar nuestros productos y servicios. Puede desactivar la telemetría como se describe en el "Programa de mejora de la experiencia del cliente de Visual Studio". También hay algunas características en el software que pueden permitirle a usted y a Microsoft recopilar datos de los usuarios de sus aplicaciones. Si utiliza estas funciones, debe cumplir con la ley aplicable, incluida la proporcionar avisos apropiados a los usuarios de sus aplicaciones junto con una copia de la declaración de privacidad de Microsoft. Nuestra declaración de privacidad se encuentra en https://go.microsoft.com/fwlink/?linkid=824704. Puede obtener más información sobre la recopilación y el uso de datos en la documentación de ayuda y nuestra declaración de privacidad. Su uso del software opera como su consentimiento para estas prácticas.