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 bir GitHub gist’i şeklinde yayımlayın.

Note

Pano alanları etkin senaryoya ve teknoloji paketine bağlıdır. Bu makaledeki proje, hedef çerçeve, NuGet paketi ve uyumluluk görünümleri .NET sürüm yükseltmesini açıklar.

Masaüstü için GitHub Copilot uygulamasında, gösterge paneli bir 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. Gösterge paneli açılmazsa, Copilot’tan ilk isteminizde veya devam eden bir yükseltme oturumu sırasında bunu göstermesini isteyin.

Örnek komutlar:

• Yükseltme gösterge panelini 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 görevin genel ilerleme durumunu gösterir.

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.
• Geçerli ve hedef hedef çerçeve tanımlayıcıları (TFM'ler); örneğin net472 ve net10.0.
• Genel ilerleme.
• Tamamlanmış ve aktif 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 analiz ettiği çözümdeki ayrı paketler.
• Uyumsuz paketler: Hedef çerçeveyi desteklemeyen paketler.

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.

Görevler sekmesi

Görevler sekmesi, yükseltme planını ve geçerli senaryodaki her görevi gösterir. Özet kutuları, toplam, tamamlanan, devam eden ve başarısız olan görev sayılarını gösterir. İ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ı. Gösterge paneli görev etiketinin üstünü çizer.
• Döndürücü: Devam ediyor. Pano, görev etiketini kalın olarak görüntüler.
• Kare: Beklemede.

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: Proje türü; örneğin ClassicWinForms veya ClassicClassLibrary.
• Olaylar: Olay sayısı.

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

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.
• Proje referansları: <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.

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 olayları gruplandırır:

• Ö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 için ayrı ayrı dökümler sunulur.

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.

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, Bottom-Up (Dependency-First) gibi seçili stratejiyi 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. Gösterge paneli isteği ajana gönderir.

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

Etkinlik sekmesi

Etkinlik sekmesi aracı eylemlerinin zaman damgalı günlüğünü sağlar. Etkin bir oturum sırasında günlük kaydı gerçek zamanlı olarak güncellenir ve yeni olaylar en üstte görüntülenir. 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ı.

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 artefaktları olmayan bir depoda boş durum görüntülenir.
• 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.

İlgili içerik

• GitHub Copilot yükseltme nedir?
• .NET projelerini yükseltme
• JavaScript ve TypeScript projelerini yükseltme
• .NET senaryoları ve becerileri