Berbagi atau menggunakan kembali pengaturan proyek Visual Studio

Untuk membuat grup pengaturan kustom yang bisa Anda bagikan dengan orang lain atau menggunakan kembali di beberapa proyek, gunakan Pengelola Properti untuk membuat lembar properti ( .props file) untuk menyimpan pengaturan untuk setiap jenis proyek yang ingin Anda gunakan kembali atau bagikan dengan orang lain. Menggunakan lembar properti jauh lebih rentan terhadap kesalahan daripada cara lain untuk membuat pengaturan "global".

Penting

Masalah dengan *.user file

Versi Sebelumnya dari Visual Studio menggunakan lembar properti global yang memiliki .user ekstensi nama file dan terletak di \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\ folder . Kami tidak lagi merekomendasikan file-file ini karena mereka mengatur properti untuk konfigurasi proyek berdasarkan per pengguna, per komputer. Pengaturan "global" semacam itu dapat mengganggu build, terutama ketika Anda menargetkan lebih dari satu platform di komputer build Anda. Misalnya, jika Anda memiliki proyek MFC dan proyek Windows Telepon, .user properti akan tidak valid untuk salah satunya. Lembar properti yang dapat digunakan kembali lebih fleksibel dan lebih kuat.

Meskipun .user file masih diinstal oleh Visual Studio dan berpartisipasi dalam pewarisan properti, file tersebut kosong secara default. Praktik terbaiknya adalah menghapus referensi apa pun di Pengelola Properti untuk memastikan bahwa proyek Anda beroperasi secara independen dari pengaturan per pengguna per komputer. Praktik ini penting untuk memastikan perilaku yang benar di lingkungan SCC (kontrol kode sumber).

Untuk menampilkan Pengelola Properti, pada bilah menu, pilih Tampilkan>Pengelola Properti atau Tampilkan>Pengelola Properti Windows>Lainnya, bergantung pada pengaturan Anda.

Jika Anda ingin menerapkan sekumpulan properti umum yang sering digunakan ke beberapa proyek, Anda dapat menggunakan Pengelola Properti untuk menangkapnya dalam file lembar properti yang dapat digunakan kembali, yang menurut konvensi memiliki .props ekstensi nama file. Anda dapat menerapkan lembar (atau lembar) ke proyek baru sehingga Anda tidak perlu mengatur properti tersebut dari awal.

Di bawah setiap simpul konfigurasi, Anda akan melihat simpul untuk setiap lembar properti yang berlaku untuk konfigurasi tersebut. Sistem menambahkan lembar properti yang mengatur nilai umum berdasarkan opsi yang Anda pilih di wizard aplikasi saat Anda membuat proyek. Klik kanan simpul apa pun dan pilih Properti untuk melihat properti yang berlaku untuk simpul tersebut. Semua lembar properti diimpor secara otomatis ke lembar properti utama proyek (ms.cpp.props) dan dievaluasi dalam urutan lembar properti muncul di Manajer Properti. Anda dapat memindahkannya untuk mengubah urutan evaluasi. Lembar properti yang dievaluasi nanti mengesampingkan nilai dalam lembar yang dievaluasi sebelumnya. Untuk informasi selengkapnya tentang urutan evaluasi dalam .vcxproj file, .props file dan .targets , variabel lingkungan, dan baris perintah, lihat Pewarisan properti proyek.

Jika Anda memilih Tambahkan Lembar Properti Proyek Baru lalu pilih, misalnya, lembar properti MyProps.props, kotak dialog halaman properti muncul. Perhatikan bahwa itu berlaku untuk lembar properti MyProps; setiap perubahan yang Anda buat ditulis ke lembar, bukan ke file proyek (.vcxproj).

Properti dalam lembar properti ditimpa jika properti yang sama diatur langsung dalam .vcxproj file.

Anda dapat mengimpor lembar properti sesering yang diperlukan. Beberapa proyek dalam solusi dapat mewarisi pengaturan dari lembar properti yang sama, dan proyek dapat memiliki beberapa lembar. Lembar properti itu sendiri dapat mewarisi pengaturan dari lembar properti lain.

Anda juga dapat membuat lembar properti umum untuk beberapa konfigurasi. Untuk membuat lembar properti untuk setiap konfigurasi, buka menu pintasan untuk salah satunya, pilih Tambahkan Lembar Properti yang Ada, lalu tambahkan lembar lainnya. Namun, jika Anda menggunakan lembar properti umum, properti yang Anda tetapkan untuk semua konfigurasi yang diterapkan lembar. IDE tidak menunjukkan proyek mana atau lembar properti lain yang diwarisi dari lembar properti tertentu.

Dalam solusi besar yang memiliki banyak proyek, dapat berguna untuk membuat lembar properti umum untuk semua proyek dalam solusi. Buat lembar properti seperti biasa. Gunakan Pengelola Properti untuk menambahkan lembar properti tersebut ke setiap proyek dalam solusi. Jika perlu di tingkat proyek, Anda dapat menambahkan lembar properti lain untuk mengatur nilai khusus proyek.

Penting

File .props secara default tidak berpartisipasi dalam kontrol sumber karena tidak dibuat sebagai item proyek. Anda dapat menambahkan file secara manual sebagai item solusi jika Anda ingin menyertakannya dalam kontrol sumber.

Untuk membuat lembar properti

1. Pada bilah menu, pilih Tampilkan>Pengelola Properti atau Tampilkan>Pengelola Properti Windows>Lainnya. Manajer Properti terbuka.

2. Untuk menentukan cakupan lembar properti, pilih item yang diterapkannya. Item ini bisa berupa konfigurasi tertentu, atau lembar properti lain. Buka menu pintasan untuk item ini lalu pilih Tambahkan Lembar Properti Proyek Baru. Tentukan nama dan lokasi.

3. Di Pengelola Properti, buka lembar properti baru lalu atur properti yang ingin Anda sertakan.