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。您可以在幫助文檔和我們的隱私聲明中了解有關數據收集和使用的更多信息。您對軟件的使用作為您同意這些做法的同意。