Когда и как следует указывать отчет об ошибкеWhen and how should I file a bug report?

Совет

Используйте сообщить о проблеме пункта меню в Visual Studio – это будет отправлять диагностические сведения, а также отчет об ошибках для устранения проблемы.Use the Report a problem menu item in Visual Studio – this will send diagnostic information along with your bug report to help resolve the issue.

Подробные инструкции по использованию 2019 г. Visual Studio или Visual Studio 2017 и Visual Studio для Mac.There are detailed instructions for Visual Studio 2019 or Visual Studio 2017 and Visual Studio for Mac.

Можно выполнить поиск существующих отчетов на сообщества разработчиков Visual Studio веб-сайта.You can search for existing reports on the Visual Studio Developer Community website.

Зарегистрировать ошибку, если...File a bug if...

У вас есть набор шагов вы думаете, инженеры смогут использовать для воспроизведения проблемы.You have a set of steps you think the engineers will be able to use to reproduce a problem.

OROR

Внимательно, можно описать видимым симптомы проблемы, особенно в том случае, если можно также описать иногда точные, связанной с проблемой. [1]You can carefully describe the visible symptoms of the problem, especially if you can also describe some precise circumstances related to the problem.[1]

Рекомендации, руководствуясь адрес ошибки быстро и эффективноBest practices to help address bugs quickly and efficiently

  1. Поиск сообщества разработчиков Visual Studio и веб-для существующих ошибок отчеты или предложения по использованию, которые может решить проблему напрямую. [2][3]Search Visual Studio Developer Community and the web for existing bug reports or usage suggestions that might address the problem directly.[2][3]

  2. Опишите проблему как ясно и четко, как можно точнее, включая описание того, что произошло и должно было произойти.Describe the problem as clearly and concisely as possible, including a description of what happened and was expected to happen.

  3. Включить все трассировки стека, соответствующие, текст сообщения об ошибке или журналов сбоев (при использовании сообщить о проблеме компонентов, они могут быть включены автоматически).Include any relevant stack traces, error message text, or crash logs (if you use the Report a problem feature, these can be included automatically). [4][4]

  4. Запишите все важные сообщения об ошибке во вложениях экрана как обычный текст слишком.Write down any important error messages that appear in screenshot attachments as plain text too.

  5. Включать небольшой, автономный тестового случая, воспроизводящий ошибку с код как можно.Include a small, self-contained test case that reproduces the bug with as little code as possible. Если вы не сможете воспроизвести проблему с совершенно новым проектом (созданные с помощью одного из встроенных шаблонов), затем заархивируйте проекта, который демонстрирует проблему и присоединить ее к отчету об ошибках.If you cannot reproduce the problem with a brand new project (created using one of the built-in templates), then please zip up a project that demonstrates the problem and attach it to the bug report. Создайте пример проекта, как можно более простым перед присоединением его. [5][6]Make the example project as simple as possible before attaching it.[5][6]

  6. Описание среды, где была обнаружена ошибка, включая операционную систему и версии Xamarin и зависимые компоненты.Describe the environment where the bug was encountered, including the operating system and versions of Xamarin and any dependencies.

Дополнительные сведенияAdditional details

  1. ^ В идеале описание симптомов «видимой» должен включать достаточно подробностей, чтобы другие клиенты можно подтвердить ли они видят та же проблема (же сообщения об ошибках, же снижение производительности, же трассировку стека данные после сбоя, и т.д. ).^ Ideally the description of the "visible symptoms" should include enough details so that other customers can confirm whether they are seeing the same problem (same error messages, same performance degradation, same stack trace from a crash, etc.). «Точное обстоятельствах» хорошим примером может служить, если можно сказать, что-нибудь вроде: «Обычно я нажал проблема 75% времени, но если изменить этот одну вещь затем можно избежать проблемы полностью».For "precise circumstances", one good example would be if you can say something like: "I normally hit the problem 75% of the time, but if I change this one thing then I can avoid the problem completely." Другой аналогичный пример «точное состояние» — Если обратный переход к предыдущей версии Xamarin останавливает проблему.Another similar example of a "precise circumstance" is if downgrading to a previous version of Xamarin stops the problem.

  2. ^ Как и следовало ожидать, фрагменты текста ошибки (или любой другой уникальный описательный текст) — это обычно лучшие условия поиска.^ As you would expect, snippets of error text (or any other uniquely descriptive text) are usually the best search terms. Если существующий отчет об ошибке неполные, то можно также добавить данные или файл в новый, лучше отчет об ошибках.If the existing bug report is incomplete, then you are welcome to add details or file a new, better bug report.

  3. ^ Важно также понять того же проблема уже зарегистрирована для любого Java, Objective-C или Swift приложений.^ Another good question is whether the same problem has been reported for any Java, Objective-C, or Swift apps. Если Да, проблема является скорее частью Android или iOS, сам, а не частью Xamarin.If so, then the problem is very likely part of Android or iOS itself rather than part of Xamarin.

  4. ^ Несколько примеров данных для включения:^ A few examples of information to include:

    1. Для ошибок, возникающих при сборке проекта, укажите полный выходные данные диагностики сборки на отчет об ошибке.For errors that occur when building a project, please include the complete diagnostic build output on the bug report.

    2. Для ошибок, возникших при построении или отладке проекта iOS из Visual Studio, выполните команду Справка > Xamarin > запаковать журналы после превышения ошибки и включают полученный ZIP-файл в отчет об ошибках.For errors that occur when building or debugging an iOS project from Visual Studio, please run Help > Xamarin > Zip Logs after hitting the error and include the resulting .zip file on the bug report.

    3. Для исключения или сбои в приложениях Android или iOS, включите соответствующий отладочный журналы для приложений Xamarin.Android и Xamarin.iOS.For exceptions or crashes in Android or iOS apps, please include the relevant Debug logs for Xamarin.Android and Xamarin.iOS apps.

  5. ^ По возможности для решения конкретной проблемы, один из вариантов — это повторно создать проблему, добавив несколько файлов из исходного решения в совершенно новое решение.^ If possible for your particular problem, one option is to recreate the problem by adding a small number of files from your original solution into a brand new solution. Команда Xamarin часто будут иметь возможность изучения проблем даже на больших тестовых случаев (предполагается, что четко описаны шаги для воспроизведения), но проще тестовых случаев позволяют лучшие вероятность быстро устранить ошибку.The Xamarin team will often be able to investigate problems even on larger test cases (assuming the steps to reproduce are explained clearly), but simpler test cases give the best chance that the bug will be resolved quickly.

  6. ^ Если это не можно воспроизвести проблему, добавив небольшое количество файлов в совершенно новое решение, затем можно заархивировать и присоединить папке всего решения для полного приложения.^ If it is not possible to reproduce the problem by adding a small number of files to a brand new solution, then you can zip up and attach the whole solution folder for your full app. Удалите bin, obj, Components, и packages папки, чтобы файл меньше ZIP-файл.Please delete the bin, obj, Components, and packages folders to make the zip file smaller. (Интегрированной среды разработки и процесс сборки будет обычно восстановления или воссоздания содержимое этих папок при необходимости.) Можно также удалить кода и ресурсов любое число файлов из проекта вам нравится, до тех пор, пока полученное решение по-прежнему показывает исходной проблеме.(The IDE and the build process will usually restore or recreate the contents of these folders as needed.) You can also delete as many code and resource files from the project as you like, as long as the resulting solution still demonstrates the original problem.