Yükseltme Panosu ile yükseltmeleri izleme

Yükseltme Panosu, GitHub Copilot yükseltme oturumunun görsel bir görünümünü sağlar. Kullanıcı arabirimi , Kod Yükseltme panelini etiketler. Kontrol panelini kullanarak:

  • Görev ilerleme durumunu ve hatalarını gerçek zamanlı olarak izleyin.
  • Değerlendirme sonuçlarını ve zorunlu sorunları gözden geçirin.
  • NuGet paketi uyumluluğunu inceleyin.
  • Yükseltme stratejisini ve ayarlarını denetleyin.
  • Değerlendirmeyi ekip incelemesi için özel GitHub olarak yayımlayın.

Masaüstü için GitHub Copilot uygulaması pano yan panel olarak açılır. GitHub Copilot CLI veya IDE gibi diğer ortamlarda tarayıcınızda açılır.

Panoyu açma

Yükseltme oturumu başlattığınızda Copilot panoyu otomatik olarak açabilir. Pano açılmazsa, Copilot ilk isteminizde veya etkin bir yükseltme oturumu sırasında göstermesini isteyin.

Örnek komutlar:

  • "Yükseltme panosunu göster."
  • "Çözümümü .NET 10'a yükseltin ve panoyu gösterin."

Pano, kullandığınız GitHub Copilot istemciye bağlı olarak yan panelde veya tarayıcıda açılır.

Pano keşfet

Yükseltmenin farklı bölümlerini incelemek için üst gezinti çubuğundaki sekiz sekmeyi kullanın. Üst bilgi, her sekmede genel görev ilerleme durumunu görüntüler.

Sekme Purpose
Genel bakış Yükseltme oturumunu özetler.
Senaryo Etkin senaryoyu ve aşamalarını gösterir.
Görevler Yükseltme planını ve tek tek görevleri izler.
Projeler Projeleri, hedef çerçeveleri ve değerlendirme olaylarını listeler.
Bağımlılıkları Paket ve başvuru uyumluluğunu raporlar.
Değerlendirme Kod tabanı değerlendirme sonuçlarını sunar.
Seçenekler Geçerli yükseltme stratejisini ve ayarlarını gösterir.
Etkinlik Dosya değişikliklerini, işlemelerini ve derleme olaylarını kaydeder.

Genel bakış sekmesi

