project system

视觉工作室的.NET项目系统

发布	建造	遵守	发布	本土化
主要的

该存储库包含用于Visual Studio的.NET项目系统，该项目编写在公共项目系统（CPS）框架之上。在Visual Studio 2017，Visual Studio 2019和Visual Studio 2022中，该项目系统用于.NET Core [SDK风格]（C＃，F＃和Visual Basic）以及共享项目（C＃和Visual Basic）项目类型。从长远来看，该项目系统将是所有C＃，F＃和Visual Basic项目类型的基础。有关项目系统之间功能差异的列表，请参见功能比较。

传统C＃和Visual Basic Project Systems（ csproj.dll和msvbprj.dll ）于2002年首次使用Visual Studio .NET运送。它们为我们服务了，但是：

• 本地和基于com的
• 单线并绑定到UI线程
• 难以通过使用<ProjectTypeGuids>和子类型（风味）来扩展在聚集之外
• C＃和视觉基本项目的单独实现

当前的.NET项目系统是：

• 基于托管和托管接口
• 多线程，可扩展和响应迅速
• 易于扩展和通过托管的可扩展性框架（MEF）组成。包括第三方在内的许多政党都可以为单个项目系统做出贡献。
• C＃，F＃和Visual Basic Projects的单个实现

什么是项目系统？

一个项目系统位于磁盘上的项目文件之间（例如， .csproj和.vbproj ）和各种Visual Studio功能，包括但不限于解决方案资源管理器，设计人员，设计人员，调试器，语言服务，构建和部署。几乎所有与项目文件中包含的文件发生的交互。通过项目系统发生。

有许多技术组成.NET项目系统：

• MSBUILD提供构建引擎和文件格式。
• SDK提供了用于构建，运行和与.NET项目交互的命令行接口，以及必要的MSBUILD任务和目标。
• Common Project System为项目系统提供了基础构建块，包括（但不限于）项目树，构建和调试器协调以及Visual Studio集成。
• 罗斯林（Roslyn）提供C＃和视觉基本语言支持，包括编译器，Intellisense，重构，分析仪和代码修复。
• Visual F＃工具提供F＃语言支持。

如何构建存储库？

该存储库建立在.NET框架上，要求MSBUILD的.NET框架版本成功构建。此外，由于.NET Project系统被捆绑为视觉工作室的扩展，以部署到Visual Studio中，因此对Visual Studio SDK有一个依赖性。

这是获取必要组件的方法：

• 安装最新的视觉工作室
  • 在安装过程中选择这些工作负载：
    • .NET桌面构建工具
    • 视觉工作室扩展开发

安装必要的组件后，只需在存储库的根部运行build.cmd批处理文件即可。这将适当地构建，测试和捆绑存储库。

build.cmd标志

提供构建的所有命令行参数。CMD被转发到MSBUILD。我们设置了一些特殊的属性来构建此存储库。

• 对于项目：
  • /p:SrcProjects=[true or false] ：包括SRC目录中的项目。默认值： true
  • /p:TestProjects=[true or false] ：在测试目录中包括项目。默认值： true
  • /p:SetupProjects=[true or false] ：包括设置目录中的项目。默认值： true
• 对于目标：
  • /p:Restore=[true or false] ：运行还原目标以获取项目依赖性。默认值： true
  • /p:Build=[true or false] ：运行构建目标以将项目编译成组件。默认值： true
  • /p:Rebuild=[true or false] ：运行清洁和构建项目的重建目标。默认值： false
  • /p:Test=[true or false] ：运行测试目标以执行Xunit测试项目。默认值： true
  • /p:Pack=[true or false] ：运行包目标将项目捆绑到Nuget软件包中。默认值： true

我如何参与和贡献？

我们欢迎您尝试一下，提交问题，提出功能请求，并加入我们的设计对话。如果您正在寻找要处理的东西，请查看我们的帮助问题，以便一个很好的起点。另外，请查看我们的贡献指南。

该项目采用了根据贡献者盟约改编的行为守则，以阐明我们社区中的预期行为。该行为守则已被许多其他项目采用。有关更多信息，请参见贡献者的行为准则。

商标

该项目可能包含用于项目，产品或服务的商标或徽标。 Microsoft商标或徽标的授权使用受到了Microsoft的商标和品牌准则的约束。在此项目的修改版本中使用Microsoft商标或徽标不得引起混乱或暗示Microsoft赞助。任何使用第三方商标或徽标都遵守这些第三方政策。

数据收集

该软件可能会收集有关您的信息和您对软件的使用，并将其发送给Microsoft。微软可能会使用此信息来提供服务并改善我们的产品和服务。您可以按照“ Visual Studio客户体验改进计划”中所述关闭遥测。该软件中还有一些功能可以使您和Microsoft从应用程序的用户收集数据。如果使用这些功能，则必须遵守适用的法律，包括向您的应用程序用户提供适当的通知以及Microsoft的隐私声明副本。我们的隐私声明位于https://go.microsoft.com/fwlink/?linkid=824704。您可以在帮助文档和我们的隐私声明中了解有关数据收集和使用的更多信息。您对软件的使用作为您同意这些做法的同意。