Halaman Build, Perancang Proyek (C#)

Artikel
03/02/2024

Gunakan halaman Build project Designer untuk menentukan properti konfigurasi build proyek. Halaman ini hanya berlaku untuk proyek Visual C#.

Untuk mengakses halaman Build, pilih simpul proyek (bukan node Solusi) di Penjelajah Solusi. Lalu pilih Tampilkan, Halaman Properti pada menu. Saat Perancang Proyek muncul, pilih tab Build .

Catatan

Komputer Anda mungkin menampilkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam artikel ini. Anda mungkin menggunakan edisi Visual Studio yang berbeda atau pengaturan lingkungan yang berbeda. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Konfigurasi dan Platform

Opsi berikut memungkinkan Anda memilih konfigurasi dan platform untuk ditampilkan atau dimodifikasi.

Catatan

Dengan konfigurasi build yang disederhanakan, sistem proyek menentukan apakah akan membuat versi debug atau rilis. Oleh karena itu, opsi ini tidak ditampilkan. Untuk informasi selengkapnya, lihat Cara: Mengatur konfigurasi debug dan rilis.

Konfigurasi

Menentukan pengaturan konfigurasi mana yang akan ditampilkan atau diubah. Pengaturannya bisa Aktif (Debug) (ini adalah default), Debug, Rilis, atau Semua Konfigurasi.

Platform

Menentukan pengaturan platform mana yang akan ditampilkan atau dimodifikasi. Pengaturan defaultnya adalah Aktif (CPU Apa pun). Anda dapat mengubah platform aktif menggunakan Configuration Manager. Untuk informasi selengkapnya, lihat Cara: Membuat dan Mengedit Konfigurasi.

Umum

Opsi berikut memungkinkan Anda mengonfigurasi beberapa pengaturan pengkompilasi C#.

Simbol kompilasi bersyarah

Menentukan simbol untuk melakukan kompilasi kondisional. Pisahkan simbol dengan titik koma (";"). Untuk informasi selengkapnya, lihat /define (C# Compiler Options).

Menentukan konstanta DEBUG

Menentukan DEBUG sebagai simbol di semua file kode sumber di aplikasi Anda. Memilih ini setara dengan menggunakan /define:DEBUG opsi baris perintah.

Tentukan konstanta PELACAKAN

Menentukan TRACE sebagai simbol di semua file kode sumber di aplikasi Anda. Memilih ini setara dengan menggunakan /define:TRACE opsi baris perintah.

Platform Target

Menentukan prosesor yang akan ditargetkan oleh file output. Pilih x86 untuk prosesor yang kompatibel dengan Intel 32-bit, pilih x64 untuk prosesor yang kompatibel dengan Intel 64-bit, pilih ARM untuk prosesor ARM, atau pilih CPU apa pun untuk menentukan bahwa prosesor apa pun dapat diterima. CPU apa pun adalah nilai default untuk proyek, karena memungkinkan aplikasi berjalan pada rentang perangkat keras terluas.

Untuk informasi selengkapnya, lihat -platform (Opsi Pengompilasi C#).

Dapat diubah ke null

Menentukan konteks nullable C# di seluruh proyek. Opsi UI ini diperkenalkan di Visual Studio 16.5, dan hanya diaktifkan untuk proyek yang menggunakan C# 8.0 atau yang lebih baru.

Untuk informasi selengkapnya, lihat Konteks Nullable.

Lebih suka 32-bit

Jika kotak centang Prefer32-bit dipilih, aplikasi berjalan sebagai aplikasi 32-bit pada Windows versi 32-bit dan 64-bit. Jika kotak centang dikosongkan, aplikasi berjalan sebagai aplikasi 32-bit pada Windows versi 32-bit dan sebagai aplikasi 64-bit pada Windows versi 64-bit.

Jika Anda menjalankan aplikasi sebagai aplikasi 64-bit, ukuran pointer ganda, dan masalah kompatibilitas dapat terjadi dengan pustaka lain yang secara eksklusif 32-bit. Hal ini berguna untuk menjalankan aplikasi 64-bit hanya jika membutuhkan lebih dari 4 GB memori atau instruksi 64-bit memberikan peningkatan performa yang signifikan.

Kotak centang ini hanya tersedia jika semua kondisi berikut ini benar:

Pada Halaman Build, daftar target Platform diatur ke CPU Apa Pun.
Pada Halaman Aplikasi, daftar Jenis output menentukan bahwa proyek adalah aplikasi.
Pada Halaman Aplikasi, daftar Kerangka kerja target menentukan .NET Framework 4.5.

Perbolehkan kode tidak aman

Memungkinkan kode yang menggunakan kata kunci yang tidak aman untuk dikompilasi. Untuk informasi selengkapnya, lihat /unsafe (C# Compiler Options).

Optimalkan kode

Aktifkan atau nonaktifkan pengoptimalan yang dilakukan oleh pengkompilasi untuk membuat file output Anda lebih kecil, lebih cepat, dan lebih efisien. Untuk informasi selengkapnya, lihat /optimize (C# Compiler Options).

Kesalahan dan peringatan

Pengaturan berikut digunakan untuk mengonfigurasi opsi kesalahan dan peringatan untuk proses build.

Tingkat peringatan

Menentukan tingkat yang akan ditampilkan untuk peringatan pengkompilasi. Untuk informasi selengkapnya, lihat -warn (opsi pengompilasi C#).

Menyembunyikan peringatan

Memblokir kemampuan kompilator untuk menghasilkan satu atau beberapa peringatan. Pisahkan beberapa angka peringatan dengan koma atau titik koma. Untuk informasi selengkapnya, lihat -nowarn (Opsi Pengompilasi C#).

Perlakukan Peringatan sebagai Kesalahan

Pengaturan berikut digunakan untuk menentukan peringatan mana yang diperlakukan sebagai kesalahan. Pilih salah satu opsi berikut untuk menunjukkan dalam kondisi apa untuk mengembalikan kesalahan saat build mengalami peringatan. Untuk informasi selengkapnya, lihat -warnaserror (opsi pengompilasi C#).

None - Tidak memperlakukan peringatan sebagai kesalahan.

Semua - Memperlakukan semua peringatan sebagai kesalahan.

Peringatan tertentu - Memperlakukan peringatan yang ditentukan sebagai kesalahan. Pisahkan beberapa angka peringatan dengan koma atau titik koma.

Tip

Jika Anda tidak ingin peringatan analisis kode diperlakukan sebagai kesalahan, lihat Tanya Jawab Umum analisis kode.

Output

Pengaturan berikut digunakan untuk mengonfigurasi opsi output untuk proses build.

Jalur output

Menentukan lokasi file output untuk konfigurasi proyek ini. Masukkan jalur output build dalam kotak ini, atau pilih tombol Telusuri untuk menentukan jalur. Jalurnya relatif; jika Anda memasukkan jalur absolut, jalur tersebut akan disimpan sebagai relatif. Jalur default adalah bin\Debug atau bin\Release\.

Dengan konfigurasi build yang disederhanakan, sistem proyek menentukan apakah akan membuat versi debug atau rilis. Perintah Build dari menu Debug (F5) akan menempatkan build di lokasi debug terlepas dari jalur Output yang Anda tentukan. Namun, perintah Build dari menu Build menempatkannya di lokasi yang Anda tentukan. Untuk informasi selengkapnya, lihat Memahami Konfigurasi Build.

File dokumentasi XML

Menentukan nama file tempat komentar dokumentasi akan diproses. Untuk informasi selengkapnya, lihat -doc (Opsi Pengompilasi C#).

Mendaftar untuk interop COM

Menunjukkan bahwa aplikasi terkelola Anda akan mengekspos objek COM (pembungkus yang dapat dipanggil COM) yang memungkinkan objek COM berinteraksi dengan aplikasi terkelola Anda. Properti Jenis output di halaman Aplikasi PerancangProyek untuk aplikasi ini harus diatur ke Pustaka Kelas agar properti Interop Daftar untuk COM tersedia. Untuk kelas contoh yang mungkin Anda sertakan dalam aplikasi Visual C# dan diekspos sebagai objek COM, lihat Contoh Kelas COM.

Hasilkan rakitan serialisasi

Menentukan apakah pengkompilasi akan menggunakan Alat Generator Serializer XML (Sgen.exe) untuk membuat rakitan serialisasi XML. Rakitan serialisasi dapat meningkatkan performa XmlSerializer startup jika Anda telah menggunakan kelas tersebut untuk menserialisasikan jenis dalam kode Anda. Secara default, opsi ini diatur ke Otomatis, yang menentukan bahwa rakitan serialisasi dihasilkan hanya jika Anda telah menggunakan XmlSerializer untuk mengodekan jenis dalam kode Anda ke XML. Off menentukan bahwa rakitan serialisasi tidak pernah dihasilkan, terlepas dari apakah kode Anda menggunakan XmlSerializer. Pada menentukan bahwa rakitan serialisasi selalu dihasilkan. Rakitan serialisasi diberi nama TypeName. XmlSerializers.dll. Untuk informasi selengkapnya, lihat Alat Generator Serializer XML (Sgen.exe).

Lanjutan

Klik untuk menampilkan kotak dialog Advanced Build Pengaturan Dialog Box (C#).

Share via