버그 보고서를 언제 어떻게 제출해야 하나요?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.

에 대 한 자세한 지침은 Visual Studio 2017 또는 Visual Studio 2019 하 고 Mac 용 Visual Studio합니다.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.

또는OR

문제와 관련 된 경우에 따라 정확 하 게도 설명할 수 있습니다 하는 경우에 특히 문제의 표시 증상을 신중 하 게 설명할 수 있습니다. [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. 그렇다면 Xamarin의 일부가 아니라 가능성이 부분 Android 또는 iOS 자체 문제가입니다.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. 빌드 또는 Visual Studio에서 iOS 프로젝트를 디버깅 하는 경우 발생 하는 오류에 대 한 실행 하십시오 도움말 > Xamarin > Zip 로그 후 오류에 도달 하 고 버그 보고서에 있는 결과.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.iOS 및 Xamarin.Android 앱에 대 한 로그 디버그합니다.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. (IDE 및 빌드 프로세스는 일반적으로 복원 하거나 필요에 따라 이러한 폴더의 콘텐츠를 다시 만듭니다.) 또한 생성 되는 솔루션은 여전히 원래 문제를 보여주는으로 만큼 코드 및 리소스 파일 프로젝트에서 원하는 삭제할 수 있습니다.(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.