Yapı günlük dosyalarını görüntüle, kaydet ve yapılandır

Visual Studio Etkileşimli Geliştirme Ortamı'nda (IDE) bir proje derledikten sonra, Visual Studio Çıktı penceresinde derlemeyle ilgili günlüğe kaydedilen bilgileri görüntüleyebilirsiniz. Çıkış verileri, Visual Studio'da ve diğer düzenleyicilerde görüntüleyebileceğiniz günlük dosyalarına kaydedilebilir.

Kayıtlar derlemedeki sorunları gidermenize yardımcı olabilir. Tüm derleme araçları için kullanılan tam komut satırlarını bulabilir ve derleme işleminin tamamı hakkında tam tanılama verileri alabilirsiniz. Visual Studio, derleme çıktısı ve derleme günlük dosyalarında görmek istediğiniz bilgi türlerini belirtmek için seçenekler sağlar.

Bu makalede, Visual Studio'da derleme günlüğü dosyalarını oluşturma, yapılandırma ve görüntüleme işlemleri açıklanmaktadır.

Derleme günlük dosyalarını oluşturma ve görüntüleme

Senaryonuza yönelik derleme günlük dosyalarını oluşturmak ve görüntülemek için aşağıdaki yordamları kullanın.

• C++ projesi :

  Projenizi oluştururken Visual Studio günlük dosyalarını sizin için kaydeder. Günlük dosyalarının yaygın konumları arasında Release\<ProjectName>.log, Debug\<ProjectName>.logve <ProjectName>.txtbulunur. Tüm dosya konumları proje kök klasörünüzle ve kendi yapılandırmanıza göre değişir.

  1. Günlük dosyasına göz atmak için Windows Gezgini veya Dosya Gezgini kullanın.

  2. Günlük dosyasını tercih ettiğiniz düzenleyicide açın.

• .NET proje :

  .NET projeleri için Visual Studio'ya günlük dosyalarını kaydetmesini emredersiniz:

  1. Visual Studio'da Yapı>Yapı Çözümüseçeneğini seçin.

  2. Çıktı penceresinde, metni seçin ve Ctrl+S klavye kısayolunu kullanın.

  Visual Studio, derleme çıkışını kaydetmek için sizden bir konum ister. Daha sonra günlük dosyalarını bu konumdan Visual Studio'da veya başka bir düzenleyicide açabilirsiniz.

• MSBuild :

  -fileLogger (-fl) komut satırı seçeneğini kullanarak MSBuild'i doğrudan komut satırından çalıştırarak derleme günlükleri oluşturabilirsiniz. Daha fazla bilgi için bkz. MSBuildile derleme günlüklerini alma.

  MSBuild ile ikili günlükler de oluşturabilirsiniz (-binaryLogger veya -bl komut satırı seçeneği). İkili günlükleri Yapılandırılmış Günlük Görüntüleyicisigörüntüleyebilirsiniz. Yapılandırılmış günlük görüntüleyicisi, karmaşık derleme işlemlerinin anlaşılmasını kolaylaştırabilecek daha zengin bir kullanıcı arabirimi sağlar.

Visual Studio'yu dosya sistemine ikili günlük yazacak şekilde yapılandırmak için ortam değişkenlerini ayarlayabilirsiniz. MSBuildDebugEngine 1 olarak ayarlayın ve MSBUILDDEBUGPATH derleme günlük dosyasının istenen konumuna ayarlayın. Değişkenlerin Visual Studio'nun başlatıldığı ortamda ayarlanması gerekir. Bu ayarlar tüm Visual Studio derlemelerini etkiler, bu nedenle yalnızca derlemenin belirli bir çağrımı için günlükler istiyorsanız iyi bir seçenek olmayabilir.

.NET projelerinde derleme günlüğü için daha gelişmiş kullanıcı arabirimi desteği için Project System Tools uzantısınıyüklemeyi göz önünde bulundurun. Uzantı yüklendikten sonra kullanıcı arabiriminde ikili günlük kaydını açıp kapatabilir ve günlük listesinden seçim yapabilirsiniz. Visual Studio derleme sistemiyle entegrasyon şekli nedeniyle, günlükler Çıkış penceresinde veya ortam değişkenlerinden elde edeceğiniz günlüklerden biraz farklıdır.

Yapı günlükleri için veri ayrıntı düzeyini belirtme

Derleme günlük dosyalarına ne kadar bilgi ekleneceğini belirtebilirsiniz. Günlük dosyası sütunlarındaki veri miktarı, kayıt ayrıntısıolarak ölçülür. Günlük dosyası satırlarının sayısı, toplananiletileri gösterir. Günlük ayrıntı düzeyi (sütun değerleri), günlüğe kaydedilen ileti türlerini (satır değerleri) etkiler. Sessiz ayrıntı düzeyi, derleme çıkışında minimum günlük kaydı oluşturur. Tanılama en ayrıntılı ayardır ve tüm olası verilerle günlük dosyaları oluşturur.

Aşağıdaki tabloda günlükçü ayrıntı düzeyine göre hangi tür iletilerin toplandığı gösterilmektedir:

İleti türü / Ayrıntı	Sessiz	Minimal	Normal	Ayrıntılı	Tanılayıcı
Hata	✅	✅	✅	✅	✅
Uyarı	✅	✅	✅	✅	✅
Yüksek öneme sahip iletiler		✅	✅	✅	✅
Normal önem derecesinde iletiler			✅	✅	✅
Düşük önem taşıyan iletiler				✅	✅
Diğer MSBuild altyapısı bilgileri					✅

Günlükçü ayrıntı düzeyini aşağıdaki adımlarla yapılandırabilirsiniz:

1. Araçlar>Seçenekleri bölmesini açın ve Tüm Ayarlar>Projeleri ve Çözümleri>Derleme ve Çalıştırma bölümünü genişletin.

2. MSBuild proje derleme çıktısı ayrıntı düzeyi açılır listesini kullanın ve derleme çıktısı tercihinizi seçin.

3. MSBuild proje derleme günlük dosyası ayrıntı düzeyi açılır listesini kullanın ve günlük ayrıntı düzeyi tercihinizi seçin.

   Bahşiş

   Derleyici ve diğer araçlar için kullanılan komut satırlarını görmek istiyorsanız, en azından Ayrıntılı ayrıntı düzeyini seçin.

Önemli

Değişikliklerinizin Çıktı penceresinde geçerli olması için projeyi yeniden oluşturmanız gerekir. C++ projeleri için, proje yeniden derlemesi değişikliklerin <ProjectName>.txt dosyasına yansıtılmasını da sağlar.

Daha fazla bilgi için bkz. Seçenekler iletişim kutusu, Projeler ve Çözümler, Derleme ve Çalıştırma ve LoggerVerbosity.

Büyük günlük dosyaları için ikili günlükleri kullanın

İkili günlükler, büyük günlüklerde bilgi bulmayı kolaylaştırabilecek daha zengin bir günlük gözatma deneyimine sahip olmanıza olanak tanıyan isteğe bağlı bir .NET projeleri özelliğidir. İkili günlükleri kullanmak için Project System Tools 2022yükleyin. Daha fazla bilgi için bkz. https://msbuildlog.com ve İkili Günlük.

İlgili içerik

• Visual Studio'da proje ve çözüm oluşturma ve temizleme
• derleme ve inşa etme
• MSBuild ile derleme günlüklerini alma