project system

Visual Studioの.NETプロジェクトシステム

リリース	建てる	コンプライアンス	公開	ローカリゼーション
主要

このリポジトリには、一般的なプロジェクトシステム（CPS）フレームワークの上に書かれたVisual Studio用の.NETプロジェクトシステムが含まれています。 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＃およびVisual Basicプロジェクトの個別の実装

現在の.NETプロジェクトシステムは次のとおりです。

• マネージドおよびマネージドインターフェイスベース
• マルチスレッド、スケーラブル、およびレスポンシブ
• 拡張が簡単で、管理された拡張性フレームワーク（MEF）を介して構成します。サードパーティを含む多くの当事者は、単一のプロジェクトシステムに貢献できます。
• C＃、F＃、Visual Basicプロジェクトの単一の実装

プロジェクトシステムとは何ですか？

プロジェクトシステムは、ディスク上のプロジェクトファイル（ .csprojや.vbprojなど）と、ソリューションエクスプローラー、デザイナー、デバッガー、言語サービス、ビルドおよび展開を含むがこれらに限定されないさまざまなビジュアルスタジオ機能の間にあります。プロジェクトファイルに含まれるファイルで発生するほとんどすべての相互作用は、プロジェクトシステムを介して行われます。

.NETプロジェクトシステムを構成するために集まる多くのテクノロジーがあります。

• MSBuildは、ビルドエンジンとファイル形式を提供します。
• SDKは、必要なMSBUILDタスクとターゲットとともに、.NETプロジェクトを構築、実行、および対話するためのコマンドラインインターフェイスを提供します。
• Common Project Systemは、プロジェクトツリー、ビルド、デバッガーの調整、ビジュアルスタジオ統合を含む（ただし、これらに限定されない）プロジェクトシステムのベースビルディングブロックを提供します。
• Roslynは、コンパイラ、Intellisense、リファクタリング、分析装置、コード修正など、C＃および視覚的な基本言語サポートを提供します。
• Visual F＃ツールはF＃言語サポートを提供します。

リポジトリを構築するにはどうすればよいですか？

このリポジトリは.NETフレームワーク上に構築されており、MSBUILDの.NETフレームワークバージョンを正常に構築する必要があります。さらに、.NETプロジェクトシステムがVisual Studioに展開するためのVisual Studio拡張機能としてバンドルされているため、Visual Studio SDKに依存しています。

必要なコンポーネントを取得する方法は次のとおりです。

• 最新のビジュアルスタジオをインストールします
  • インストール中にこれらのワークロードを選択します。
    • .NETデスクトップビルドツール
    • ビジュアルスタジオエクステンション開発

必要なコンポーネントがインストールされたら、リポジトリのルートでbuild.cmdバッチファイルを実行するだけです。これにより、リポジトリを適切に構築、テスト、バンドルします。

build.cmdフラグ

build.cmdに提供されたすべてのコマンドライン引数は、msbuildに転送されます。このリポジトリを構築するために設定した特別なプロパティがいくつかあります。

• プロジェクトの場合：
  • /p:SrcProjects=[true or false] ： SRCディレクトリ内のプロジェクトを含む。デフォルト： true
  • /p:TestProjects=[true or false] ： Testsディレクトリ内のプロジェクトを含む。デフォルト： 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に送信する場合があります。 Microsoftは、この情報を使用してサービスを提供し、製品とサービスを改善する場合があります。 「ビジュアルスタジオカスタマーエクスペリエンス改善プログラム」で説明されているように、テレメトリをオフにすることができます。また、ソフトウェアには、お客様とマイクロソフトがアプリケーションのユーザーからデータを収集できるようにする機能もあります。これらの機能を使用する場合は、Microsoftのプライバシーステートメントのコピーとともに、アプリケーションのユーザーに適切な通知を提供するなど、適用法に従う必要があります。プライバシーステートメントは、https：//go.microsoft.com/fwlink/?linkid=824704にあります。ヘルプのドキュメントとプライバシーステートメントで、データ収集と使用の詳細をご覧ください。ソフトウェアの使用は、これらのプラクティスへの同意として機能します。