Menampilkan, menyimpan, dan mengonfigurasi file log build

Setelah membuat proyek di Visual Studio Interactive Development Environment (IDE), Anda dapat melihat informasi yang dicatat tentang build di jendela Output visual Studio. Data output dapat disimpan ke file log yang dapat Anda lihat di Visual Studio dan editor lainnya.

Log dapat membantu Anda memecahkan masalah dalam proses build. Anda dapat menemukan baris perintah yang tepat yang digunakan untuk semua alat build, dan mendapatkan data diagnostik lengkap tentang seluruh proses build. Visual Studio menyediakan opsi untuk menentukan jenis informasi yang ingin Anda lihat di output build dan file log build.

Artikel ini menjelaskan cara membuat, mengonfigurasi, dan melihat file log build di Visual Studio.

Menghasilkan dan melihat file log build

Gunakan prosedur berikut untuk menghasilkan dan melihat file log build untuk skenario Anda.

• proyek C++:

  Visual Studio menyimpan file log untuk Anda saat membuat proyek. Lokasi umum untuk file log termasuk Release\<ProjectName>.log, Debug\<ProjectName>.log, dan <ProjectName>.txt. Semua lokasi file relatif terhadap folder akar proyek Anda dan berdasarkan konfigurasi spesifik Anda.

  1. Gunakan Windows Explorer atau File Explorer untuk menelusuri ke file log.

  2. Buka file log di editor pilihan Anda.

• proyek .NET:

  Untuk proyek .NET, Anda menginstruksikan Visual Studio untuk menyimpan file log:

  1. Di Visual Studio, pilih Build>Build Solution.

  2. Di jendela Output, pilih teks dan gunakan pintasan keyboard Ctrl+S.

  Visual Studio meminta lokasi untuk menyimpan output build. Anda kemudian dapat membuka file log dari lokasi tersebut di Visual Studio atau editor lain.

• MSBuild:

  Anda dapat membuat log build dengan menjalankan MSBuild langsung dari baris perintah dengan menggunakan opsi baris perintah -fileLogger (-fl). Untuk informasi selengkapnya, lihat Mendapat log build dengan MSBuild.

  Dengan MSBuild, Anda juga dapat menghasilkan log biner ( opsi baris perintah-binaryLogger atau -bl). Anda dapat melihat log biner di Penampil Log Terstruktur . Penampil log terstruktur menyediakan UI yang lebih kaya yang mungkin memudahkan untuk memahami proses build yang kompleks.

Anda dapat mengatur variabel lingkungan untuk mengonfigurasi Visual Studio untuk menulis log biner ke sistem file. Atur MSBuildDebugEngine ke 1 dan atur MSBUILDDEBUGPATH ke lokasi yang diinginkan dari file log build. Variabel harus diatur di lingkungan tempat Visual Studio diluncurkan. Pengaturan ini memengaruhi semua build Visual Studio, jadi mungkin bukan opsi yang baik jika Anda hanya ingin log untuk pemanggilan build tertentu.

Untuk dukungan UI yang lebih canggih untuk pembuatan log di proyek .NET, pertimbangkan untuk menginstal ekstensi Project System Tools. Dengan ekstensi yang diinstal, Anda dapat mengaktifkan dan menonaktifkan pengelogan biner di UI, dan memilih dari daftar log. Namun, karena cara integrasinya dengan sistem build Visual Studio, log sedikit berbeda dari yang akan Anda dapatkan dari jendela Output , atau dengan variabel lingkungan.

Tentukan verbositas data untuk log build

Anda dapat menentukan berapa banyak informasi yang akan disertakan dalam file log build. Jumlah data dalam kolom file log diukur sebagai verbositas pencatat . Jumlah baris file log mewakili pesan yang dikumpulkan. Verbositas log (nilai kolom) memengaruhi jenis pesan yang dicatat (nilai baris). Verbositas Tenang menghasilkan pencatatan minimal dalam output build. Diagnostik adalah pengaturan paling rinci dan menghasilkan file log dengan semua data yang tersedia.

Tabel berikut ini memperlihatkan jenis pesan apa yang dikumpulkan berdasarkan verbositas pencatat:

Jenis pesan / Verbosity	Tenang	Minimalis	Biasa	Mendetail	Diagnostik
Kesalahan	✅	✅	✅	✅	✅
Peringatan	✅	✅	✅	✅	✅
Pesan yang sangat penting		✅	✅	✅	✅
Pesan penting normal			✅	✅	✅
Pesan berpentingan rendah				✅	✅
Informasi mesin MSBuild lainnya					✅

Anda dapat mengonfigurasi verbositas pencatat dengan langkah-langkah berikut:

1. Buka panel Alat>Opsi, dan perluas bagian Semua Pengaturan>Proyek dan Solusi>Build dan Jalankan.

2. Gunakan MSBuild project build output verbosity daftar dropdown dan pilih preferensi output build Anda.

3. Gunakan daftar dropdown MSBuild project build kejelasan log file dan pilih preferensi kejelasan pencatat Anda.

   Tips

   Jika Anda ingin melihat baris perintah yang digunakan untuk pengkompilasi dan alat lainnya, pilih setidaknya tingkat verbositas terperinci.

Penting

Anda harus membangun kembali proyek agar perubahan Anda berlaku di jendela Output . Untuk proyek C++, pembangunan kembali proyek juga memastikan perubahan tercermin dalam file<.txt>ProjectName.

Untuk informasi selengkapnya, lihat kotak dialog Opsi , Proyek dan Solusi, Membangun dan Menjalankan dan LoggerVerbosity.

Menggunakan log biner untuk file log besar

Log biner adalah fitur opsional untuk proyek .NET yang memungkinkan Anda memiliki pengalaman penjelajahan log yang lebih kaya yang mungkin memudahkan untuk menemukan informasi dalam log besar. Untuk menggunakan log biner, instal Project System Tools 2022. Untuk informasi selengkapnya, lihat https://msbuildlog.com dan Log Biner.

Konten terkait

• Membangun dan membersihkan proyek dan solusi di Visual Studio
• Mengkompilasi dan membangun
• Mendapatkan log build dengan MSBuild