dotnet/project-system

Name: project-system

Owner: .NET Foundation

Description: The C#, F# and Visual Basic project system for Visual Studio

Created: 2016-04-21 03:40:18.0

Updated: 2018-01-13 00:06:52.0

Pushed: 2018-01-18 08:00:46.0

Homepage:

Size: 17209

Language: C#

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

C#, F# and Visual Basic project system

|Release|Branch|Unit Tests (Debug)|Unit Tests (Release)| |—|—|:–:|:–:| |15.0.x|dev15.0.x||| |15.5|dev15.5.x|| |15.6|dev15.6.x|| |15.7|dev15.7.x|| |15.8|master||

This repository contains the new C#, F# and Visual Basic project system that has been rewritten on top of the Common Project System (CPS). In Visual Studio 2017, this project system is used by default for Shared Projects (C# and Visual Basic), and .NET Core (C#) project types, however, long term it will be the basis of all C#, F# and Visual Basic project types.

The existing C# and Visual Basic project systems (csproj.dll and msvbprj.dll), which first shipped back in Visual Studio.net nearly 15 years ago, have served us well but are:

• Native and COM-based
• Single threaded and bound to the UI thread
• Hard to extend outside of aggregation via the use of <ProjectTypeGuids> and sub types (flavors)
• Tied to Visual Studio

The new C#, F# and Visual Basic project system is:

• Managed and managed-interface based
• Multi-threaded, scalable, and responsive
• Easy to extend via the use of the Managed Extensibility Framework (MEF) and composable. Many parties, including 3rd parties, can contribute to a single project system
• Hostable outside of Visual Studio

What is a project system?

A project system sits between a project file on disk (for example, .csproj and .vbproj) and various Visual Studio features including, but not limited to, Solution Explorer, designers, the debugger, language services, build and deployment. Almost all interaction that occurs with files contained in a project file, happens through the project system.

There are many technologies that come together to make up the .NET project system:

• MSBuild provides the build engine and file format.
• SDK provides the MSBuild tasks and targets needed to build .NET projects.
• Common Project System provides the base building blocks for the project system including (but not limited to) project tree, build and debugger coordination and Visual Studio integration.
• Roslyn provides C# and Visual Basic language support including compilers, IntelliSense, refactorings, analyzers and code fixes.
• Visual F# tools provides F# language support.
• CLI is the .NET command-line interface for building, running and interacting with .NET projects.

How do I engage and contribute?

We welcome you to try things out, file issues, make feature requests and join us in design conversations. If you are looking for something to work on, take a look at our up-for-grabs issues for a great place to start. Also be sure to check out our contributing guide.

This project has adopted a code of conduct adapted from the Contributor Covenant to clarify expected behavior in our community. This code of conduct has been adopted by many other projects. For more information see Contributors Code of conduct.