Ne zaman ve nasıl bir hata raporu bildirmeliyim?

İpucu

Visual Studio'da Sorun bildir menü öğesini kullanın; bu işlem, sorunu çözmeye yardımcı olmak için hata raporunuzla birlikte tanılama bilgileri gönderir.

Visual Studio 2019 veya Visual Studio 2017 ve Mac için Visual Studio için ayrıntılı yönergeler vardır.

Visual Studio Geliştirici Topluluğu web sitesinde mevcut raporları arayabilirsiniz.

Hata bildir...

Mühendislerin bir sorunu yeniden oluşturmak için kullanabileceğini düşündüğünüz bir dizi adımınız var.

VEYA

Özellikle sorunla ilgili bazı kesin durumları da açıklayabilirseniz, sorunun görünür belirtilerini dikkatlice açıklayabilirsiniz.^[1]

Hataları hızlı ve verimli bir şekilde gidermeye yardımcı olacak en iyi yöntemler

1. Sorunu doğrudan çözebilecek mevcut hata raporlarını veya kullanım önerilerini Visual Studio Geliştirici Topluluğu ve web'de arayın.[2]^[3]

2. Ne olduğu ve gerçekleşmesi beklenenlerin açıklaması da dahil olmak üzere sorunu olabildiğince net ve kısa bir şekilde açıklayın.

3. İlgili yığın izlemelerini, hata iletisi metinlerini veya kilitlenme günlüklerini ekleyin (Sorun bildir özelliğini kullanırsanız, bunlar otomatik olarak eklenebilir). ^[4]

4. Ekran görüntüsü eklerinde görünen önemli hata iletilerini de düz metin olarak yazın.

5. Hatayı mümkün olduğunca az kodla yeniden oluşturan küçük, bağımsız bir test çalışması ekleyin. Sorunu yeni bir projeyle yeniden oluşturamıyorsanız (yerleşik şablonlardan biri kullanılarak oluşturuldu), lütfen sorunu gösteren bir projeyi sıkıştırın ve hata raporuna ekleyin. Eklemeden önce örnek projeyi olabildiğince basit hale getirin.^[5][6]

6. Xamarin'in işletim sistemi ve sürümleri ve bağımlılıklar dahil olmak üzere hatayla karşılaşıldığı ortamı açıklayın.

Ek ayrıntılar

1. ^ İdeal olarak "görünür belirtiler" açıklaması, diğer müşterilerin aynı sorunu görüp görmediklerini (aynı hata iletileri, aynı performans düşüşü, kilitlenmeden aynı yığın izlemesi vb.) onaylayabilecek kadar ayrıntı içermelidir. "Kesin koşullar" için, şöyle bir şey söyleyebilirseniz iyi bir örnek olabilir: "Normalde soruna %75 oranında çarptım, ancak bunu değiştirirsem sorundan tamamen kaçınabilirim." Benzer bir "kesin durum" örneği de Xamarin'in önceki bir sürümüne düşürmenin sorunu durdurmasıdır.

2. ^ Beklediğiniz gibi, hata metninin (veya diğer benzersiz açıklayıcı metinlerin) kod parçacıkları genellikle en iyi arama terimleridir. Mevcut hata raporu tamamlanmamışsa ayrıntıları ekleyebilir veya yeni, daha iyi bir hata raporu açabilirsiniz.

3. ^ Bir diğer iyi soru da aynı sorunun herhangi bir Java, Objective-C, veya Swift uygulaması için bildirilip bildirilmemiş olmasıdır. Öyleyse, sorun büyük olasılıkla Xamarin'in bir parçası yerine Android veya iOS'un bir parçasıdır.

4. ^ Dahil etmek için birkaç bilgi örneği:

   1. Proje oluştururken oluşan hatalar için lütfen hata raporuna tam tanılama derleme çıkışını ekleyin.

   2. Visual Studio'dan bir iOS projesi oluştururken veya hata ayıklarken oluşan hatalar için lütfen hataya çarptıktan sonra Yardım > Xamarin > Zip Günlükleri'ni çalıştırın ve sonuçta elde edilen .zip dosyasını hata raporuna ekleyin.

   3. Android veya iOS uygulamalarında özel durumlar veya kilitlenmeler için lütfen Xamarin.Android ve Xamarin.iOS uygulamaları için ilgili Hata Ayıklama günlüklerini ekleyin.

5. ^ Belirli bir sorun için mümkünse, bir seçenek özgün çözümünüzden yeni bir çözüme az sayıda dosya ekleyerek sorunu yeniden oluşturmaktır. Xamarin ekibi genellikle daha büyük test çalışmalarında bile sorunları araştırabilecektir (yeniden oluşturma adımlarının açıkça açıklandığı varsayılarak), ancak daha basit test çalışmaları hatanın hızlı bir şekilde çözümlenmesi için en iyi şansı verir.

6. ^Yeni bir çözüme az sayıda dosya ekleyerek sorunu yeniden oluşturmak mümkün değilse, tam uygulamanız için çözüm klasörünün tamamını sıkıştırabilir ve ekleyebilirsiniz. Zip dosyasını küçültmek için lütfen , obj, Componentsve packages klasörlerini silinbin. (IDE ve derleme işlemi genellikle bu klasörlerin içeriğini gerektiği gibi geri yükler veya yeniden oluşturur.) Ayrıca, sonuçta elde edilen çözüm özgün sorunu göstermeye devam ettikçe projeden istediğiniz kadar kod ve kaynak dosyası silebilirsiniz.