Derleme günlüğü dosyalarını görüntüleme, kaydetme ve yapılandırma

Visual Studio Etkileşimli Geliştirme Ortamı'nda (IDE) bir proje derledikten sonra, Visual Studio Çıkış 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.

Günlükler 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 ortak konumları Arasında Release\<ProjectName>.log, Debug\<ProjectName>.log ve <ProjectName>.txt bulunur. 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'ni veya Dosya Gezgini kullanın.

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

• .NET projesi:

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

  1. Visual Studio'da Derleme Çözümü Oluştur'a>tıklayın.

  2. Çıkış 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:

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

  MSBuild ile ikili günlükler (-binaryLogger veya -bl komut satırı seçeneği) de oluşturabilirsiniz. İkili günlükleri Yapılandırılmış Günlük Görüntüleyicisi'nde gö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. olarak ayarlayın MSBuildDebugEngine ve derleme günlük dosyasının istenen konumuna ayarlayınMSBUILDDEBUGPATH.1 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ısı 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. Ancak, Visual Studio derleme sistemiyle tümleştirildiğinden, günlükler Çıkış penceresinden veya ortam değişkenlerinden biraz farklıdır.

Derleme 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ı günlükçü ayrıntısı olarak ölçülür. Günlük dosyası satırlarının sayısı toplanan iletileri 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ı	Quiet	Minimal	Normal	Ayrıntılı	Tanılama
Hatalar	✅	✅	✅	✅	✅
Uyarılar	✅	✅	✅	✅	✅
Yüksek öneme sahip iletiler		✅	✅	✅	✅
Normal önem derecesinde iletiler			✅	✅	✅
Düşük öneme neden olan iletiler				✅	✅
Diğer MSBuild altyapısı bilgileri					✅

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

1. Visual Studio'da Araçlar>Seçenekleri'ni seçerek Seçenekler iletişim kutusunu açın.

2. İletişim kutusunda Projeler ve Çözümler bölümünü genişletin ve Oluştur ve Çalıştır sekmesini seçin.

3. MSBuild projesi derleme çıkışı ayrıntı düzeyi açılan listesini kullanın ve derleme çıktısı tercihinizi seçin.

4. MSBuild projesi derleme günlük dosyası ayrıntı düzeyi açılan listesini kullanın ve günlükçü ayrıntı tercihinizi seçin.

   İpucu

   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.

5. Değişikliklerinizi uygulamak için Tamam'ı seçin.

Önemli

Değişikliklerinizin Çıkış 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 kullanma

İ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 2022'yi yü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 oluşturma
• MSBuild ile derleme günlüklerini alma