Kiedy i jak należy zgłosić raport o usterce?

Napiwek

Użyj elementu menu Zgłoś problem w programie Visual Studio — spowoduje to wysłanie informacji diagnostycznych wraz z raportem o błędach w celu rozwiązania problemu.

Szczegółowe instrukcje dotyczące programu Visual Studio 2019 lub Visual Studio 2017 i Visual Studio dla komputerów Mac.

Istniejące raporty można wyszukiwać w witrynie internetowej Visual Studio Developer Community .

Zgłoś usterkę, jeśli...

Masz zestaw kroków, które uważasz, że inżynierowie będą mogli odtworzyć problem.

LUB

Możesz dokładnie opisać widoczne objawy problemu, zwłaszcza jeśli możesz również opisać pewne dokładne okoliczności związane z problemem.^[1]

Najlepsze rozwiązania ułatwiające szybkie i wydajne rozwiązywanie problemów z błędami

1. Wyszukaj w społeczności deweloperów programu Visual Studio i w Internecie istniejące raporty o błędach lub sugestie użycia, które mogą bezpośrednio rozwiązać problem.^[2][3]

2. Opisz problem tak wyraźnie i zwięzłie, jak to możliwe, łącznie z opisem tego, co się stało i miało się zdarzyć.

3. Uwzględnij wszelkie odpowiednie ślady stosu, tekst komunikatu o błędzie lub dzienniki awarii (jeśli używasz funkcji Zgłoś problem , można je uwzględnić automatycznie). ^[4]

4. Zanotuj wszystkie ważne komunikaty o błędach, które są wyświetlane w załącznikach zrzutów ekranu jako zwykły tekst.

5. Dołącz mały, samodzielny przypadek testowy, który odtworzy usterkę z możliwie najmniejszym kodem. Jeśli nie możesz odtworzyć problemu z zupełnie nowym projektem (utworzonym przy użyciu jednego z wbudowanych szablonów), spakuj projekt, który demonstruje problem i dołącz go do raportu o błędach. Przed dołączeniem przykładowego projektu należy jak najprostszy.^[5][6]

6. Opisz środowisko, w którym wystąpił błąd, w tym system operacyjny i wersje platformy Xamarin oraz wszelkie zależności.

Dodatkowe szczegóły

1. ^ W idealnym przypadku opis "widocznych objawów" powinien zawierać wystarczającą ilość szczegółów, aby inni klienci mogli potwierdzić, czy widzą ten sam problem (te same komunikaty o błędach, takie same obniżenie wydajności, ślad stosu z awarii itp.). Dla "dokładnych okoliczności", jednym dobrym przykładem byłoby, gdyby można powiedzieć coś takiego: "Zwykle uderzyłem w problem 75% czasu, ale jeśli zmienię tę jedną rzecz, to mogę całkowicie uniknąć problemu." Innym podobnym przykładem "dokładnej okoliczności" jest to, czy obniżenie poziomu do poprzedniej wersji platformy Xamarin zatrzymuje problem.

2. ^ Jak można się spodziewać, fragmenty tekstu błędu (lub dowolny inny unikatowy tekst opisowy) są zwykle najlepszymi terminami wyszukiwania. Jeśli istniejący raport o usterce jest niekompletny, możesz dodać szczegóły lub zgłosić nowy, lepszy raport o błędach.

3. ^ Innym dobrym pytaniem jest to, czy ten sam problem został zgłoszony dla dowolnych aplikacji Java, Objective-C, lub Swift. Jeśli tak, problem jest bardzo prawdopodobną częścią samego systemu Android lub iOS, a nie częścią platformy Xamarin.

4. ^ Kilka przykładów informacji do uwzględnienia:

   1. W przypadku błędów występujących podczas kompilowania projektu dołącz pełne dane wyjściowe kompilacji diagnostycznej w raporcie o błędach.

   2. W przypadku błędów występujących podczas kompilowania lub debugowania projektu systemu iOS z programu Visual Studio uruchom polecenie Pomoc > W dziennikach zip platformy Xamarin > po osiągnięciu błędu i dołącz wynikowy plik .zip w raporcie o błędach.

   3. W przypadku wyjątków lub awarii w aplikacjach systemu Android lub iOS dołącz odpowiednie dzienniki debugowania dla aplikacji platform Xamarin.Android i Xamarin.iOS.

5. ^ Jeśli jest to możliwe w przypadku konkretnego problemu, jedną z opcji jest ponowne utworzenie problemu przez dodanie niewielkiej liczby plików z oryginalnego rozwiązania do zupełnie nowego rozwiązania. Zespół platformy Xamarin często będzie w stanie zbadać problemy nawet w przypadku większych przypadków testowych (przy założeniu, że kroki do odtworzenia są wyjaśnione wyraźnie), ale prostsze przypadki testowe dają największe szanse na szybkie rozwiązanie usterki.

6. ^Jeśli nie można odtworzyć problemu, dodając niewielką liczbę plików do zupełnie nowego rozwiązania, możesz spakować i dołączyć cały folder rozwiązania dla pełnej aplikacji. Usuń binfoldery , , i packages , objComponentsaby zmniejszyć plik zip. (Środowisko IDE i proces kompilacji zwykle przywracają lub odtwarzają zawartość tych folderów zgodnie z potrzebami). Możesz również usunąć dowolną liczbę plików kodu i zasobów z projektu, o ile wynikowe rozwiązanie nadal demonstruje oryginalny problem.