project system

Sistem Proyek .NET untuk Visual Studio

Melepaskan	Membangun	Kepatuhan	Menerbitkan	Lokalisasi
utama

Repositori ini berisi sistem proyek .NET untuk Visual Studio yang ditulis di atas kerangka kerja Sistem Proyek Umum (CPS). Dalam Visual Studio 2017, Visual Studio 2019, dan Visual Studio 2022, sistem proyek ini digunakan untuk .NET Core [SDK-style] (C#, F# dan Visual Basic) dan tipe proyek proyek (C# dan Visual Basic). Dalam jangka panjang, sistem proyek ini akan menjadi dasar untuk semua tipe proyek C#, F# dan visual Basic. Untuk daftar perbedaan fitur antara sistem proyek, lihat perbandingan fitur.

The Legacy C# dan Visual Basic Project Systems ( csproj.dll dan msvbprj.dll ) pertama kali dikirim dengan Visual Studio .NET pada tahun 2002. Mereka telah melayani kami dengan baik tetapi sedang:

• Berbasis Asli dan COM
• Tunggal berulir dan terikat ke utas UI
• Sulit Memperpanjang Di Luar Agregasi Melalui Penggunaan <ProjectTypeGuids> dan Sub Jenis (rasa)
• Implementasi terpisah untuk C# dan Proyek Dasar Visual

Sistem proyek .NET saat ini adalah:

• Berbasis dikelola dan dikelola
• Multi-threaded, scalable, dan responsif
• Mudah untuk memperluas dan menyusun melalui kerangka kerja ekstensibilitas yang dikelola (MEF). Banyak pihak, termasuk pihak ke -3, dapat berkontribusi pada sistem proyek tunggal.
• Implementasi tunggal untuk proyek C#, F# dan Visual

Apa itu sistem proyek?

Sistem proyek berada di antara file proyek pada disk (misalnya, .csproj dan .vbproj ) dan berbagai fitur studio visual termasuk, tetapi tidak terbatas pada, penjelajah solusi, perancang, debugger, layanan bahasa, pembangunan dan penyebaran. Hampir semua interaksi yang terjadi dengan file yang terkandung dalam file proyek terjadi melalui sistem proyek.

Ada banyak teknologi yang berkumpul untuk membuat sistem proyek .NET:

• MSBuild menyediakan mesin build dan format file.
• SDK menyediakan antarmuka baris perintah untuk membangun, menjalankan, dan berinteraksi dengan proyek .NET, bersama dengan tugas dan target MSBuild yang diperlukan.
• Sistem Proyek Umum menyediakan blok bangunan dasar untuk sistem proyek termasuk (tetapi tidak terbatas pada) pohon proyek, koordinasi build dan debugger dan integrasi studio visual.
• Roslyn menyediakan C# dan dukungan bahasa dasar visual termasuk kompiler, intelisense, refactorings, analisis, dan perbaikan kode.
• Visual F# Tools menyediakan dukungan bahasa F#.

Bagaimana cara membangun repositori?

Repositori ini dibangun di atas .NET Framework dan membutuhkan versi .NET Framework dari MSBuild untuk membangun dengan sukses. Selain itu, ada ketergantungan pada Visual Studio SDK karena sistem proyek .NET dibundel sebagai ekstensi studio visual untuk penyebaran ke Visual Studio.

Berikut adalah cara memperoleh komponen yang diperlukan:

• Instal Visual Studio terbaru
  • Pilih beban kerja ini selama instalasi:
    • .NET Desktop Build Tools
    • Pengembangan Ekstensi Studio Visual

Setelah komponen yang diperlukan diinstal, cukup jalankan file batch build.cmd di root repositori. Ini akan membangun, menguji, dan menggabungkan repositori dengan tepat.

bendera build.cmd

Semua argumen baris perintah yang disediakan untuk dibangun.cmd dapat diteruskan ke MSBuild. Ada beberapa properti khusus yang telah kami atur untuk membangun repo ini.

• Untuk proyek:
  • /p:SrcProjects=[true or false] : Termasuk proyek dalam direktori SRC . Default: true
  • /p:TestProjects=[true or false] : Termasuk proyek dalam direktori tes . Default: true
  • /p:SetupProjects=[true or false] : Termasuk proyek dalam direktori pengaturan . Default: true
• Untuk target:
  • /p:Restore=[true or false] : menjalankan target pemulihan untuk memperoleh dependensi proyek. Default: true
  • /p:Build=[true or false] : menjalankan target build untuk menyusun proyek menjadi majelis. Default: true
  • /p:Rebuild=[true or false] : Menjalankan target pembangunan kembali yang membersihkan dan membangun proyek. Default: false
  • /p:Test=[true or false] : Menjalankan target tes untuk mengeksekusi proyek uji xunit. Default: true
  • /p:Pack=[true or false] : Menjalankan target paket untuk menggabungkan proyek menjadi paket nuget. Default: true

Bagaimana cara saya terlibat dan berkontribusi?

Kami menyambut Anda untuk mencoba berbagai hal, mengajukan masalah, membuat permintaan fitur, dan bergabung dengan kami dalam percakapan desain. Jika Anda mencari sesuatu untuk dikerjakan, lihatlah masalah bantuan kami yang diinginkan untuk tempat yang tepat untuk memulai. Juga, periksa panduan berkontribusi kami.

Proyek ini telah mengadopsi kode etik yang diadaptasi dari Kontributor Perjanjian untuk mengklarifikasi perilaku yang diharapkan di komunitas kami. Kode perilaku ini telah diadopsi oleh banyak proyek lain. Untuk informasi lebih lanjut, lihat Kode Etik Kontributor.

Merek dagang

Proyek ini dapat berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan resmi merek dagang atau logo Microsoft tunduk dan harus mengikuti pedoman merek dagang & merek Microsoft. Penggunaan merek dagang atau logo Microsoft dalam versi yang dimodifikasi dari proyek ini tidak boleh menyebabkan kebingungan atau menyiratkan sponsor Microsoft. Setiap penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

Pengumpulan data

Perangkat lunak ini dapat mengumpulkan informasi tentang Anda dan penggunaan perangkat lunak Anda dan mengirimkannya ke Microsoft. Microsoft dapat menggunakan informasi ini untuk menyediakan layanan dan meningkatkan produk dan layanan kami. Anda dapat mematikan telemetri seperti yang dijelaskan dalam "Program Peningkatan Pengalaman Pelanggan Visual Studio". Ada juga beberapa fitur dalam perangkat lunak yang memungkinkan Anda dan Microsoft mengumpulkan data dari pengguna aplikasi Anda. Jika Anda menggunakan fitur -fitur ini, Anda harus mematuhi hukum yang berlaku, termasuk memberikan pemberitahuan yang tepat kepada pengguna aplikasi Anda bersama dengan salinan Pernyataan Privasi Microsoft. Pernyataan privasi kami terletak di https://go.microsoft.com/fwlink/?linkid=824704. Anda dapat mempelajari lebih lanjut tentang pengumpulan data dan penggunaan dalam dokumentasi bantuan dan pernyataan privasi kami. Penggunaan perangkat lunak Anda beroperasi sebagai persetujuan Anda untuk praktik -praktik ini.