Genel Bakış sekmesi varsayılan olarak açılır ve yükseltme oturumunu özetler. Senaryo kartı şunları gösterir:

  • Senaryo adı, örneğin dotnet-version-upgrade.
  • ve gibi net472net10.0geçerli ve hedef hedef çerçeve takma adları (TFM'ler).
  • Genel ilerleme.
  • Tamamlanmış ve etkin aşamalar.

Bir bakışta bölümünde şu istatistikler görüntülenir:

  • Tamamlanan görevler: Tamamlanan görevler, toplam görevler ve devam eden görevler.
  • Değerlendirilen projeler: Depoda bulunan proje dosyalarının sayısı.
  • Değerlendirme olayları: Tüm projelerde tek tek kural ihlalleri.
  • Zorunlu kurallar: Aracının yükseltmeyi tamamlayabilmesi için çözmesi gereken sorunlar.
  • NuGet paketleri: Aracının hedef çerçeveye göre çözümlediğini çözümde ayrı paketler.
  • Uyumsuz paketler: Hedef çerçeveyi desteklemeyen paketler.

Panoyu Yükseltmeye Genel Bakış sekmesinin ekran görüntüsü.

Senaryo sekmesi

Senaryo sekmesinde etkin senaryo ve depo için kullanılabilen tüm senaryolar listelenir. Bu görünümler arasında geçiş yapmak için Etkin ve Tüm senaryolar alt sekmelerini kullanın.

Etkin alt sekmesi, gibi DOTNET-VERSION-UPGRADEsenaryo kimliğini ve TFM geçişini (örneğin net472net10.0, ) gösterir. Ayrıca senaryonun amacını ve yaklaşımını da açıklar.

Aşama işlem hattı, her yükseltme aşamasının durumunu gösterir. Onay işareti tamamlanmış bir aşamayı, nokta ise geçerli aşamayı tanımlar.

PanoYu Yükseltme Senaryosu sekmesinin ekran görüntüsü.

Görevler sekmesi

Görevler sekmesi, yükseltme planını ve geçerli senaryodaki her görevi gösterir. Özet kutucukları toplam, tamamlandı, devam ediyor ve başarısız görev sayılarını rapor eder. İlerleme çubuğu tamamlanma yüzdesini bildirir ve senaryoyu tanımlar.

Genel Bakış bölümünde, proje sırası ve sırası da dahil olmak üzere yükseltme stratejisi açıklanır. Genel bakışın altında, numaralandırılmış, hiyerarşik bir liste görev durumunu tanımlamak için simgeler ve metin stilleri kullanır:

  • Onay işareti: Tamamlandı. Pano görev etiketinin üzerini çizer.
  • Döndürücü: Devam ediyor. Pano, görev etiketini kalın olarak görüntüler.
  • Kare: Beklemede.

Pano Görevlerini Yükselt sekmesinin ekran görüntüsü.

Projeler sekmesi

Projeler sekmesi, depodaki her .csproj bir dosyayı .fsproj değerlendirme verileriyle birlikte listeler. Özet kutucukları toplam projeleri, yükseltilen TFM'leri ve değerlendirme olaylarını bildirir.

Olay, değerlendirme kuralını tetikleyen bir kod konumunu temsil eder. Projeyle ilgili sorunları incelemek için bir olay sayısı seçin.

Görünümü değiştirmek için Tablo veya Graf'ı kullanın. Tablo şu sütunları içerir:

  • Project: project adı ve dosya yolu.
  • Çerçeve: Geçerli hedef çerçeve.
  • Tür: veya ClassicClassLibrarygibi ClassicWinForms proje türü.
  • Olaylar: Olay sayısı.

Grafik, projeleri düğüm olarak, proje başvurularını ise bağlantı olarak görüntüler.

Pano Projelerini Yükselt sekmesinin ekran görüntüsü.

Bağımlılıklar sekmesi

Bağımlılıklar sekmesi, çözümün NuGet paketlerinin ve başvurularının hedef çerçeveyi destekleyip desteklemediğini bildirir. Bağımlılık Analizi Hedefi kartı, hedef TFM'yi ve analiz edilen proje sayısını tanımlar.

Özet kutucukları şu bağımlılık türlerini ve koşullarını bildirir:

  • NuGet paketleri: Çözümde benzersiz NuGet paketleri.
  • Sürüm kayma: Projeler arasında farklı sürümler kullanan paketler.
  • Derleme başvuruları: Genel Derleme Önbelleği (GAC) derlemeleri veya ayrı DLL dosyaları gibi doğrudan başvurular.
  • Project başvuruları: <ProjectReference> projeler arasındaki ilişkiler.
  • Çerçeve başvuruları: <FrameworkReference> gibi Microsoft.AspNetCore.AppSDK stilindeki projelerdeki girdiler.

Uyumluluk çubuğu paketleri Geçerli, Kısmi, Uyumsuz veya Bilinmiyor olarak gruplandırmaktadır. Pano, çubuğun altındaki kaynak dependencies-health.json yolu görüntüler.

Paket tablosunda paket adları, projeler, yüklü sürümler, önerilen sürümler ve uyumluluk listelenir. Uyumsuz bir paket için, aracıdan sohbetteki ayrıntıları istemek için Açıkla'yı seçin.

Pano Bağımlılıklarını Yükselt sekmesinin ekran görüntüsü.

Değerlendirme sekmesi

Değerlendirme sekmesi, hedef çerçeveyle kod tabanı uyumluluğunu bildirir. Özet kutucuklar proje, sorun, olay, zorunlu sorun ve efor toplamlarını gösterir. Kategori kutucukları en büyük üç olay grubunu tanımlar.

İki çubuk grafik grup olayları:

  • Önem derecelerine göre: Olayları zorunlu, isteğe bağlı, olası veya bilgilendiren olarak gruplandırma.
  • Kategoriye göre: Olayları API, NuGet ve proje yapılandırması gibi alanlara göre gruplandırır.

Ayrıntı düzeyini değiştirmek için Özet, Sorunlar ve Özellikler alt sekmelerini kullanın. Özet , proje, paket ve API uyumluluğu hakkında bir anlatı raporu sağlar. Sorunlar ve Özellikler ayrı ayrı dökümler sağlar.

Değerlendirme tarihini ve sürümünü görüntülemek için Bilgi simgesini seçin. Değerlendirmeyi özel GitHub olarak yayımlamak için Paylaş simgesini seçin.

Pano Değerlendirmesini Yükselt sekmesinin ekran görüntüsü.

Seçenekler sekmesi

Seçenekler sekmesi geçerli yükseltme yapılandırmasını gösterir. Çoğu ayar salt okunur olsa da, sekme akış modunu değiştirmek için bir denetim sağlar. Desteklenen diğer tercihleri değiştirmek için sohbetteki aracıya sorun.

Sekme üç bölüm içerir:

  • Strateji , seçilen stratejiyi ( Bottom-Up (Dependency-First) gibi gösterir. Ayrıca, aracının çözüm için neden bu stratejiyi seçtiğini de açıklar.
  • Yürütme kısıtlamaları katman sırası, katmanlar arasında doğrulama ve diğer yürütme gereksinimleri gibi kuralları listeler.
  • Tercihler hedef çerçeveyi, akış modunu, işleme stratejisini ve hızı listeler.

Akış modu için Kılavuzluya Geç'i veya Otomatik'e Geç'i seçin. Pano isteği aracıya gönderir.

Hedef çerçeve bir platform son eki içerebilir. Örneğin, bir WPF uygulaması yerine net10.0hedeflenebilirnet10.0-windows.

Pano Seçeneklerini Yükselt sekmesinin ekran görüntüsü.

Etkinlik sekmesi

Etkinlik sekmesi aracı eylemlerinin zaman damgalı günlüğünü sağlar. Etkin bir oturum sırasında günlük gerçek zamanlı olarak güncelleştirilir ve yeni olayları en üste yerleştirir. Panelde ayrıca kaynak activity.jsonl yol da görüntülenir.

Etkinliği gözden geçirmek için Günlük, İşlemeler ve Dosyaya göre alt sekmelerini kullanın. Her günlük girdisi şunları içerir:

  • Zaman damgası: Olayın gerçekleştiği tarih ve saat.
  • Olay türü: Dosya değişikliği, işleme veya tamamlanmış derleme oturumu gibi eylem.
  • Ayrıntılar: İlişkili dosya yolu veya işleme iletisi.
  • Satır farkı: Dosya olayına eklenen veya kaldırılan satır sayısı.

PanoYu Yükseltme Etkinliği sekmesinin ekran görüntüsü.

Limitations

  • Panoya yalnızca masaüstü için GitHub Copilot uygulaması veya GitHub Copilot CLI üzerinden erişin.
  • Aracı sohbeti veya Seçenekler sekmesindeki denetimler aracılığıyla desteklenen tercihleri değiştirin. Pano diğer oturum ayarlarına doğrudan erişim sağlamaz.
  • Panonun verileri göstermesini beklemeden önce bir yükseltme oturumu başlatın. Yükseltme yapıtları olmayan bir depo boş bir durum görüntüler.
  • Etkinlik sekmesinde canlı güncelleştirmeler için aracıyı etkin tutun. Tamamlanan veya durdurulan oturum yalnızca geçmiş olayları görüntüler.